Saltar al contenido principal
DocumentationAPI ReferenceVideo Tutorials

Servidores MCP

MCP — el Model Context Protocol — es un estándar abierto que permite a los asistentes de IA descubrir y llamar a herramientas externas. Si ejecutas un servidor compatible con MCP (propio o uno de los muchos servidores comunitarios), puedes conectarlo a Hanc.AI y tus agentes obtendrán las herramientas del servidor en el momento en que comienza una llamada.

Una vez conectado, el agente puede llamar a esas herramientas en medio de la conversación — obteniendo datos en vivo, ejecutando cálculos, lanzando flujos de trabajo del backend — exactamente como las integraciones integradas de Calendar, HubSpot o API Tool.

Disponible en todos los planes

Los servidores MCP están disponibles en todos los planes incluido Free. No hay coste por servidor — solo pagas los minutos de llamada que tu agente usa al invocar las herramientas.

Cuándo usar MCP​

EscenarioPor qué encaja MCP
Ya ejecutas un servidor de herramientas internoUna conexión, todas tus herramientas disponibles para todos los agentes
Quieres compartir herramientas entre agentesConecta una vez, vincula a tantos agentes como quieras
Usas servidores MCP comunitariosConecta servidores MCP populares de código abierto sin escribir código personalizado
Tu superficie de herramientas cambia con frecuenciaEl agente re-descubre las herramientas en cada llamada — añade/elimina herramientas del lado del servidor sin tocar el panel

Si tienes un único endpoint puntual, la Herramienta API es más simple. Si tienes un conjunto de herramientas relacionadas, o ya mantienes un servidor MCP, esta es la integración correcta.

Conectar un servidor MCP​

1. Abre la página Integraciones​

En la barra lateral del panel, ve a Integración. Desplázate a la sección Servidores MCP.

2. Haz clic en "Conectar servidor MCP"​

Se abre un modal. Rellena:

CampoDescripción
EtiquetaUn nombre corto para esta conexión (p. ej. "Sales Tools", "Internal CRM"). La etiqueta se muestra en el selector de herramientas del agente y prefija los nombres de herramienta presentados a la IA, así que mantenlo corto y significativo.
URLLa URL HTTPS de tu servidor MCP. Debe ser una dirección públicamente alcanzable — se rechazan http:// y direcciones privadas/internas.
AutenticaciónNinguna si tu servidor es abierto, o Bearer token si espera una cabecera Authorization: Bearer ….
Token(Solo Bearer) Tu token de autenticación. Almacenado cifrado — solo tu cuenta de plataforma puede descifrarlo para su uso.

Haz clic en Guardar. Hanc.AI verifica el formato de la URL y almacena la conexión. La conexión está ahora disponible para cada agente de tu espacio de trabajo.

Las etiquetas importan

Los nombres de herramienta de cada servidor MCP se prefijan con la etiqueta de conexión, así que un servidor MCP con una herramienta lookup_order conectado como "Shop API" aparecerá ante el agente como Shop_API_lookup_order. Esto previene colisiones cuando conectas varios servidores MCP que tienen herramientas con nombres similares.

3. Editar, deshabilitar o eliminar​

La lista de servidores MCP muestra la etiqueta, URL, tipo de autenticación y estado de cada conexión que has añadido. Usa las acciones de fila para:

  • Editar — cambiar etiqueta, URL, tipo de autenticación o token
  • Eliminar — quitar la conexión por completo

Eliminar una conexión la desactiva para cada agente que la tuviera vinculada — esos agentes simplemente pierden acceso a sus herramientas en la siguiente llamada.

Vincular herramientas MCP a un agente​

Una conexión en tu espacio de trabajo está disponible para tus agentes — pero cada agente decide individualmente cuáles de tus conexiones exponer. Esto significa que puedes tener agentes separados de Ventas y Soporte que tiran de servidores MCP distintos.

1. Abre la pestaña Acciones del agente​

Elige el agente. Abre la pestaña Acciones. Haz clic en Añadir acción.

2. Elige "Servidores MCP" del grupo Live-call​

El desplegable muestra tres grupos: Pre fetch, Live call, Post call. Busca en el grupo Live-call — ahí es donde encajan los servidores MCP, porque el agente invoca las herramientas MCP durante la conversación, no antes ni después.

3. Activa qué conexiones habilitar​

El modal lista cada conexión MCP de tu espacio de trabajo, cada una con un interruptor activado/desactivado. Activa las que este agente debe usar. También puedes escribir una breve instrucción en el campo "Cuándo usarlo" — esto es lo que el agente lee para decidir cuándo recurrir a estas herramientas durante una conversación.

