Skip to main content

​
MCP Server

A Pierre Finance oferece um servidor MCP (Model Context Protocol) que permite conectar editores e ferramentas de IA diretamente aos seus dados financeiros.

​
O que é MCP?

O Model Context Protocol (MCP) é um protocolo padronizado que permite que editores e ferramentas de IA acessem dados externos de forma segura e padronizada. Isso significa que você pode acessar suas informações financeiras diretamente no seu editor preferido.

​
Endpoints Disponíveis

​
StreamableHTTP

https://pierre.finance/mcp

​
Autenticação

O servidor MCP requer autenticação. Você pode autenticar de duas formas:
  1. Header Authorization (recomendado)
Authorization: Bearer sk-your-api-key-here
  1. Parâmetro de URL apiKey
https://pierre.finance/mcp?apiKey=sk-your-api-key-here
Mantenha sua API key segura. A chave deve começar com “sk-” e nunca deve ser compartilhada publicamente.
Evite inserir esse endereço em navegadores/logs públicos.

​
Ferramentas Disponíveis

​
getAccounts

Obtém todas as contas financeiras do usuário (banco, cartão, investimentos, empréstimos). Parâmetros: Nenhum Retorna: Lista de contas com saldos, tipos e informações detalhadas

​
getBalance

Retorna o saldo consolidado de todas as contas bancárias. Parâmetros: Nenhum Retorna: Saldo total e detalhes de cada conta bancária

​
getBalanceByAccount

Obtém saldo e detalhes de uma conta bancária específica. Parâmetros:
  • accountId (obrigatório): ID da conta bancária
Retorna: Saldo e informações da conta especificada

​
getTransactions

Retorna transações financeiras com filtros opcionais. Suporta dois formatos de resposta. Parâmetros:
  • startDate (opcional): Data inicial (YYYY-MM-DD)
  • endDate (opcional): Data final (YYYY-MM-DD)
  • categories (opcional): Array de categorias
  • minAmount (opcional): Valor mínimo
  • maxAmount (opcional): Valor máximo
  • accountType (opcional): Tipo de conta
  • accountSubtype (opcional): Subtipo de conta
  • format (opcional): ‘raw’ (padrão) ou ‘structured’
Formatos:
  • raw: Dados brutos das transações
  • structured: Dados organizados com agrupamentos, resumos e análises

​
getInstallments

Retorna informações sobre compras parceladas e suas parcelas. Parâmetros:
  • startDate (opcional): Data inicial (YYYY-MM-DD)
  • endDate (opcional): Data final (YYYY-MM-DD)
Retorna: Estatísticas e detalhes de compras parceladas

​
getBillSummary

Obtém resumo da fatura atual do cartão de crédito (ainda não fechada). Parâmetros:
  • accountId (opcional): ID da conta de cartão específica
  • closingDay (opcional): Dia de fechamento manual (1-31)
Retorna: Limite total, disponível, período e valor aproximado da fatura

​
getBills

Retorna faturas de cartão de crédito já vencidas (fechadas com vencimento passado). Parâmetros:
  • accountId (opcional): ID da conta de cartão para filtrar
Retorna: Lista de faturas vencidas com valores e datas

​
manageClosingDate

Gerencia datas de fechamento de cartões de crédito (CRUD completo). Parâmetros: Variam por operação (LIST_ACCOUNTS, INSERT, UPDATE, DELETE, GET) Retorna: Configurações de data de fechamento

​
manualUpdate

Força uma sincronização manual dos dados financeiros. Parâmetros: Nenhum Uso: Execute imediatamente quando o usuário pedir para atualizar dados, sincronizar informações ou quando os dados parecerem desatualizados.

​
Vantagens do MCP

​
Para Desenvolvedores

  • Acesso direto: Dados financeiros disponíveis diretamente no editor
  • Análise em tempo real: Execute análises financeiras sem sair do seu ambiente de desenvolvimento
  • Automação: Integre dados financeiros em seus fluxos de trabalho

​
Para Analistas

  • Produtividade: Acesse dados sem alternar entre aplicações
  • Contexto rico: IA assistentes têm acesso completo aos dados financeiros
  • Análises avançadas: Execute análises complexas com o contexto completo

​
Casos de Uso

​
Análise de Gastos

"Analise meus gastos do último mês usando formato estruturado com breakdown por categoria"
"Use getTransactions com format=structured para criar um resumo dos meus gastos"

​
Controle de Cartão de Crédito

"Mostre o resumo da minha fatura atual e limite disponível"
"Liste minhas faturas vencidas e valores em aberto"
"Configure a data de fechamento do meu cartão para melhor controle"

​
Planejamento Financeiro

"Mostre meu saldo consolidado e sugira um plano de economia"
"Analise meus hábitos de consumo e identifique oportunidades de economia"

​
Análise de Parcelas

"Liste todas as minhas compras parceladas e quando terminam de pagar"
"Analise o impacto das parcelas no meu fluxo de caixa"

​
Relatórios e Dashboards

"Faça um relatório financeiro usando getTransactions com format=structured"
"Crie um dashboard com meus principais gastos usando formato estruturado"

​
Configuração Básica

​
Arquivo de 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"
      }
    }
  }
}

​
Editores Suportados

O servidor MCP é especialmente útil para análises financeiras avançadas e automação de tarefas financeiras.

​
Próximos Passos