> ## 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.

# Cursor Setup

> Configure Cursor para acessar dados financeiros através do servidor MCP

Cursor é um editor que permite conectar-se a servidores MCP para dar acesso aos seus dados financeiros diretamente no editor. Este guia mostra como configurar.

## Configuração

### 1. Arquivo de configuração local (recomendado)

Crie um arquivo `.cursor/mcp.json` na raiz do seu 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"
      }
    }
  }
}
```

### 2. Configuração global

Para usar em todos os projetos, crie `~/.cursor/mcp.json`:

```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. 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"
      }
    },
    "Outro Servidor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://outro-servidor.com/mcp"
      ]
    }
  }
}
```

### 2. 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"
  }
}
```

<Warning>
  Nunca commite sua API key no controle de versão. Use variáveis de ambiente em produção.
</Warning>

#### Enviar api key via URL

Para testes, também é possível passar a chave via URL:

```bash theme={null}
https://pierre.finance/mcp?apiKey=sk-sua-api-key-aqui
```

No `mcp-remote`, você pode simplesmente usar a URL com `apiKey` sem o header.

### 3. Reiniciar o Cursor

Após criar o arquivo de configuração, reinicie o Cursor para que as mudanças tenham efeito.

## Usando as Ferramentas

### Acessar Contas

```
"Mostre minhas contas financeiras e saldos atuais"
```

### Analisar Transações

```
"Analise minhas transações do último mês e identifique os maiores gastos"
```

### Verificar Parcelas

```
"Liste todas as minhas compras parceladas e quando terminam de pagar"
```

### Sincronizar Dados

```
"Atualize meus dados financeiros para ter as informações mais recentes"
```

## Exemplos de Uso

### Análise de Gastos

```
"Analise meus gastos dos últimos 3 meses e crie um relatório com:
1. Categorias com maior despesa
2. Padrões de gasto por dia da semana
3. Sugestões para economia"
```

### Planejamento Financeiro

```
"Com base nos meus dados financeiros, sugira um plano de economia considerando:
- Minhas receitas mensais
- Gastos fixos e variáveis
- Metas de economia
- Investimentos atuais"
```

## Configuração Avançada

### Configuração com Variáveis de Ambiente

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

```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"
      }
    }
  }
}
```

### Múltiplos Servidores

Você pode configurar múltiplos servidores MCP:

```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"
      }
    },
    "Outro Servidor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://outro-servidor.com/mcp"
      ]
    }
  }
}
```

## Troubleshooting

### Erro de Conexão

Se você receber erros de conexão:

1. **Verifique a API key**: Certifique-se de que a chave está correta e ativa
2. **Teste a conectividade**: Verifique se consegue acessar [https://pierre.finance](https://pierre.finance)
3. **Reinicie o Cursor**: Às vezes é necessário reiniciar após mudanças na configuração

### Erro de Autenticação

Se receber erros 401:

1. **Verifique a assinatura**: Certifique-se de que sua assinatura está ativa
2. **Teste a API**: Use cURL para testar a API diretamente
3. **Gere nova chave**: Se necessário, gere uma nova API key

### Ferramentas Não Aparecem

Se as ferramentas não aparecerem no Cursor:

1. **Verifique a configuração**: Certifique-se de que o arquivo `.cursor/mcp.json` está correto
2. **Reinicie o Cursor**: Feche e abra o Cursor novamente
3. **Verifique logs**: Olhe os logs do Cursor para erros de conexão

## Casos de Uso Avançados

### Análise de Portfólio

```
"Analise meu portfólio de investimentos e sugira:
1. Rebalanceamento baseado no risco
2. Novas oportunidades de investimento
3. Estratégias de diversificação"
```

### Relatórios Financeiros

```
"Crie um relatório financeiro mensal incluindo:
1. Resumo de receitas e despesas
2. Análise de fluxo de caixa
3. Metas e progresso
4. Recomendações para o próximo mês"
```

### 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 de uso
3. Oportunidades de economia"
```

<Note>
  O Cursor com MCP permite análises financeiras avançadas diretamente no editor, combinando dados financeiros com ferramentas de desenvolvimento.
</Note>