Servidores MCP
Ligue uma vez qualquer servidor compatível com MCP — os seus agentes de voz recebem as ferramentas dele no início da chamada e usam-nas a meio da conversa.
Planos pagosO seu próprio servidorMCP — o Model Context Protocol — é um padrão aberto que permite aos assistentes de IA descobrir e chamar ferramentas externas. Se executa um servidor compatível com MCP (próprio, ou um dos muitos servidores da comunidade), pode ligá-lo à Hanc.AI e os seus agentes irão obter as ferramentas do servidor no momento em que uma chamada começa.
Uma vez ligado, o agente pode chamar essas ferramentas a meio da conversa — puxando dados ao vivo, executando cálculos, iniciando workflows de backend — tal como as integrações nativas de Calendário, HubSpot ou API Tool.
Os servidores MCP estão disponíveis em todos os planos pagos, a partir do Starter — não no período experimental gratuito nem no Free; aí o cartão MCP mostra «Conectar servidores MCP está disponível nos planos pagos». Não há taxa por servidor — paga apenas pelos minutos de chamada que o seu agente usa ao invocar as ferramentas.
O que o seu agente pode fazer
- Chamar as suas ferramentas a meio da conversa — obter dados em tempo real, fazer cálculos, iniciar workflows de backend, exatamente como as integrações incorporadas.
- Receber o conjunto atual de ferramentas em cada chamada — as ferramentas são descobertas no início da chamada, por isso as alterações no seu servidor aparecem na chamada seguinte.
- Usar vários servidores sem conflitos — cada nome de ferramenta tem como prefixo a etiqueta da sua ligação.
Quando Usar MCP
| Cenário | Porque MCP Encaixa |
|---|---|
| Já executa um servidor interno de ferramentas | Uma ligação, todas as suas ferramentas disponíveis a cada agente |
| Quer partilhar ferramentas entre agentes | Ligue uma vez, anexe a quantos agentes quiser |
| Usa servidores MCP da comunidade | Ligue servidores MCP open-source populares sem escrever código personalizado |
| A sua superfície de ferramentas muda frequentemente | O agente re-descobre ferramentas em cada chamada — adicione/remova ferramentas do lado do servidor sem tocar no painel |
Se tem um único endpoint pontual, a API Tool é mais simples. Se tem um conjunto de ferramentas relacionadas, ou já mantém um servidor MCP, esta é a integração certa.
Ligar um Servidor MCP
- Abra a página Integrações
Na barra lateral do painel, vá a Integrações e abra o separador Programadores: a secção Servidores MCP está no topo.

- Clique em Conectar servidor MCP
O painel Servidores MCP lista as suas ligações. Clique em Conectar servidor MCP.

