​
Pré-requisitos

  • Conta no Pierre
  • API key válida
  • Conta bancária ou cartão de crédito conectado

​
Passo 1: Obter API Key

1

Obter API Key

Acesse https://pierre.finance/login e crie uma conta
2

Conecte sua conta

Clique em ”+ Conta” para conectar sua conta Pierre
3

Copie sua API Key

Acesse https://pierre.finance/api-key e copie sua API Key
4

Escolher Serviço

Decida entre usar as APIs REST ou o servidor MCP baseado no seu caso de uso
5

Configurar Editor

Siga os guias de integração para conectar seu editor preferido
6

Começar a Usar

Teste as APIs e comece a analisar seus dados financeiros

​
Passo 2: Testar a API REST

​
Teste Básico

curl -X GET 'https://pierre.finance/tools/api/get-accounts' \
  -H 'Authorization: Bearer sk-your-api-key-here'

​
Teste de Transações

curl -X GET 'https://pierre.finance/tools/api/get-transactions?startDate=2024-01-01&endDate=2024-01-31' \
  -H 'Authorization: Bearer sk-your-api-key-here'

​
Passo 3: Exemplos de Uso

​
REST API

​
JavaScript

const API_KEY = 'sk-your-api-key-here';
const BASE_URL = 'https://pierre.finance/tools/api';

async function getAccounts() {
  const response = await fetch(`${BASE_URL}/get-accounts`, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    }
  });
  
  return await response.json();
}

// Uso
getAccounts().then(data => {
  console.log('Contas:', data.data);
});

​
Python

import requests

API_KEY = 'sk-your-api-key-here'
BASE_URL = 'https://pierre.finance/tools/api'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json'
}

def get_accounts():
    response = requests.get(f'{BASE_URL}/get-accounts', headers=headers)
    return response.json()

# Uso
accounts = get_accounts()
print('Contas:', accounts['data'])

​
MCP Server

​
Para Cursor

Crie um arquivo .cursor/mcp.json:
{
  "mcpServers": {
    "Pierre Finance": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pierre.finance/mcp",
        "--header",
        "Authorization:${TOKEN}"
      ],
      "env": {
        "TOKEN": "Bearer sk-your-api-key-here"
      }
    }
  }
}
Crie um arquivo ~/.cursor/mcp.json:
{
  "mcpServers": {
    "Pierre Finance": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pierre.finance/mcp",
        "--header",
        "Authorization:${TOKEN}"
      ],
      "env": {
        "TOKEN": "Bearer sk-your-api-key-here"
      }
    }
  }
}
Após configurar o MCP, você pode usar comandos como: 
"Mostre minhas contas financeiras e saldos atuais"

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

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

​
Para Claude Code

Crie um arquivo ~/.cursor/mcp.json: 
{
  "mcpServers": {
    "Pierre Finance": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pierre.finance/mcp",
        "--header",
        "Authorization:${TOKEN}"
      ],
      "env": {
        "TOKEN": "Bearer sk-your-api-key-here"
      }
    }
  }
}

​
Com Claude Code

# Iniciar Claude Code
claude

# Fazer perguntas
"Analise meus dados financeiros e sugira um plano de economia"

​
Passo 5: Próximos Passos

REST API

Aprenda mais sobre as APIs REST e todos os endpoints disponíveis

MCP Server

Configure editores para acessar dados financeiros diretamente

Cursor Integration

Configure o Cursor para análise financeira avançada

Claude Code

Use o Claude Code CLI para análises financeiras

​
Troubleshooting

​
Erro 401 - Autenticação

​
Erro 401 - Sem Assinatura

​
MCP Não Conecta

  1. Verifique a configuração: Certifique-se de que o arquivo MCP está correto
  2. Reinicie sua conexão: Feche e abra a conexão e tente novamente
  3. Teste a conectividade: Verifique se consegue acessar https://pierre.finance
Para dados mais recentes, use o endpoint de sincronização manual quando necessário.