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:
{
"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:
{
"env": {
"TOKEN": "Bearer sk-sua-api-key-aqui"
}
}
Nunca commite sua API key no controle de versão. Use variáveis de ambiente em produção.
3. Configurar Regras do Projeto
Crie um arquivo .windsurf/rules.md para configurar o comportamento do Windsurf:
# 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
Para maior segurança, use variáveis de ambiente:
{
"mcpServers": {
"Pierre Finance": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://pierre.finance/mcp",
"--header",
"Authorization:${TOKEN}"
],
"env": {
"TOKEN": "Bearer sk-your-api-key-here"
}
}
}
}
{
"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
{
"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:
- Verifique a API key: Certifique-se de que a chave está correta e ativa
- Teste a conectividade: Verifique se consegue acessar https://pierre.finance
- Reinicie o Windsurf: Às vezes é necessário reiniciar após mudanças na configuração
Erro de Autenticação
Se receber erros 401:
- Verifique a assinatura: Certifique-se de que sua assinatura está ativa
- Teste a API: Use cURL para testar a API diretamente
- Gere nova chave: Se necessário, gere uma nova API key
Ferramentas Não Aparecem
Se as ferramentas não aparecerem no Windsurf:
- Verifique a configuração: Certifique-se de que o arquivo
.windsurf/mcp.json está correto
- Reinicie o Windsurf: Feche e abra o Windsurf novamente
- 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"
"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"
O Windsurf com MCP permite análises financeiras avançadas e colaborativas, combinando dados financeiros com ferramentas de desenvolvimento em equipe.
Configuração de Equipe
Compartilhamento de Configuração
Para projetos em equipe, compartilhe a configuração MCP:
{
"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:
# 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
Mantenha suas API keys seguras e nunca as compartilhe publicamente.
