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. Parâmetros: Nenhum Retorna: Lista de contas com saldos, tipos e informações detalhadas

getTransactions

Retorna transações financeiras com filtros opcionais. 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

getInstallments

Retorna informações sobre compras parceladas. Parâmetros:
  • startDate (opcional): Data inicial (YYYY-MM-DD)
  • endDate (opcional): Data final (YYYY-MM-DD)

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 e identifique categorias com maior despesa"

Planejamento Financeiro

"Mostre minhas contas e sugira um plano de economia baseado nos meus padrões de gasto"

Análise de Parcelas

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

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