Conecte agentes de IA à BroadNet com MCP.

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.

Teste o servidor de conhecimento no terminal: o handshake initialize e, em seguida, uma chamada de ferramenta.

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"}}}'

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"}}}'

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:

event: message
data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001,
  "message":"Authorization bearer token is required. Connect with an
  'Authorization: Bearer <BroadNet token>' 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:

{
  "mcpServers": {
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

Para testar a conexão sem um cliente, envie você mesmo a solicitação MCP 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.

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

Perguntas