Conexiones MCP

MCP (Model Context Protocol) es el camino inverso al del webhook. El webhook avisa hacia afuera cuando algo ocurre en Intely; una conexión MCP permite que, en el medio de una conversación, la IA consulte o modifique un dato en su sistema y responda con el resultado.

Las conexiones se configuran por agente, en Agente → Integraciones → MCP. Cada conexión habilitada se le presenta al modelo en el turno como una herramienta nativa (type: "mcp"), y el modelo decide cuándo usarla. La integración completa consiste en los cuatro pasos descriptos a continuación.

Implemente un servidor MCP remoto, accesible por https://, con transporte streamable HTTP. Requisitos:

• La URL debe ser pública. No se aceptan direcciones internas ni redes privadas.
• El servidor debe declarar sus herramientas por el propio protocolo: no hace falta registrarlas una por una en Intely.
• Cada herramienta debe ser segura de ejecutar sin confirmación humana (ver la referencia sobre require_approval).
• Conviene que responda en pocos segundos: la llamada ocurre mientras la persona espera la respuesta en el chat.

1. Ingrese al dashboard de Intely y diríjase a Agente → Integraciones → MCP.
2. Complete los campos de la conexión y active la opción Habilitado.
3. El token de autorización se guarda cifrado y se envía al servidor en cada llamada.

{
  "name": "mi_crm",
  "description": "Consultar y actualizar fichas de clientes",
  "server_url": "https://crm.suempresa.com/mcp",
  "authorization_token": "Bearer ....",
  "enabled": true
}

Con esos datos, la conexión que recibe el modelo queda así:

{
  "type": "mcp",
  "server_label": "mi_crm",
  "server_url": "https://crm.suempresa.com/mcp",
  "server_description": "Consultar y actualizar fichas de clientes",
  "authorization": "Bearer ....",
  "require_approval": "never"
}

El modelo llama a las herramientas que su servidor declara, con el nombre y la descripción que usted definió en el protocolo. Casos habituales:

• Consultar el estado de una cuota, un pedido o un turno.
• Crear o actualizar un registro en su sistema.
• Verificar stock o disponibilidad antes de confirmar algo.
• Disparar un proceso interno y devolver el resultado a la conversación.

La respuesta de la herramienta vuelve al modelo y el modelo redacta el mensaje. La persona no ve la llamada ni los datos crudos.

Guarde la conexión habilitada y escríbale al agente una consulta que solo pueda responderse con esos datos. Si la conexión funciona, la respuesta llega con la información de su sistema. Si el token es inválido o el servidor no responde, esa conexión se saltea en ese turno y la conversación continúa sin ella.

Intely no define el protocolo: la conexión se inyecta al modelo como la herramienta mcp de la Responses API de OpenAI. Para escribir el servidor, la referencia es la de OpenAI y la especificación de MCP.

• OpenAI · Connectors and MCP serversLos campos server_label, server_url, authorization y require_approval son los de esta guía.
• OpenAI · Responses APIReferencia del parámetro tools, donde viaja la conexión.
• Model Context Protocol · TransportsCómo implementar streamable HTTP, que es el transporte que consumimos.