Saltar al contenido principal
Actualizado el Oct 25, 2026

Conectar Servidor MCP

Usa esta acción cuando quieras que un agente descubra y use las herramientas expuestas por un servidor MCP externo durante la conversación actual.

Mejor para​

  • Dar a un agente herramientas alojadas en tu propio servidor MCP sin cambiar la configuración permanente del agente
  • Enviar headers de autenticación cuyos valores vienen de pasos anteriores (por ejemplo workflow.step(0).jwt de un paso Generar Token JWT)
  • Conectar al endpoint MCP del propio AutoTalk después de generar un JWT

Campos principales​

CampoQué hace
URL del ServidorEl endpoint HTTP completo del servidor MCP (transporte Streamable HTTP). Solo se aceptan URLs HTTP(S) públicas: las direcciones de red privada e interna se rechazan cuando se guarda la acción, y la URL pasa de nuevo por verificación SSRF en tiempo de ejecución
EncabezadosHeaders de solicitud opcionales enviados al servidor. Cada Clave del encabezado y Valor del encabezado es una expresión CEL evaluada en tiempo de ejecución, así que un valor puede referenciar salidas de pasos anteriores como workflow.step(0).jwt

Qué pueden usar los pasos posteriores​

Los detalles de la conexión están disponibles en:

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

El paso registra el servidor; la conexión real y el descubrimiento de herramientas ocurren justo después, mientras el agente prepara su próxima llamada al modelo. Como el descubrimiento termina después de que el paso finaliza, workflow.step(N).toolCount reporta 0 en ese momento.

Consejos​

  • Usa esta acción como pre-acción de agente para que las herramientas del servidor ya estén disponibles cuando el modelo responda.
  • Las herramientas descubiertas se ofrecen al agente solo para la ejecución actual — el servidor no se guarda en la configuración del agente.
  • Trata los tokens pasados en valores de header como datos sensibles: prefiere un paso Generar Token JWT o Resolver Variables en vez de escribir secretos directamente.
  • Una URL ausente/inválida o un error de validación del registro hace fallar el paso (mcp_missing_url o mcp_connect_failed en workflow.step(N).executionContext.safeError.code). El registro añade el servidor a la ejecución; no garantiza que la posterior búsqueda de herramientas tenga éxito. Los errores de búsqueda pueden registrarse y las herramientas de ese servidor omitirse.