Documentação

// Protocolo

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que aplicações de IA se conectem a ferramentas e dados externos de forma uniforme. Pense nele como uma porta-padrão para IA: em vez de cada assistente construir uma integração própria, um assistente que "fala MCP" pode se conectar a qualquer servidor MCP.

Para saber mais sobre o protocolo, consulte modelcontextprotocol.io.

// Visão geral

MCP Financeiro UPX

O MCP Financeiro UPX dá ao seu assistente de IA acesso seguro e somente leitura aos seus dados financeiros para que ele possa responder perguntas como "qual é meu saldo?", "quanto gastei no mês passado?", "quando vence minha fatura?" ou "como está meu portfólio?".

// Casos de uso

O que você pode construir

Use o MCP Financeiro UPX como camada de dados financeiros consentidos para agentes, copilotos e automações que precisam consultar contas reais com segurança.

Posicionamento para devs: infraestrutura para agentes financeiros sobre dados bancários reais, consentidos, regulados e somente leitura.

// Modelo de segurança

Auditável por design.

O MCP Financeiro UPX foi desenhado para que desenvolvedores possam verificar a superfície de acesso, não apenas confiar em uma promessa de marketing.

// Começando

Setup em menos de 5 minutos

Dois passos: configuração única no portal UPX e apontar seu host de IA para o endpoint.

1. Configuração inicial (portal UPX)

2. Endpoint

Aponte seu host MCP para o endpoint único da UPX:

https://mcp.upx.com

Observação de path: Alguns hosts esperam a URL base https://mcp.upx.com/ (ex.: ChatGPT). Outros esperam o path /mcp, https://mcp.upx.com/mcp (ex.: Claude, Cursor). Você sempre usa o mesmo host, não há subdomínios por produto.

Conectando hosts populares

Claude

Settings → Connectors → Add custom connector → cole a URL → Connect, depois conclua a janela de autorização.

https://mcp.upx.com/mcp

ChatGPT

Settings → Connectors → habilite modo MCP → Create/Add → cole a URL → Authentication: OAuth → confirme.

https://mcp.upx.com/

Cursor / outros hosts

Adicione um servidor MCP remoto apontando para o endpoint com seu bearer token.

https://mcp.upx.com/mcp

Seus primeiros prompts

• > Liste minhas conexões bancárias e diga quais precisam de atenção.
• > Quais são meus saldos de conta?
• > Quanto gastei no mês passado, por categoria?
• > Quando vence minha próxima fatura de cartão?

// Segurança

Autenticação & escopos

O acesso é governado por escopos OAuth de leitura. Um token concede apenas os escopos que você autorizou, e uma ferramenta só executa se seu token tiver o escopo necessário.

Escopos disponíveis

Set padrão recomendado para um assistente financeiro geral (cobre saldos, gastos e faturas sem acionar MFA extra):

finance:read:accounts finance:read:transactions finance:read:credit

// Referência

Ferramentas (10)

Comece com finance_connections_list para descobrir os connection_ids e passe um connection_id às demais ferramentas para limitar a leitura a uma única instituição. Omita para consultar todas as suas conexões.

// Convenções

Convenções de resposta

Todas as ferramentas compartilham um envelope de resposta e tipos comuns consistentes, documentados uma vez aqui.

O objeto Money

Todo valor monetário é um objeto, nunca um número solto:

{
  "amount":        2901.99,
  "currency_code": "BRL",
  "formatted":     "R$ 2,901.99"
}

• • amount, magnitude positiva. Direção via campo direction.
• • formatted, renderize isso, não recalcule.
• • null significa desconhecido. amount: 0 é zero real. Nunca some moedas diferentes.

Envelope padrão de resposta

Paginação

Ferramentas paginadas (finance_transactions_list, finance_investment-transactions_list) incluem um objeto pagination:

{
  "has_more":       true,
  "next_cursor":    "eyJ…",
  "page_size":      50,
  "returned_count": 50
}

Siga next_cursor até has_more: false. page_size padrão 50, máx. 500. Repasse um cursor com os mesmos filtros, mudar escopo no meio de uma sequência é rejeitado.

Ferramentas billable & uso

Em uma chamada billable bem-sucedida, a resposta inclui:

{
  "remaining":  42,
  "limit":      50,
  "period_end": "2026-06-01T00:00:00Z"
}

finance_connections_list e finance_suggestions_list são gratuitas e não consomem cota.

// Cache & dados

Freshness & caching

Como o runtime não armazena seus dados permanentemente, cada resposta informa o quão atualizados estão os dados via as_of e freshness_state.

Dados são armazenados em cache por no máximo 1 hora e atualizados em segundo plano. cache_age_seconds informa a idade do cache; next_refresh_hint_seconds sugere quando dados mais frescos são esperados.

// Tratamento de erros

Erros & limites

Quando uma chamada não pode ser atendida, a ferramenta retorna um envelope de erro estruturado, projetado para que um assistente possa explicar o problema e oferecer um próximo passo concreto.

Formato do envelope de erro

{
  "code":              "entitlement.denied.quota_exceeded",
  "message":           "You have reached your plan's usage limit.",
  "category":          "ENTITLEMENT_DENIED",
  "request_id":        "req_01HV…",
  "retry_after":       3600,
  "support_reference": "REQ-01HV-7Q3M-2X8N",
  "next_steps": [
    { "action": "wait_quota_reset", "period_end": "2026-06-01T00:00:00Z" },
    { "action": "upgrade_plan", "url": "https://…" }
  ]
}

Categorias de erro

// Catálogo

Catálogo de máquina

O runtime publica seu próprio catálogo. Trate esses como a fonte de verdade canônica, reconcilie esta página com eles quando as ferramentas mudarem.

Bom saber

// Recursos para devs

Comece pela superfície verificável.

Esta página combina documentação humana com recursos de máquina para que times de produto, segurança e engenharia possam revisar a integração.