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.
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__<tool>
- 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: MCP server for AI agents - 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: Use the MCP server with 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: Use the MCP server with 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: OpenAPI 3.1 spec - 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.
Documentação do fornecedor
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.
