Isso conecta seu assistente à documentação do Bridge. Não o conecta ao workspace nem concede permissão para criar Contatos ou enviar mensagens. Sua integração usa as credenciais separadas da API REST ou a configuração pública de Custom Connections. O servidor de documentação também oferece uma ferramenta opcional de feedback, que envia comentários sobre a documentação ao Bridge.
Escolha seu assistente de programação
Codex
Configuração da CLI e da extensão local de IDE.
Claude Code
Um comando e, em seguida, a verificação da conexão.
Cursor
Adicione o servidor ao arquivo MCP do projeto.
GitHub Copilot
Configuração guiada no VS Code ou configuração portátil do projeto.
Codex
Antes de começar: tenha a CLI do Codex ou a extensão Codex para IDE instalada. Para a CLI, adicione o servidor no terminal:bridgeDocs com a URL da documentação do Bridge. A presença na lista confirma a configuração; use a verificação de conexão abaixo para confirmar que a ferramenta realmente consegue ler a documentação.
Se preferir editar a configuração, adicione esta entrada a ~/.codex/config.toml. Preserve as demais configurações e entradas de servidores:
/mcp mostra os servidores ativos. Clientes locais do Codex podem compartilhar a configuração no mesmo host; ambientes remotos podem ter configuração e políticas separadas.
Exemplo de prompt:
Use bridgeDocs para ler o contrato REST do Bridge e o guia da primeira conversa. Prepare uma integração Node.js que crie um Contato, inicie uma conversa e crie uma mensagem. Liste primeiro os identificadores e as configurações necessários. Mantenha todos os campos e tipos da API inalterados, cite as fontes e não faça requisições reais à API.Guia oficial de MCP do Codex.
Claude Code
Antes de começar: tenha o Claude Code instalado. Adicione o servidor à configuração pessoal para disponibilizá-lo em todos os projetos:--scope project em vez de --scope user. Revise a configuração resultante antes de adicioná-la ao repositório.
Inicie o Claude Code e use /mcp para inspecionar bridgeDocs. Depois, faça a verificação de conexão abaixo. O endpoint de documentação do Bridge não precisa de uma chave de API do Bridge nem de login OAuth.
Exemplo de prompt:
Use bridgeDocs para ler os guias atuais de verificação e recebimento de webhooks do Bridge. Implemente um receptor Python com a representação HMAC documentada e aceitação persistente antes da confirmação. Adicione testes offline usando o vetor de assinatura publicado. Explique a limitação do timestamp e o tratamento de duplicatas e cite as páginas usadas.Guia oficial de MCP do Claude Code.
Cursor
Antes de começar: abra seu projeto de integração no Cursor. Crie ou atualize.cursor/mcp.json nesse projeto. Mescle a entrada com os servidores já existentes:
~/.cursor/mcp.json. Na barra lateral Customize do Cursor, confira se o servidor está habilitado. Abra uma conversa com o Agent e faça a verificação de conexão abaixo; as ferramentas MCP disponíveis aparecem em Available Tools. Revise as solicitações de ferramentas quando o Cursor pedir.
Exemplo de prompt:
Use bridgeDocs para encontrar o fluxo completo de anexos em PDF. Implemente um upload no servidor que calcule o SHA-256 em Base64 dos bytes exatos do arquivo, solicite um upload pré-assinado, execute o PUT exigido e crie uma mensagem com o mediaId retornado. Preserve os campos documentados e explique o tratamento de falhas de cada etapa. Não envie uma chave de API do Bridge à URL de upload.Guia oficial de MCP do Cursor.
GitHub Copilot
Antes de começar: habilite o GitHub Copilot no VS Code e abra a pasta do projeto. Selecione Copilot como destino da sessão.- Abra a paleta de comandos com Command + Shift + P no macOS ou Ctrl + Shift + P no Windows/Linux.
- Execute MCP: Add Server e escolha HTTP (HTTP or Server-Sent Events).
- Informe
https://docs.bridge.new/mcpe dê ao servidor o nomebridgeDocs. - Escolha Global → Copilot Global para a configuração pessoal, quando disponível. Revise o destino mostrado pela sua versão do VS Code e qualquer solicitação de confiança no servidor.
- Abra uma conversa do Copilot, habilite as ferramentas de documentação do Bridge para a sessão e faça a verificação de conexão abaixo.
.mcp.json na raiz do workspace:
.vscode/mcp.json gerenciado pelo editor, que usa um objeto servers. Use o arquivo correspondente à conexão selecionada; não misture os dois formatos. Se o destino portátil não estiver disponível na sua versão, use a configuração guiada e o arquivo escolhido por ela.
Exemplo de prompt:
Use bridgeDocs para ler o guia de Custom Connections e seu contrato OpenAPI separado. Prepare um formulário de landing page que registre o consentimento, obtenha um novo token de CAPTCHA a cada tentativa e apresente uma resposta 202 como aceita com seu requestId. Mantenha captureKey, os campos da requisição e a ação de CAPTCHA configurada inalterados. Não use uma chave da API REST na página.Configuração oficial do VS Code · Referência de configuração do Copilot.
Verifique a conexão
Depois de configurar qualquer um dos quatro clientes, faça este pedido:Use o servidor MCP de documentação do Bridge para pesquisar a criação de uma mensagem. Leia o esquema MessageRequest no OpenAPI REST publicado. Quais são os três campos obrigatórios? Uma resposta 201 bem-sucedida comprova a entrega pelo WhatsApp? Cite a fonte exata do Bridge que você leu. Não chame a API de negócio.Uma verificação bem-sucedida usa uma ferramenta de documentação e cita uma página ou esquema do Bridge. Ela deve identificar
conversationId, messageBody e enableExternalBroadcast como obrigatórios e distinguir uma mensagem criada de um comprovante de entrega do provedor. Uma resposta plausível sem chamada de ferramenta ou fonte não é um teste de conexão.
Leia a documentação com qualquer IA, sem MCP
Não é necessário conectar o MCP para ler a documentação do Bridge. Forneça a um assistente que possa abrir URLs o índice trilíngue da documentação e escolha as fontes para sua tarefa e idioma:
O índice aponta para páginas
.md individuais e para os arquivos OpenAPI exatos. A coleção completa inclui os três idiomas; a coleção de um único idioma é menor. As descrições de endpoints reunidas não substituem os esquemas completos do OpenAPI.
Os arquivos por idioma usam JSON: o índice lista as URLs, e cada coleção contém o texto das páginas em Markdown no campo contentMarkdown. Os arquivos gerais llms.txt e llms-full.txt continuam em Markdown.
Exemplo de prompt:
Leia https://docs.bridge.new/llms.txt e selecione as fontes em português para enviar um PDF. Leia o guia completo de anexos e o OpenAPI REST vinculado antes de escrever código. Explique a sequência de upload, os campos obrigatórios e as limitações de entrega. Preserve as assinaturas publicadas da API e cite as URLs que você leu. Prepare apenas o código; não faça requisições reais.Se pesquisar pelo MCP, especifique
language: "pt-BR" para português, language: "es" para espanhol ou language: "en" para inglês. As páginas públicas usam .md; as leituras de páginas no filesystem MCP usam .mdx. Consulte também o guia de capacidades e fontes do Bridge.
Implemente com o contrato correto
O servidor oferece pesquisa na documentação, leitura completa de páginas e esquemas em um sistema de arquivos virtual de documentação e feedback opcional sobre a documentação. A ferramenta de sistema de arquivos não executa comandos no seu computador. O feedback é separado da pesquisa e da leitura: use-o somente quando quiser enviar um comentário sobre a documentação. Informe ao assistente a tarefa e o fluxo correspondente:- Primeira conversa: Contato → conversa → mensagem.
- Anexos: bytes do arquivo → checksum → PUT pré-assinado → mensagem.
- Templates: descubra as variáveis antes de enviar.
- Outbound de Agente: selecione um Agente e entenda
forceSend, reutilização e recuperação. - Receptor de webhook: verifique, persista, confirme e processe.
Se o servidor não aparecer
As interfaces dos clientes mudam com o tempo. As opções de configuração podem variar conforme a versão e a política da organização; use a documentação oficial vinculada se os menus forem diferentes. Instruções dos fornecedores verificadas pela última vez em 14 de novembro de 2026.

