MCP Connection
MCP Connection te conecta con un servidor MCP: un servicio externo que publica una lista de herramientas listas para usar, como consultar un CRM, crear tareas en un gestor de proyectos o leer documentos de otra aplicación. Muchas empresas y aplicaciones ofrecen ya su propio servidor MCP.
Eliges una de las herramientas del servidor y puedes usarla de dos formas: como paso del flujo, rellenando tú sus datos, o como herramienta de un agente, que decide cuándo usarla y qué datos enviarle.
Cuándo usarlo
- La aplicación que usa tu empresa ofrece un servidor MCP y quieres usar sus funciones sin un componente específico.
- Quieres que un agente consulte o actualice información en un sistema interno publicado como servidor MCP.
- Tu equipo técnico ha publicado herramientas propias en un servidor MCP y quieres usarlas en tus flujos.
- Necesitas que un agente de MCP trabaje con todas las herramientas de un servidor a la vez.
Configuración
Necesitas una credencial MCP Remote server con la dirección del servidor (MCP Server url) y su forma de acceso (MCP Server auth): abierto, con clave o con inicio de sesión. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial MCP Remote server. Al elegirla, NappAI se conecta al servidor y carga sus herramientas en Tool. |
| Transport Mode | Cómo se comunica NappAI con el servidor: Streamable HTTP (por defecto) o SSE (Deprecated), que solo necesitas si tu servidor no admite la primera. Si la dirección del servidor termina en /sse, se elige sola. |
| Tool (obligatorio) | La herramienta del servidor que quieres usar. Al elegirla aparecen, en el grupo Tool Arguments, los datos que esa herramienta necesita. |
| Enable MCP Agent Mode | Actívalo para entregar el servidor completo a un agente de MCP en lugar de una sola herramienta. Oculta Transport Mode y Tool y muestra Server Name. |
| Server Name | El nombre con el que el agente de MCP identifica este servidor. Obligatorio con Enable MCP Agent Mode. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| HTTP Headers | Cabeceras adicionales que el servidor te pida, por ejemplo un identificador de cuenta. |
Resultado
- Data: el texto que devuelve la herramienta elegida al ejecutarla con los datos de Tool Arguments.
- Tool: se conecta a la entrada Tools de un agente. El agente usa la herramienta elegida y puede rellenar los datos que marques como Definido por IA. Más sobre esto en Tool Mode.
- MCP: el servidor completo, para conectarlo a un agente de MCP cuando Enable MCP Agent Mode está activado.
Ejemplo
Una empresa de reformas gestiona sus proyectos en una aplicación que ofrece servidor MCP y quiere que su asistente cree tareas.
- Crea una credencial MCP Remote server con la dirección del servidor y la clave que te da la aplicación.
- Añade MCP Connection, elige la credencial y, en Tool, la herramienta para crear tareas.
- En Tool Arguments, marca como Definido por IA el título y la descripción de la tarea, y deja fijo el proyecto.
- Conecta la salida Tool a la entrada Tools del agente.
- Un encargado escribe “Apunta revisar la instalación eléctrica del piso de la calle Mayor”. El agente crea la tarea en el proyecto.
Buenas prácticas
- Si quieres que un agente use varias herramientas del mismo servidor, añade un MCP Connection por herramienta o usa Enable MCP Agent Mode con un agente de MCP.
- Si la lista de Tool aparece vacía, revisa la dirección y el acceso de la credencial: NappAI no ha podido conectarse al servidor.