MCP: O Guia Definitivo do Model Context Protocol em Português

O Model Context Protocol (MCP) é o padrão aberto que conecta agentes de IA — como Claude, ChatGPT, Cursor, Codex e Antigravity — a ferramentas e dados externos. Este guia explica o que é MCP, como funciona e como usar o servidor MCP da Bipa para fazer Pix direto do seu agente.

O que é MCP (Model Context Protocol)?

O MCP é um protocolo aberto criado pela Anthropic em 2024 que define como agentes de IA descobrem, autenticam e chamam ferramentas externas. Antes do MCP, cada ferramenta precisava de uma integração sob medida para cada agente (Claude, ChatGPT, Cursor...). Com MCP, um único servidor expõe suas ferramentas e qualquer agente compatível consegue conectar.

Por que MCP importa pra você

Os principais agentes de IA — Claude, Claude Code, ChatGPT, Cursor, Codex, Antigravity, Gemini, Grok, Lovable, Replit — todos falam MCP. Isso significa que um servidor MCP brasileiro com Pix vira uma ferramenta universal para agentes de IA em qualquer lugar.

Como funciona o MCP da Bipa

O servidor MCP da Bipa expõe ferramentas de pagamento (Pix, saldo, histórico, cotações) via dois modos de transporte:

Modo Local (stdio)

Instale o CLI bipa e rode o servidor MCP localmente. Recomendado para uso pessoal, desktop e agentes rodando na sua máquina.

bash
curl -fsSL https://agents.bipa.app/install.sh | sh

Após instalar, execute bipa login --web --open para autenticar.

Modo Remoto (HTTP + OAuth)

Aponte seu cliente MCP para o servidor remoto. Sem instalação. Ideal para Claude.ai, ChatGPT e outros clientes remotos.

text
https://mcp.bipa.app/mcp

Ferramentas MCP expostas pela Bipa

Uma vez conectado, o agente ganha acesso a estas ferramentas (lista completa em Integrações):

  • Pagamentos Pix — enviar por chave, BR Code, tag Bipa, contato de confiança ou destinatário recente
  • Contatos e destinatários — agente busca quem pagar por nome, chave ou contatos recentes ("pague pro João")
  • Saldo e limites — quanto o agente pode gastar agora em BRL, BTC e USDT, antes de tentar pagar
  • Histórico — transações passadas pra dar contexto ("já paguei essa fatura?")
  • Cotações — preços BTC/BRL e USDT/BRL em tempo real e histórico

Guias de Integração MCP

Conecte o servidor MCP da Bipa ao seu agente favorito. Todos os guias são em português e inglês:

Perguntas frequentes sobre MCP

O que significa MCP?
MCP significa Model Context Protocol. É um padrão aberto criado pela Anthropic para conectar agentes de IA a ferramentas externas (APIs, bancos de dados, serviços).
Quais agentes suportam MCP?
Claude Desktop, Claude.ai, Claude Code, Cursor, Codex, Antigravity, ChatGPT (via Developer Mode), Gemini CLI, Grok, Replit Agent, Lovable, Windsurf, VS Code (com Copilot) e qualquer cliente que implemente o protocolo MCP.
É possível fazer Pix usando MCP?
Sim. A Bipa expõe Pix via MCP. Qualquer agente com suporte a MCP (Claude, ChatGPT, Cursor, etc.) pode chamar a ferramenta bipa_pix_pay_key para enviar um Pix — a aprovação final acontece no app Bipa do usuário.
O MCP da Bipa é seguro?
Sim. Autenticação via OAuth 2.1 com PKCE (remoto) ou token de sessão local criptografado. Todo pagamento Pix passa por aprovação explícita no app Bipa — o agente nunca envia dinheiro sem consentimento humano.
O MCP da Bipa é grátis?
Sim. O servidor MCP da Bipa é gratuito. Você paga apenas as taxas normais de Pix (geralmente zero) da sua conta Bipa.
Qual a diferença entre MCP local e remoto?
Local (stdio) roda na sua máquina via o CLI bipa — útil para agentes locais de computador (Claude Code, Cursor, Codex). Remoto (HTTP) é um endpoint público em mcp.bipa.app — sem instalação, ideal para Claude.ai e ChatGPT.