Atualizado em Jul 26, 2026

Conectar Servidor MCP

Use esta ação quando quiser que um agente descubra e use as ferramentas expostas por um servidor MCP externo durante a conversa atual.

Melhor para

• Dar a um agente ferramentas hospedadas no seu próprio servidor MCP sem alterar a configuração permanente do assistente
• Enviar cabeçalhos de autenticação cujos valores vêm de passos anteriores (por exemplo step(0).jwt de um passo Gerar Token JWT)
• Conectar ao endpoint MCP do próprio AutoTalk após gerar um JWT

Campos principais

Campo	O que faz
URL do Servidor	O endpoint HTTP completo do servidor MCP (transporte Streamable HTTP). Apenas URLs HTTP(S) públicas são aceitas: endereços de rede privada e interna são rejeitados quando a ação é salva, e a URL passa novamente por verificação SSRF em tempo de execução
Cabeçalhos	Cabeçalhos de requisição opcionais enviados ao servidor. Cada Chave do Cabeçalho e Valor do Cabeçalho é uma expressão CEL avaliada em tempo de execução, então um valor pode referenciar saídas de passos anteriores como step(0).jwt

O que passos posteriores podem usar

Detalhes da conexão estão disponíveis em:

• step(N).url
• step(N).toolCount

O passo registra o servidor; a conexão real e a descoberta de ferramentas acontecem logo em seguida, enquanto o agente prepara a próxima chamada ao modelo. Como a descoberta termina depois que o passo finaliza, step(N).toolCount reporta 0 nesse momento.

Dicas

• Use esta ação como pré-ação de agente para que as ferramentas do servidor já estejam disponíveis quando o modelo responder.
• As ferramentas descobertas são oferecidas ao agente apenas para a execução atual — o servidor não é salvo na configuração do assistente.
• Trate tokens passados em valores de cabeçalho como dados sensíveis: prefira um passo Gerar Token JWT ou Resolver Variáveis em vez de fixar segredos no texto.
• Se a URL estiver ausente ou a conexão não puder ser estabelecida, o passo falha com mcp_missing_url ou mcp_connect_failed (veja step(N).executionContext.safeError.code).