AI导哈

API网关客户端

APIBrasil MCP Client是一个用于连接APIBrasil网关的客户端工具，支持AI客户端、IDE、聊天机器人和自动化工具的集成。

  • by APIBrasil
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 APIBrasil/apibrasil-mcp-client

使用说明

APIBrasil MCP Client

🌐 Idioma: Português · English

Base de conhecimento, configurações e guias para consumir o servidor MCP da APIBrasil em clientes de IA, IDEs, chatbots e ferramentas de automação.

Nota: A APIBrasil é um Gateway de APIs unificado para dados nacionais (CEP, CNPJ, Veículos, etc). Este repositório foca na integração dessas APIs via Protocolo MCP para Agentes de Inteligência Artificial.

Decisão Rápida (TL;DR)

Escolha o método de conexão baseado na natureza da sua plataforma:

Característica Protocolo MCP API REST
Protocolo Streamable HTTP (streaming) HTTP Standard
Estado Stateful (Sessão Persistente) Stateless (Request/Response)
Uso Ideal Cursor, Claude, Agentes de IA n8n, Typebot, Zapier, Webhooks
Vantagem Contexto contínuo para LLMs Simplicidade e compatibilidade universal

Endpoints

Utilize estes endereços para configurar seus clientes.

Serviço URL Status
MCP Server https://mcp.apibrasil.cloud/mcp
API Gateway https://gateway.apibrasil.io/api/v2
Docs doc.apibrasil.io

Comece por aqui

Selecione o seu caso de uso para ir direto à documentação específica:

Objetivo Diretório Descrição
Conectar IA clientes-ai/ Claude Desktop, LibreChat, Lovable
Configurar IDE ide-editores/ VS Code, Cursor, Zed, JetBrains
Criar Chatbot chatbots-ai/ Typebot, Flowise, LangFlow, Dify
Automação lowcode-automacao/ n8n, Make, Zapier, Bubble
Programar programacao/ Python, Node.js, Go, Java, C#
Entender o MCP conceitos/ Credenciais, descoberta, troubleshooting

Configurações Rápidas (Snippets)

Copie e cole as configurações abaixo diretamente no seu arquivo de preferência.

JSON Configs

CLI Bridge (Ponte Local)

Para conectar via terminal ou clientes que só aceitam comandos stdio, use a ponte oficial mcp-remote, que converte stdio ⇆ Streamable HTTP e injeta as credenciais por header:

npx -y mcp-remote https://mcp.apibrasil.cloud/mcp \
  --header "X-Apibrasil-Bearer:SEU_BEARER_TOKEN" \
  --header "DeviceToken:SEU_DEVICE_TOKEN"

Como passar credenciais em cada cliente (header, env ou argumento): veja conceitos/credenciais/.

Exemplo REST (PowerShell)

Para testes rápidos de conectividade sem depender do protocolo MCP:

$headers = @{
  Authorization = "Bearer SEU_BEARER_TOKEN"
  DeviceToken   = "SEU_DEVICE_TOKEN"
}

$body = @{ cep = "01001000" } | ConvertTo-Json

Invoke-RestMethod -Method Post `
  -Uri "https://gateway.apibrasil.io/api/v2/cep/cep" `
  -Headers $headers `
  -ContentType "application/json" `
  -Body $body

[!IMPORTANT] Segurança e Estado

  • Stateful: O MCP mantém uma sessão ativa (Mcp-Session-Id) via Streamable HTTP. Não tente usá-lo em ambientes que matam a conexão imediatamente (como Serverless Functions puras sem stream).
  • Tokens: Jamais comite seus tokens reais no repositório. Utilize variáveis de ambiente ou gerenciadores de segredos.

Mapa do Repositório

Esta seção é otimizada para indexação e navegação rápida.

Índice por categoria (auto-gerado)

📂 Estrutura de Pastas (Navegação) 
apibrasil-mcp-client
├── assets
├── chatbots-ai
│   ├── botpress
│   ├── dify
│   ├── flowise
│   ├── langflow
│   ├── openai_gpts
│   ├── stack_ai
│   └── voiceflow
├── clientes-ai
│   ├── 5ire
│   ├── aiaw
│   ├── chainlit
│   ├── chatmcp
│   ├── cherry_studio
│   ├── claude_desktop
│   ├── glue
│   ├── hyperchat
│   ├── langdock
│   ├── librechat
│   ├── lovable
│   ├── mindpal
│   ├── smithery
│   └── typingmind
├── conceitos
│   ├── credenciais
│   ├── descoberta
│   └── troubleshooting
├── ide-editores
│   ├── continue
│   ├── cursor
│   ├── emacs
│   ├── goose
│   ├── jetbrains
│   ├── pearai
│   ├── roo_code
│   ├── supermaven
│   ├── vscode
│   ├── windsurf
│   └── zed
├── lowcode-automacao
│   ├── activepieces
│   ├── bubble
│   ├── flutterflow
│   ├── google_sheets
│   ├── lasy_ai
│   ├── make
│   ├── n8n
│   ├── power_automate
│   ├── retool
│   └── zapier
├── plataformas-cloud
│   ├── aws
│   ├── azure
│   ├── cloudflare
│   ├── discord
│   ├── google_cloud
│   ├── salesforce
│   ├── slack
│   ├── supabase
│   ├── telegram
│   └── vercel
├── programacao
│   ├── go
│   ├── java
│   ├── nodejs
│   ├── php
│   ├── python
│   ├── ruby
│   ├── rust
│   ├── shell
│   ├── swift
│   └── vercel_ai_sdk
└── vibe-coder

Para atualizar o índice auto-gerado e a árvore depois de criar/remover pastas: python scripts/update_readme_tree.py.

Termos de Busca (Tags)

[!TIP] Utilize estes termos para localizar rapidamente configurações específicas dentro dos arquivos.

Contexto Termo de Busca
Endpoint MCP mcp.apibrasil.cloud/mcp
Ponte NPX mcp-remote
Config JSON mcpServers
Config Zed "mcp": { "servers": ... }
Gateway REST gateway.apibrasil.io/api/v2

Contribuindo

Quer adicionar uma nova ferramenta ou corrigir algo?

👉 Leia nosso Guia de Contribuição

Para manter o índice atualizado, lembre-se de rodar o script antes de commitar:

python scripts/update_readme_tree.py

相关 MCP