Haz clic en Guardar. El agente ahora tiene acceso a las herramientas de cada conexión MCP habilitada.

Combina como quieras

Puedes tener una conexión MCP habilitada en cinco agentes y otra habilitada en solo uno — cada agente tiene su propia herramienta de servidores MCP con su propio conjunto de interruptores.

Cómo funciona durante la llamada​

Cuando comienza una llamada, el agente se conecta a cada uno de sus servidores MCP habilitados y pregunta "¿qué herramientas ofreces?" Lo que el servidor devuelva se expone a la IA como una herramienta que puede llamar durante la conversación.

Algunas cosas a saber:

  • Las herramientas se descubren al inicio de la llamada. Si añades o eliminas herramientas en tu servidor MCP, el cambio aparece en la siguiente llamada — sin necesidad de actualizar nada en Hanc.AI.
  • Los nombres de herramienta se prefijan con la etiqueta de la conexión (así "Shop API" + herramienta search_products → Shop_API_search_products). Las herramientas integradas del agente y otras herramientas MCP no chocan.
  • Las descripciones de herramienta y los esquemas de parámetros provienen de tu servidor MCP. Escribe buenas descripciones allí — eso es lo que la IA usa para decidir cuándo y cómo llamar a la herramienta.
  • Los errores se reportan al agente. Si una llamada a herramienta falla, el agente ve el mensaje de error y puede decidir reintentar, disculparse o probar otra herramienta.

Requisitos para tu servidor MCP​

Para funcionar con Hanc.AI, tu servidor necesita:

RequisitoDetalle
HTTPShttp:// plano no se acepta. Usa un certificado TLS real.
URL públicaLa URL debe resolver a una dirección pública — Hanc.AI no puede alcanzar servidores en una red privada o localhost.
Transporte MCP Streamable HTTPEl transporte HTTP actual de MCP sobre un único endpoint. Los transportes solo SSE y stdio no se admiten en esta integración.
Autenticación Bearer (opcional)Si tu servidor requiere autenticación, debe aceptar una cabecera estándar Authorization: Bearer <token>.

Si alojas tu propio servidor detrás de un firewall, expónlo mediante un túnel o proxy inverso con un endpoint HTTPS público.

Seguridad y privacidad​

Tus bearer tokens se almacenan cifrados en reposo. Solo la infraestructura de llamadas de Hanc.AI puede descifrarlos, y solo en el momento en que una llamada comienza y el agente necesita conectarse a tu servidor.

Las llamadas a herramientas fluyen agente → Hanc.AI → tu servidor MCP → vuelta. No registramos los payloads de las llamadas a herramientas. Tu servidor registra lo que tú elijas registrar de tu lado.

Si cambias o rotas tu token, edita la conexión en el panel — el nuevo valor entra en efecto en la siguiente llamada.

Disponibilidad por plan​

PlanServidores MCP
FreeDisponible
Starter / Pro / Business / EnterpriseDisponible

No hay cargo por conexión — solo pagas los minutos de llamada durante los cuales el agente invoca las herramientas.

Solución de problemas​

"La conexión no se guarda"​

  • Asegúrate de que la URL empieza por https:// y no por http://.
  • Asegúrate de que el host es públicamente alcanzable — localhost, 127.0.0.1 y las direcciones internas están bloqueadas por diseño.
  • Vuelve a revisar el bearer token si configuraste uno — espacios en blanco extra o comillas romperán el guardado.

"El agente no ve las herramientas"​

  • Comprueba que la entrada de servidor MCP en la pestaña Acciones del agente tiene al menos una conexión activada y la entrada está guardada.
  • Asegúrate de que tu servidor MCP responde a una petición tools/list y no requiere un flujo de autenticación interactivo.
  • Mira en el registro de llamadas del agente los mensajes de la conexión MCP justo al inicio de la llamada.

"La herramienta falla a mitad de la llamada"​

  • El agente verá cualquier error que devuelva tu servidor. Comprueba los registros de tu servidor.
  • Las herramientas de larga duración pueden agotar el tiempo de espera — mantén la ejecución de herramientas MCP por debajo de unos pocos segundos por llamada para que quien llama no se quede en silencio.

"He cambiado herramientas en mi servidor pero el agente sigue usando las antiguas"​

  • Las herramientas se re-descubren al inicio de cada llamada, no se cachean entre llamadas. La siguiente nueva llamada ve el conjunto actualizado. Las llamadas en curso mantienen las herramientas que se les dio al inicio.

Relacionado​