--- title: "Claude Code + OmniChannels.ai: crie e teste mensagens pelo terminal" description: "Adicione o servidor MCP da OmniChannels.ai ao Claude Code para testar envios e ler relatórios de entrega, e use a OpenAPI para codar WhatsApp e SMS." canonical: "https://omnichannels.ai/pt/integrations/claude-code/" language: "pt" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Claude Code + OmniChannels.ai: crie e teste mensagens pelo terminal Canonical: https://omnichannels.ai/pt/integrations/claude-code/ Language: pt Publisher: OmniChannels.ai by BroadNet Technologies **Em resumo:** O Claude Code se conecta à OmniChannels.ai com um único comando: claude mcp add --transport http apontando para https://mcp.broadnet.me/mcp com um cabeçalho Authorization: Bearer. Ele pode então enviar mensagens de teste, listar modelos do WhatsApp e ler relatórios de entrega enquanto escreve o código da sua integração a partir da nossa especificação OpenAPI 3.1. Equipes compartilham o servidor em .mcp.json, e regras de permissão controlam quais ferramentas rodam sem confirmação. Conexão via MCP · Conexão via API e webhooks ## O que você pode fazer ### Escrever código a partir dos modelos reais O Claude Code lê seus modelos aprovados do WhatsApp via MCP e escreve uma função com exatamente as variáveis de que cada um precisa. > Experimente pedir: "Use as ferramentas omnichannels para listar meus modelos de WhatsApp aprovados e depois escreva uma função em TypeScript que envie o order_update com os campos necessários." ### Criar um handler de webhook Indique o guia de webhooks ao Claude Code e ele escreve um endpoint que armazena status de entrega e mensagens recebidas, tolerando campos que variam por canal. > Experimente pedir: "Escreva um handler de webhook em Express que registre os status SUBMITTED, SENT, DELIVERED, READ, FAILED e REJECTED por ID de mensagem e registre em log campos desconhecidos em vez de falhar." ### Gerar um cliente tipado a partir da especificação Com a especificação OpenAPI salva no seu repositório, o Claude Code usa os caminhos e campos exatos em vez de adivinhá-los. > Experimente pedir: "Usando docs/omnichannels-openapi.yaml, escreva um módulo Python que envie um SMS com POST /sms/sendSms e liste cada campo usado com o tipo definido na especificação." ### Testar de ponta a ponta no seu número O Claude Code envia uma mensagem de teste depois que você aprova a chamada da ferramenta e confere o relatório de entrega para confirmar que o seu código funciona. > Experimente pedir: "Envie um SMS de teste de OmniDemo para o meu número 447700900123 e depois confira o relatório de entrega." ### Depurar envios com falha As ferramentas de leitura permitem que o Claude Code compare relatórios de entrega com os seus logs e rastreie uma falha até a requisição que a causou. > Experimente pedir: "Leia o relatório de entrega da campanha de ontem, resuma os motivos das falhas e confira o nosso código de retentativa com base no guia de erros." ## Como a conexão funciona O Claude Code adiciona servidores MCP remotos com claude mcp add --transport http e um cabeçalho Authorization. O seu shell expande o token a partir de uma variável de ambiente quando você executa o comando; para uma equipe, um .mcp.json no escopo do projeto permite que cada desenvolvedor informe o próprio token via ${BROADNET_TOKEN}, e o Claude Code pede que cada pessoa aprove o servidor antes de usá-lo. O MCP serve para agir na sua conta: enviar mensagens de teste, ler modelos e relatórios de entrega. Para escrever o código da integração, passe ao Claude Code a nossa especificação OpenAPI 3.1 como fonte de verdade para endpoints e campos, além do guia de webhooks, já que os payloads de webhook não estão na especificação. Regras de permissão como mcp__omnichannels__get_* deixam as ferramentas de leitura rodarem sem confirmação, enquanto as de envio continuam pedindo. - Comando: claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp - Configuração de equipe: versione o .mcp.json com Bearer ${BROADNET_TOKEN}, nunca com uma chave - As regras de permissão nomeiam as ferramentas como mcp__omnichannels__ - Especificação OpenAPI 3.1 em /developers/openapi.json com os campos exatos das requisições - SMS único usa JSON; envios em massa e a maioria dos outros canais usam multipart/form-data ## Configuração 1. **Solicite acesso à API:** Solicite acesso de teste e receba um token de API. Os envios de teste só vão para os seus próprios números verificados. 2. **Obtenha uma chave temporária:** No portal de administração, abra Integrations e depois MCP Integration, escolha Get temporary key e exporte-a como BROADNET_TOKEN. (Guia: https://omnichannels.ai/developers/mcp/) 3. **Adicione o servidor:** Execute claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp com o cabeçalho Authorization, ou versione um .mcp.json de projeto para a sua equipe, e verifique com /mcp. (Guia: https://omnichannels.ai/developers/mcp-claude-code/) 4. **Defina as regras de permissão:** Libere ferramentas de leitura como mcp__omnichannels__get_* se quiser, mantenha toda ferramenta de envio com confirmação e bloqueie as ferramentas de que o projeto não precisa. (Guia: https://omnichannels.ai/developers/mcp-claude-code/) 5. **Adicione a especificação OpenAPI:** Baixe o openapi.yaml para o seu repositório e peça ao Claude Code que o use para caminhos de endpoint, campos e enums. (Guia: https://omnichannels.ai/developers/openapi/) 6. **Teste no seu próprio número:** Peça ao Claude Code para enviar uma mensagem de teste ao seu número verificado e depois leia o relatório de entrega. ## Fluxo de exemplo Claude Code (Escreve a sua integração e chama ferramentas quando solicitado) → MCP e API OmniChannels.ai (Ferramentas MCP para testes; seu código chama a REST API) → Seu celular de teste (SMS ou WhatsApp de teste para o seu número verificado) → Seu handler de webhook (Recebe status de entrega e mensagens recebidas) ## Perguntas ### Existe um plugin oficial da OmniChannels.ai para o Claude Code? Não. O Claude Code se conecta pelo suporte padrão a servidores MCP remotos, usando o nosso endpoint público e o seu token de API, e lê a nossa especificação OpenAPI pública como qualquer outro arquivo do seu repositório. ### Como compartilho o servidor com a minha equipe sem compartilhar uma chave? Versione um .mcp.json no escopo do projeto cujo cabeçalho Authorization use ${BROADNET_TOKEN}. Cada desenvolvedor define essa variável no próprio shell, e o Claude Code pede que aprovem o servidor do projeto antes de usá-lo. ### O Claude Code pode enviar mensagens sem perguntar? Por padrão, o Claude Code pergunta antes de usar uma ferramenta MCP. Mantenha isso nas ferramentas de envio, já que cada envio é uma mensagem real e cobrada. Libere apenas ferramentas de leitura nas regras de permissão e confira antes os nomes das ferramentas em /mcp, porque eles dependem da versão do servidor e da sua conta. ### Devo usar MCP ou a REST API no meu produto? Use MCP para que o Claude Code teste e inspecione a sua conta durante o desenvolvimento. O código que vai para produção deve chamar a REST API diretamente, com um token do seu cofre de segredos, usando a especificação OpenAPI para os campos exatos. ## Guias para desenvolvedores - https://omnichannels.ai/developers/mcp-claude-code/ - https://omnichannels.ai/developers/openapi/ - https://omnichannels.ai/developers/webhooks/ - https://omnichannels.ai/developers/mcp/ ## Documentação do fornecedor - [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp) - [Claude Code permissions](https://code.claude.com/docs/en/permissions) ## Integrações relacionadas - https://omnichannels.ai/pt/integrations/claude/ - https://omnichannels.ai/pt/integrations/cursor/ - https://omnichannels.ai/pt/integrations/vs-code/ - https://omnichannels.ai/pt/integrations/langchain/ Claude Code é uma marca de seu proprietário. A OmniChannels.ai não é afiliada nem endossada por Claude Code; esta página descreve uma conexão feita com os recursos de MCP, HTTP ou webhook do próprio Claude Code. Atualizado em: 2026-10-10