Pré-requisitos
- Claude Code CLI instalado
- API key da Pierre Finance
- Conta ativa na Pierre Finance
Instalação
1. Instalar Claude Code
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):
{
"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:
{
"env": {
"TOKEN": "Bearer sk-sua-api-key-aqui"
}
}
Usando o Claude Code
Iniciar o Claude Code
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:
export PIERRE_API_KEY="Bearer sk-your-api-key-here"
{
"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:
{
"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"
}
}
}
}
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
# Teste a conectividade
curl -X GET 'https://pierre.finance/tools/api/get-api-key-info'
Erro de Autenticação
# 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
# 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"
"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"
O Claude Code CLI é ideal para análises financeiras avançadas e automação de relatórios financeiros.
Exemplo de Script Python
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
#!/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
Mantenha suas API keys seguras e nunca as compartilhe publicamente.
