Servidor MCP para integração com o Banco Inter (PJ). Consulte saldos e gerencie cobranças.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Um servidor MCP (Model Context Protocol) para integração com a API do Banco Inter Empresas (PJ).
Permite que assistentes de IA (como Claude, ChatGPT, Gemini, etc.) consultem saldos, extratos, emitam e gerenciem boletos de cobrança — tudo via linguagem natural.
CLIENT_ID e CLIENT_SECRET.crt) e Chave Privada (.key)1. Obtenha suas credenciais no Portal do Desenvolvedor do Banco Inter
2. Coloque os arquivos de certificado em um diretório seguro (ex.: ./certs/)
3. Crie um arquivo .env baseado no .env.example:
⚠️ Importante: Nunca comite os arquivos
.env,.crte.keyno repositório. Eles já estão no.gitignore.
O servidor suporta dois modos de transporte:
| Transporte | Uso | Ideal para |
|---|---|---|
stdio | Comunicação via stdin/stdout | Clientes locais (Claude Desktop, Cursor, etc.) |
streamable-http | Servidor HTTP com Streamable HTTP | Clientes remotos, Docker, múltiplos clientes |
npx — Modo stdio (recomendado para clientes locais)O modo padrão. O cliente MCP inicia o processo e se comunica via stdin/stdout:
💡 Na prática, você não roda manualmente — o cliente MCP (Claude Desktop, Cursor, etc.) executará o comando automaticamente. Veja os exemplos de configuração abaixo.
npx — Modo streamable-http (servidor HTTP)Para rodar como servidor HTTP acessível por múltiplos clientes:
O servidor estará disponível em:
streamable-httpO container Docker já vem configurado para rodar em modo streamable-http por padrão.
Build local:
Ou diretamente do Docker Hub:
O container expõe o endpoint Streamable HTTP em
http://localhost:3000/mcp.
Adicione ao seu claude_desktop_config.json:
Na configuração MCP do seu editor, adicione:
Para clientes que se conectam via HTTP (incluindo Docker), primeiro inicie o servidor em modo streamable-http (veja seções 2️⃣ ou 3️⃣ acima) e configure o cliente para conectar ao endpoint:
| Ferramenta | Descrição | Parâmetros |
|---|---|---|
consultar_saldo | Retorna o saldo disponível da conta. | — |
consultar_extrato | Retorna as movimentações em um período. | dataInicial, dataFinal |
baixar_pdf_extrato | Gera e salva o PDF do extrato. | dataInicial, dataFinal |
listar_boletos | Lista cobranças por período e situação. | dataInicial, dataFinal, situacao? |
emitir_boleto | Cria um novo boleto de cobrança. | seuNumero, valorNominal, dataVencimento, pagador |
baixar_pdf_boleto | Gera e salva o PDF de um boleto. | codigoSolicitacao |
cancelar_boleto | Cancela uma cobrança existente. | codigoSolicitacao, motivo |
sumario_boletos | Resumo quantitativo de cobranças por período. | dataInicial, dataFinal |
| Módulo | Responsabilidade |
|---|---|
index.ts | Carrega variáveis de ambiente, inicializa o InterClient e o InterMcpServer, e configura o transporte (stdio ou Streamable HTTP). |
server.ts | Registra as ferramentas MCP e delega chamadas ao InterClient. |
inter-client.ts | Autenticação OAuth2 com mTLS, cache de token, e todas as chamadas REST à API Inter (Banking v2 e Cobrança v3). |
types.ts | Tipagem completa de todas as interfaces usadas nas requisições e respostas da API. |
O projeto possui pipelines automatizados via GitHub Actions:
v*.amd64/arm64) no Docker Hub ao fazer push em master ou ao criar tags..env, certificados, chaves) estão incluídos no .gitignore.Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/mcp-banco-inter)<a href="https://allmcps.com/mcp/mcp-banco-inter"><img src="https://allmcps.com/api/badge/mcp-banco-inter?style=directory" alt="Mcp Banco Inter on AllMCPs" /></a>