> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pierre.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server Introduction

> Introdução ao servidor MCP da Pierre Finance

# 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)

```bash theme={null}
Authorization: Bearer sk-your-api-key-here
```

2. Parâmetro de URL `apiKey`

```bash theme={null}
https://pierre.finance/mcp?apiKey=sk-your-api-key-here
```

<Warning>
  Mantenha sua API key segura. A chave deve começar com "sk-" e nunca deve ser compartilhada publicamente.
</Warning>

<Note>
  Evite inserir esse endereço em navegadores/logs públicos.
</Note>

## 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

```json theme={null}
{
  "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

* [Cursor](/editor-integration/cursor)
* [Claude Code](/editor-integration/claude-code)
* [Windsurf](/editor-integration/windsurf)
* [Outros Editores](/editor-integration/other-editors)

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

## Próximos Passos

* [Configurar Cursor](/editor-integration/cursor)
* [Configurar Claude Code](/editor-integration/claude-code)
* [Configurar Windsurf](/editor-integration/windsurf)
* [Ver outros editores](/editor-integration/other-editors)