Pular para o conteúdo principal
Logótipo do Model Context Protocol

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 servidor

MCP — 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.

Planos pagos

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árioPorque MCP Encaixa
Já executa um servidor interno de ferramentasUma ligação, todas as suas ferramentas disponíveis a cada agente
Quer partilhar ferramentas entre agentesLigue uma vez, anexe a quantos agentes quiser
Usa servidores MCP da comunidadeLigue servidores MCP open-source populares sem escrever código personalizado
A sua superfície de ferramentas muda frequentementeO 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​

  1. 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.

    O separador Programadores da página Integrações: Servidores MCP e Gerenciamento de chaves de API
  2. Clique em Conectar servidor MCP

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

    O painel Servidores MCP: a lista de ligações com etiqueta, URL, autenticação e estado, e o botão Conectar servidor MCP

    Abre-se uma janela. Preencha:

    CampoDescrição
    EtiquetaUm 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 servidorO 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çãoNenhuma 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.
    A janela Conectar servidor MCP: etiqueta, URL do servidor e autenticação

    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 rótulos importam

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.

  1. Abra o separador Ações do agente

    Escolha o agente, abra o separador Ações e clique em Adicionar ferramenta.

  2. 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.

  3. Preencha a ferramenta
    CampoDescrição
    Nome da ferramentaUm nome para esta entrada no separador Ações do agente (p. ex. Ferramentas MCP externas). Obrigatório.
    Quando usarUma instrução curta com que o agente decide quando recorrer a estas ferramentas durante a conversa. Obrigatório.
    Servidores MCPTodas 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.
    A janela Adicionar ferramenta Servidores MCP: nome da ferramenta, quando usar e um interruptor por ligação MCP

    Clique em Guardar. O agente tem agora acesso às ferramentas de cada ligação MCP ativada.

Misturar e combinar

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" + ferramenta search_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:

RequisitoDetalhe
HTTPShttp:// simples não é aceite. Use um certificado TLS real.
URL PúblicoO 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 HTTPO 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​

PlanoServidores MCP
Período experimental gratuito, FreeNão disponível
Starter / Pro / Business / EnterpriseDisponí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 por http://.
  • Verifique se o endereço tem gralhas; hosts privados e internos são rejeitados.
  • O host é público — localhost, 127.0.0.1 e 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.