# Conecte agentes de IA à BroadNet com MCP. - URL canónico: https://www.broadnet.me/pt/developers/mcp - Idioma: pt - Última atualização: 2026-10-21 - Editor: BroadNet (https://www.broadnet.me) - Versão Markdown da página, gerada a partir da página publicada. Model Context Protocol· /developers/mcp O servidor MCP da BroadNet expõe a API de mensagens da BroadNet como ferramentas que um agente de IA pode chamar. Aponte qualquer cliente MCP compatível com servidores remotos para um único endpoint, autentique-se com o seu token BroadNet e o agente poderá enviar e acompanhar mensagens na sua conta. **Endpoint** https://mcp.broadnet.me/mcp **Transporte** MCP Streamable HTTP **Autenticação** Authorization: Bearer **Canais** WhatsApp, SMS, RCS, Telegram, Push, e-mail, Messenger, Instagram ## O que é o servidor MCP O Model Context Protocol (MCP) é um padrão aberto que permite a assistentes de IA descobrir e chamar ferramentas externas. O servidor MCP da BroadNet é um servidor remoto: o seu cliente conecta-se por HTTPS, lista as ferramentas disponíveis e chama-as em seu nome. As ferramentas correspondem à mesma API da BroadNet documentada na referência da API e na especificação OpenAPI — envio de mensagens, modelos do WhatsApp, relatórios de entrega. O agente age com as permissões do token que você lhe fornece, exatamente como o seu próprio código. ## Dois servidores MCP: conhecimento e mensagens A BroadNet opera dois servidores MCP. O servidor de mensagens descrito nesta página atua na sua conta. O servidor de conhecimento é público: um agente pode consultá-lo sobre a cobertura da BroadNet, as regras de Sender ID, as tarifas de tabela publicadas, a regulamentação e os dados da empresa sem login. Servidor de conhecimento (público) Respostas somente leitura a partir dos mesmos dados deste site. Sem conta, sem token e sem dados pessoais. **Endpoint** https://www.broadnet.me/mcp **Autenticação** Nenhuma **Acesso** Somente leitura **Ferramentas** search_site, get_facts, check_coverage, sender_id_rules, estimate_price, count_sms_segments, get_regulation, list_answers, get_answer, list_case_studies, get_case_study, get_changelog, get_status **Limite de requisições** 60 requisições por minuto por IP Servidor de mensagens (a sua conta) Envia e acompanha mensagens com as permissões do seu token BroadNet. **Endpoint** https://mcp.broadnet.me/mcp **Autenticação** Authorization: Bearer **Acesso** Atua na sua conta Teste o servidor de conhecimento no terminal: o handshake initialize e, em seguida, uma chamada de ferramenta. initialize (servidor de conhecimento) ``` curl -X POST https://www.broadnet.me/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize", "params":{"protocolVersion":"2025-06-18","capabilities":{}, "clientInfo":{"name":"curl","version":"1.0"}}}' ``` tools/call (servidor de conhecimento) ``` curl -X POST https://www.broadnet.me/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "MCP-Protocol-Version: 2025-06-18" \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call", "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}' ``` O servidor de conhecimento suporta o MCP 2026-07-28 (metadados por requisição, server/discover) e as revisões anteriores baseadas em initialize até 2024-11-05. Os preços devolvidos são tarifas de tabela indicativas, não cotações; as respostas regulatórias são orientação de planeamento, não aconselhamento jurídico. ## Endpoint e autenticação Há um único endpoint para todas as contas: https://mcp.broadnet.me/mcp. Cada solicitação deve levar o seu token BroadNet num cabeçalho Authorization. O token é obtido na sua conta BroadNet. Na demonstração, ele é gerado no portal BroadAdmin, em Integrations → MCP Integration, com “Get temporary key”; o portal indica que uma chave permanente é emitida pelo administrador da sua conta ou pela conta principal. Uma solicitação sem o cabeçalho é recusada no nível do protocolo — esta é a resposta real do servidor a uma chamada initialize sem autenticação: resposta sem token ``` event: message data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001, "message":"Authorization bearer token is required. Connect with an 'Authorization: Bearer ' header."}} ``` ## Conectar um cliente MCP A maioria dos clientes MCP aceita uma configuração JSON com a URL do servidor e os cabeçalhos da solicitação. Uma entrada típica é assim: mcp.json ``` { "mcpServers": { "broadnet": { "type": "http", "url": "https://mcp.broadnet.me/mcp", "headers": { "Authorization": "Bearer ${BROADNET_TOKEN}" } } } } ``` Os nomes dos campos variam um pouco entre clientes (alguns esperam um type "http" ou "streamable-http", outros leem os cabeçalhos de uma configuração separada). Consulte a documentação MCP do seu cliente e mantenha o token fora de ficheiros versionados — use variáveis de ambiente quando o cliente oferecer suporte. Para testar a conexão sem um cliente, envie você mesmo a solicitação MCP initialize: handshake initialize ``` curl -X POST https://mcp.broadnet.me/mcp \ -H "Authorization: Bearer $BROADNET_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize", "params":{"protocolVersion":"2025-06-18","capabilities":{}, "clientInfo":{"name":"curl","version":"1.0"}}}' ``` ## O que a demonstração mostra A gravação da equipa de produto percorre o fluxo completo em cinco etapas, usando o Cursor como cliente MCP: 1. 1 Entrar Inicie sessão no portal BroadAdmin com a sua conta BroadNet. 2. 2 Obter uma chave e a configuração Abra Integrations → MCP Integration, gere uma chave temporária e copie a configuração de cliente já pronta. 3. 3 Adicionar o servidor ao cliente No cliente MCP, adicione um novo servidor MCP e cole a configuração em mcp.json — URL https://mcp.broadnet.me/mcp com o cabeçalho Bearer. 4. 4 Revisar as ferramentas O cliente conecta-se e lista as ferramentas da BroadNet; cada uma pode ser ativada ou desativada. 5. 5 Pedir em linguagem natural O utilizador pede ao agente que envie uma mensagem de WhatsApp para um número. O agente escolhe a ferramenta de envio do WhatsApp, a API responde HTTP 200 com a mensagem aceita e a mensagem chega ao WhatsApp a partir da conta comercial. Na gravação, o cliente apresenta 380 ferramentas da BroadNet, entre elas send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send, post_telegram_message_send, post_instagram_message_send, post_messenger_message_send, post_push_message_send e get_report_delivery. A lista exata depende da versão do servidor e da sua conta. Uma versão narrada da mesma gravação acrescenta um cartão de visão geral: um único endpoint MCP e os mesmos passos de copiar e colar para cada agente. Gravação de demonstração (1 min 10 s, sem som): inicie sessão no BroadAdmin, conecte o Cursor ao servidor BroadNet MCP e envie uma mensagem WhatsApp em linguagem natural. Versão narrada (1 min 20 s, com locução) do mesmo fluxo, com um cartão de visão geral no início. ## Notas de segurança - O token é uma credencial de envio Quem o tiver pode enviar mensagens pela sua conta. Guarde-o como uma palavra-passe, nunca num ficheiro partilhado ou versionado. - Prefira chaves temporárias para testes Use uma chave temporária enquanto testa e peça uma chave permanente ao administrador da sua conta apenas para um agente em produção. - Ative só as ferramentas necessárias Os clientes MCP permitem desativar ferramentas individualmente. Um agente que só envia SMS não precisa de ferramentas de modelos, onboarding ou conta. - Mantenha uma pessoa no processo Os agentes agem com base em instruções em linguagem natural. Faça o cliente pedir confirmação antes das ferramentas que enviam mensagens, sobretudo para muitos destinatários. - Revogue um token exposto Se um token for exposto, fale com o administrador da sua conta ou com o suporte da BroadNet para revogá-lo e emitir um novo. ## Relacionado [Referência da API Os endpoints REST por trás das ferramentas MCP, com autenticação Bearer.](https://www.broadnet.me/pt/developers/api) [Especificação OpenAPI 3.1 A descrição completa da API em formato legível por máquina.](https://www.broadnet.me/developers/openapi.yaml) [Início rápido Envie o seu primeiro SMS com curl ou com o SDK TypeScript.](https://www.broadnet.me/pt/developers/quickstart) [Guia: agentes de IA seguros Como os agentes enviam SMS e WhatsApp via MCP e quais proteções configurar primeiro.](https://www.broadnet.me/pt/blog/mcp-server-sms-whatsapp-ai-agents) ## Perguntas ### Qual é a URL do servidor MCP da BroadNet? https://mcp.broadnet.me/mcp. Ele usa o transporte MCP Streamable HTTP e exige um cabeçalho Authorization: Bearer com o seu token BroadNet. ### Quais clientes de IA podem se conectar? Qualquer cliente MCP capaz de se conectar a um servidor remoto via Streamable HTTP e enviar um cabeçalho Authorization personalizado. A gravação de demonstração usa o Cursor. ### Onde obtenho o token? Na sua conta BroadNet. No portal BroadAdmin, Integrations → MCP Integration emite uma chave temporária; uma chave permanente é fornecida pelo administrador da sua conta ou pela conta principal. ### O agente pode enviar mensagens reais? Sim. Na gravação de demonstração, o envio do WhatsApp pelo agente devolve HTTP 200 e a mensagem chega ao telefone. As ferramentas funcionam com as permissões do seu token, exatamente como as suas próprias chamadas API, portanto, trate cada envio como real: habilite apenas as ferramentas que o agente precisa e exija confirmação para os envios. ## Construa com a BroadNet Obtenha uma conta e um token e, depois, conecte o seu agente ou chame a API diretamente. [Fale connosco](https://www.broadnet.me/pt/contact) [Portal do desenvolvedor](https://www.broadnet.me/pt/developers)