Abre-se uma janela. Preencha:
Campo Descrição Etiqueta Um nome curto para esta ligação (p. ex. Sales Tools,Internal CRM). Aparece na lista de ligações e na lista de servidores MCP do agente, e serve de prefixo aos nomes das ferramentas que a IA vê, por isso mantenha-o curto e claro.URL do servidor O endereço HTTPS do endpoint Streamable HTTP do seu servidor MCP, incluindo o caminho (normalmente /mcp).http://e endereços privados ou internos são rejeitados.Autenticação Nenhuma se o servidor for aberto, ou Token Bearer se esperar um cabeçalho Authorization: Bearer ….Token Bearer (Só Bearer) O seu token, enviado como Authorization: Bearer …. É guardado encriptado; a Hanc.AI só o desencripta para se ligar ao seu servidor em seu nome. Ao editar a ligação, deixe o campo vazio para manter o token atual.
Clique em Conectar. A Hanc.AI só aceita endereços
https://e rejeita hosts privados e internos. Não verifica se o seu servidor MCP responde nesse endereço: um caminho errado ou um servidor em baixo só se nota quando o agente não vê as ferramentas.A ligação fica agora disponível para todos os agentes do seu espaço de trabalho.
Os nomes de ferramentas de cada servidor MCP são prefixados com o rótulo da ligação, portanto um servidor MCP com uma ferramenta lookup_order ligada como "Shop API" irá aparecer ao agente como Shop_API_lookup_order. Isto evita colisões quando liga vários servidores MCP que por acaso têm ferramentas com nomes semelhantes.
Editar ou eliminar
A lista Servidores MCP mostra, para cada ligação, a etiqueta, o URL, a autenticação e o estado (ativo / inativo). Os botões de cada linha:
- Editar — alterar a etiqueta, o URL, a autenticação ou o token e depois clicar em Guardar
- Eliminar — remover a ligação por completo
Remover uma ligação desativa-a para cada agente que a tinha anexada — esses agentes simplesmente perdem o acesso às suas ferramentas na próxima chamada.
Anexar Ferramentas MCP a um Agente
Uma ligação no seu workspace está disponível para os seus agentes — mas cada agente decide individualmente quais das suas ligações expor. Isto significa que pode ter agentes separados de Vendas e Suporte que puxam de servidores MCP diferentes.
- Abra o separador Ações do agente
Escolha o agente, abra o separador Ações e clique em Adicionar ferramenta.
- Escolha Servidores MCP
O menu agrupa as entradas por fase: Pre fetch, Live call, Post call. Servidores MCP está na coluna Live call, em CRM e serviços — o agente chama as ferramentas MCP durante a conversa, não antes nem depois.
- Preencha a ferramenta
Campo Descrição Nome da ferramenta Um nome para esta entrada no separador Ações do agente (p. ex. Ferramentas MCP externas). Obrigatório.Quando usar Uma instrução curta com que o agente decide quando recorrer a estas ferramentas durante a conversa. Obrigatório. Servidores MCP Todas as ligações MCP do seu espaço de trabalho, cada uma com um interruptor. Ative as que este agente deve usar — todas as ferramentas desses servidores passam a poder ser chamadas. Uma ligação que não está ativa aparece marcada como inativo. 
Clique em Guardar. O agente tem agora acesso às ferramentas de cada ligação MCP ativada.
Pode ter uma ligação MCP ativada em cinco agentes e outra ativada em apenas um — cada agente tem a sua própria ferramenta Servidores MCP com o seu próprio conjunto de toggles.
Cenários de exemplo
Consultar uma encomenda no seu próprio servidor
Quem liga pergunta onde está a encomenda → o agente chama a ferramenta lookup_order do seu servidor MCP, ligado como «Shop API» (Shop_API_lookup_order) → responde com o que o seu servidor devolve.
Ferramentas diferentes para agentes diferentes O seu agente de vendas tem a ligação Sales Tools ativa, o seu agente de suporte a ligação Internal CRM → cada agente só vê as ferramentas das suas próprias ligações.
Uma nova ferramenta sem mexer no painel Adiciona uma ferramenta no seu servidor MCP → a chamada seguinte descobre-a → o agente pode usá-la de imediato.
Como Funciona no Momento da Chamada
Quando uma chamada começa, o agente liga-se a cada um dos seus servidores MCP ativados e pergunta "que ferramentas oferece?" O que quer que o servidor devolva é exposto à IA como uma ferramenta que pode chamar durante a conversa.
Algumas coisas a saber:
- As ferramentas são descobertas no início da chamada. Se adicionar ou remover ferramentas no seu servidor MCP, a alteração aparece na próxima chamada — sem necessidade de atualizar nada na Hanc.AI.
- Os nomes das ferramentas são prefixados com o rótulo da ligação (assim
"Shop API"+ ferramentasearch_products→Shop_API_search_products). As ferramentas integradas do agente e outras ferramentas MCP não vão entrar em conflito. - As descrições e schemas de parâmetro das ferramentas vêm do seu servidor MCP. Escreva boas descrições aí — é isso que a IA usa para decidir quando e como chamar a ferramenta.
- Os erros são reportados de volta ao agente. Se uma chamada de ferramenta falhar, o agente vê a mensagem de erro e pode decidir retentar, pedir desculpa ou tentar uma ferramenta diferente.
Requisitos para o Seu Servidor MCP
Para funcionar com a Hanc.AI, o seu servidor precisa de:
| Requisito | Detalhe |
|---|---|
| HTTPS | http:// simples não é aceite. Use um certificado TLS real. |
| URL Público | O URL deve resolver para um endereço público — a Hanc.AI não consegue alcançar servidores numa rede privada ou localhost. |
| Transporte MCP Streamable HTTP | O seu servidor tem de suportar o transporte Streamable HTTP num único endpoint (normalmente /mcp). Servidores que só oferecem o transporte SSE antigo (um endpoint /sse) e servidores stdio não são suportados. |
| Bearer auth (opcional) | Se o seu servidor requer autenticação, deve aceitar um cabeçalho Authorization: Bearer <token> padrão. |
Se está a hospedar o seu próprio servidor atrás de uma firewall, exponha-o via um túnel ou proxy reverso com um endpoint HTTPS público.
Segurança e Privacidade
Os seus bearer tokens são armazenados encriptados. A Hanc.AI só desencripta um token para se ligar ao seu servidor em seu nome.
As chamadas de ferramentas fluem agente → Hanc.AI → seu servidor MCP → de volta. Para resolver problemas, a Hanc.AI regista os argumentos das ferramentas e os primeiros 2000 caracteres de cada resultado. O seu servidor regista o que escolher registar do seu lado.
Se mudar ou fizer rotação do seu token, edite a ligação no painel — o novo valor tem efeito na próxima chamada.
Para que o seu servidor saiba qual utilizador com sessão iniciada no seu site está a ligar, faça o seu servidor emitir um token de curta duração para esse utilizador e passe-o através do widget do site. Chega a cada ligação MCP do agente no cabeçalho X-Hanc-Support-Token — consulte Identificar um utilizador com sessão iniciada.
Disponibilidade por Plano
| Plano | Servidores MCP |
|---|---|
| Período experimental gratuito, Free | Não disponível |
| Starter / Pro / Business / Enterprise | Disponível |
Não há cobrança por ligação — paga apenas pelos minutos de chamada durante os quais o agente invoca as ferramentas.
Resolução de Problemas
"A ligação não guarda"
O painel mostra Não foi possível guardar a conexão. Verifique os valores e tente novamente. Verifique que:
- O URL começa por
https://e não porhttp://. - Verifique se o endereço tem gralhas; hosts privados e internos são rejeitados.
- O host é público —
localhost,127.0.0.1e endereços internos estão bloqueados de propósito.
"O agente não vê as ferramentas"
- Verifique o endereço: a Hanc.AI não verifica se o seu servidor MCP responde nele. Certifique-se de que o URL aponta para o endpoint Streamable HTTP do seu servidor, incluindo o caminho (normalmente
/mcp), e de que o servidor está a funcionar. - Verifique se a ferramenta Servidores MCP do agente tem pelo menos uma ligação ativada, se a ligação está ativo e se a ferramenta foi guardada.
- Certifique-se de que o seu servidor MCP responde a um pedido tools/list sem início de sessão interativo.
- Volte a verificar o token Bearer — espaços ou aspas a mais fazem o seu servidor rejeitá-lo.
"A ferramenta falha a meio da chamada"
- O agente verá qualquer erro que o seu servidor devolva. Verifique os logs do seu servidor.
- Ferramentas de longa duração podem fazer timeout — mantenha a execução das ferramentas MCP em poucos segundos por chamada para que o visitante não fique em silêncio.
"Mudei ferramentas no meu servidor mas o agente continua a usar as antigas"
- As ferramentas são re-descobertas no início de cada chamada, não em cache entre chamadas. A próxima nova chamada vê o conjunto atualizado de ferramentas. As chamadas em curso mantêm as ferramentas que receberam no início.
Relacionados
- Ações e Ferramentas — Ferramentas integradas e como a aba Ações está organizada
- Integrações — Todas as integrações disponíveis
- Ferramenta de API RAG — Opção mais simples para um único endpoint
Integrações relacionadas
monday.com, GoHighLevel, Kommo e CallRail — funcionam sobre MCP.
Envie cada chamada para o seu próprio sistema quando terminar.
Use a API da HANC a partir do seu próprio software.