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 agente
- Enviar cabeçalhos de autenticação cujos valores vêm de passos anteriores (por exemplo
workflow.step(0).jwtde 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 workflow.step(0).jwt |
O que passos posteriores podem usar
Detalhes da conexão estão disponíveis em:
workflow.step(N).urlworkflow.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, workflow.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 agente.
- 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.
- URL ausente/inválida ou erro de validação no registro faz a etapa falhar (
mcp_missing_urloumcp_connect_failedemworkflow.step(N).executionContext.safeError.code). O registro adiciona o servidor à execução; não garante sucesso da descoberta posterior de ferramentas. Erros de descoberta podem ser registrados e as ferramentas desse servidor ignoradas.