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

# Windsurf Integration

> Configure o Windsurf para acessar dados financeiros através do MCP

## Pré-requisitos

* Windsurf editor instalado
* API key da Pierre Finance
* Conta ativa na Pierre Finance

## Configuração

### Configuração Básica

Crie um arquivo `.windsurf/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. 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>

### 3. Configurar Regras do Projeto

Crie um arquivo `.windsurf/rules.md` para configurar o comportamento do Windsurf:

```markdown theme={null}
# Pierre Finance Integration Rules

## Contexto do Projeto
- Este projeto usa dados financeiros da Pierre Finance
- Acesse dados através do servidor MCP
- Mantenha informações financeiras seguras

## Padrões de Análise
- Sempre verifique dados antes de fazer recomendações
- Use dados históricos para projeções
- Considere contexto sazonal nos gastos
- Priorize segurança e privacidade

## Casos de Uso Comuns
- Análise de gastos e receitas
- Planejamento financeiro
- Análise de investimentos
- Relatórios personalizados
```

### 4. Reiniciar o Windsurf

Após criar os arquivos de configuração, reinicie o Windsurf 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:${TOKEN}"
      ],
      "env": {
        "TOKEN": "Bearer sk-your-api-key-here"
      }
    }
  }
}
```

### Configuração com 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:${TOKEN}"
      ],
      "env": {
        "TOKEN": "Bearer sk-your-api-key-here"
      }
    },
    "Outro Servidor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://outro-servidor.com/mcp"
      ]
    }
  }
}
```

### Configuração de Exemplo

```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 Específicos do Windsurf

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

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

## 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 Windsurf**: À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 Windsurf:

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

## Recursos Específicos do Windsurf

### Análise Colaborativa

O Windsurf permite análises colaborativas com dados financeiros:

```
"Com base nos dados financeiros da equipe, analise:
- Padrões de gasto coletivos
- Oportunidades de economia em grupo
- Estratégias de investimento compartilhadas"
```

### Integração com Ferramentas

O Windsurf pode integrar dados financeiros com outras ferramentas:

```
"Integre meus dados financeiros com:
- Ferramentas de contabilidade
- Aplicativos de planejamento
- Dashboards de análise"
```

### Automação de Relatórios

```
"Crie um sistema automatizado para:
- Relatórios financeiros semanais
- Alertas de gastos excessivos
- Análises de tendências mensais"
```

<Note>
  O Windsurf com MCP permite análises financeiras avançadas e colaborativas, combinando dados financeiros com ferramentas de desenvolvimento em equipe.
</Note>

## Configuração de Equipe

### Compartilhamento de Configuração

Para projetos em equipe, compartilhe a configuração MCP:

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

### Regras de Equipe

Crie regras compartilhadas para análise financeira:

```markdown theme={null}
# Regras de Análise Financeira - Equipe

## Padrões de Segurança
- Nunca compartilhe dados financeiros pessoais
- Use dados agregados para análises de equipe
- Mantenha API keys seguras

## Padrões de Análise
- Sempre verifique fontes de dados
- Use métricas padronizadas
- Documente suposições e limitações
```

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