> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pierre.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code Integration

> Configure o Claude Code CLI para acessar dados financeiros através do MCP

## Pré-requisitos

* Claude Code CLI instalado
* API key da Pierre Finance
* Conta ativa na Pierre Finance

## Instalação

### 1. Instalar Claude Code

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

### 2. Configurar MCP

### Configuração Global

Crie um arquivo de configuração MCP em `~/.cursor/mcp.json` (global) ou `.cursor/mcp.json` (projeto):

```json theme={null}
{
  "mcpServers": {
    "Pierre Finance": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pierre.finance/mcp",
        "--header",
        "Authorization:${TOKEN}"
      ],
      "env": {
        "TOKEN": "Bearer sk-your-api-key-here"
      }
    }
  }
}
```

### 3. Substituir API Key

Substitua `sk-your-api-key-here` pela sua API key real:

```json theme={null}
{
  "env": {
    "TOKEN": "Bearer sk-sua-api-key-aqui"
  }
}
```

## Usando o Claude Code

### Iniciar o Claude Code

```bash theme={null}
claude
```

### Exemplos de Comandos

#### Análise de Contas

```
"Mostre minhas contas financeiras e analise a distribuição dos meus ativos"
```

#### Análise de Transações

```
"Analise minhas transações dos últimos 3 meses e identifique padrões de gasto"
```

#### Relatório Financeiro

```
"Crie um relatório financeiro completo incluindo:
- Resumo de receitas e despesas
- Análise de fluxo de caixa
- Metas e progresso
- Recomendações"
```

## Configuração Avançada

### Variáveis de Ambiente

Para maior segurança, use variáveis de ambiente:

```bash theme={null}
export PIERRE_API_KEY="Bearer sk-your-api-key-here"
```

E atualize a configuração:

```json theme={null}
{
  "mcpServers": {
    "Pierre Finance": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pierre.finance/mcp",
        "--header",
        "Authorization:${PIERRE_API_KEY}"
      ],
      "env": {
        "PIERRE_API_KEY": "Bearer sk-your-api-key-here"
      }
    }
  }
}
```

### Configuração por Projeto

Para configurações específicas de projeto, crie `.cursor/mcp.json` na raiz do projeto:

```json theme={null}
{
  "mcpServers": {
    "Pierre Finance": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pierre.finance/mcp",
        "--header",
        "Authorization:${TOKEN}"
      ],
      "env": {
        "TOKEN": "Bearer sk-your-api-key-here"
      }
    }
  }
}
```

### Configuração com Múltiplos Servidores

```json theme={null}
{
  "mcpServers": {
    "Pierre Finance": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pierre.finance/mcp",
        "--header",
        "Authorization:${TOKEN}"
      ],
      "env": {
        "TOKEN": "Bearer sk-your-api-key-here"
      }
    }
  }
}
```

## Casos de Uso

### Análise de Investimentos

```
"Analise meu portfólio de investimentos e sugira:
1. Estratégias de rebalanceamento
2. Novas oportunidades
3. Análise de risco"
```

### Planejamento Financeiro

```
"Com base nos meus dados, crie um plano financeiro incluindo:
- Orçamento mensal
- Metas de economia
- Estratégias de investimento
- Cronograma de pagamento de dívidas"
```

### Análise de Crédito

```
"Analise meu uso de cartão de crédito e sugira:
1. Estratégias para pagar dívidas
2. Melhores práticas
3. Oportunidades de economia"
```

### Relatórios Personalizados

```
"Crie um relatório personalizado com:
1. Análise de gastos por categoria
2. Comparação mensal
3. Projeções futuras
4. Alertas e recomendações"
```

## Troubleshooting

### Erro de Conexão

```bash theme={null}
# Teste a conectividade
curl -X GET 'https://pierre.finance/tools/api/get-api-key-info'
```

### Erro de Autenticação

```bash theme={null}
# Teste a API key
curl -X GET 'https://pierre.finance/tools/api/get-accounts' \
  -H 'Authorization: Bearer sk-your-api-key-here'
```

### Verificar Configuração

```bash theme={null}
# Verifique se o arquivo de configuração está correto
cat ~/.cursor/mcp.json
```

## Exemplos Avançados

### Análise de Fluxo de Caixa

```
"Analise meu fluxo de caixa dos últimos 6 meses e identifique:
- Padrões sazonais
- Picos de gasto
- Oportunidades de otimização
- Projeções para os próximos meses"
```

### Análise de Parcelas

```
"Liste todas as minhas compras parceladas e analise:
- Cronograma de pagamentos
- Impacto no fluxo de caixa
- Estratégias de antecipação
- Oportunidades de economia"
```

### Análise de Metas

```
"Com base nos meus dados financeiros, analise:
- Progresso das minhas metas
- Ajustes necessários
- Novas oportunidades
- Estratégias de aceleração"
```

### Análise de Risco

```
"Analise meu perfil de risco financeiro considerando:
- Diversificação de ativos
- Exposição a dívidas
- Liquidez disponível
- Recomendações de proteção"
```

<Note>
  O Claude Code CLI é ideal para análises financeiras avançadas e automação de relatórios financeiros.
</Note>

## Integração com Scripts

### Exemplo de Script Python

```python theme={null}
import subprocess
import json

def run_claude_analysis(prompt):
    """Executa análise financeira via Claude Code"""
    cmd = f'echo "{prompt}" | claude'
    result = subprocess.run(cmd, shell=True, capture_output=True, text=True)
    return result.stdout

# Exemplo de uso
analysis = run_claude_analysis("Analise minhas transações do último mês")
print(analysis)
```

### Exemplo de Script Bash

```bash theme={null}
#!/bin/bash

# Análise financeira via Claude Code
echo "Analise minhas contas e sugira um plano de economia" | claude > relatorio.txt

# Processar resultado
cat relatorio.txt
```

<Warning>
  Mantenha suas API keys seguras e nunca as compartilhe publicamente.
</Warning>