Saltearse al contenido
Nappai Documentation

MCP Connection

MCP Connection es un componente que permite a los usuarios de Nappai ejecutar herramientas que están alojadas en un servidor MCP remoto. Con él, puedes lanzar scripts, enviar comandos o usar APIs HTTP de forma sencilla, sin preocuparte por la configuración de la red o la autenticación.

¿Cómo funciona?

Cuando activas MCP Connection, el componente se conecta al servidor MCP especificado en la credencial MCP Remote server. La credencial contiene la URL del servidor, la autenticación y la clave API. Una vez establecida la conexión, el componente envía el comando o script indicado en Command/Script Path y, según el Transport Mode, utiliza STDIO, HTTP o FastMCP en memoria para comunicarte con el servidor. El resultado se devuelve como un mensaje o como una herramienta que puede ser usada por un agente de IA.

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Command/Script Path: Ruta al script de Python o comando que se ejecutará en el servidor. Por ejemplo, server.py o python server.py.
  • Environment Variables: Variables de entorno que se pasarán al proceso STDIO. Ejemplo: DEBUG=true.
  • HTTP Headers: Encabezados HTTP que se incluirán en las peticiones HTTP, útiles para autenticación o configuración de contenido.
  • Mapping Mode: Interruptor que habilita el modo de mapeo para procesar múltiples registros en lote.
  • Transport Mode: Selecciona el método de transporte FastMCP (por ejemplo, STDIO, HTTP, FastMCP).
  • Server Configuration: Configuración JSON para un servidor FastMCP en memoria, si se necesita.
  • Tool: Herramienta que se ejecutará en el servidor. Este campo es obligatorio.
  • Tool Name: Nombre que se mostrará al agente cuando el componente esté conectado como herramienta.
  • Tool Description: Descripción detallada de la herramienta para que el agente sepa cuándo usarla.
  • Tools arguments metadata: Metadatos que definen los argumentos que la herramienta acepta.

Credencial
Este componente requiere una credencial de tipo MCP Remote server.

  1. Configura primero la credencial en la sección de credenciales de Nappai.
  2. Luego selecciona esa credencial en el campo Credential del componente.
    Los datos de la credencial (MCP Server auth, MCP Server url, MCP api key) no se muestran aquí.

Salidas

  • Data: Mensaje que contiene la respuesta del servidor. Se puede usar en flujos de datos o como entrada para otros componentes.
  • Tool: Objeto de herramienta que puede ser pasado a un agente de IA para que lo invoque cuando lo necesite.

Ejemplo de Uso

  1. Configura la credencial: En la sección de credenciales, crea una nueva credencial llamada MCP Remote server con la URL del servidor, el método de autenticación y la clave API.
  2. Añade MCP Connection al flujo de trabajo.
  3. Selecciona la credencial en el campo Credential.
  4. Define el comando: En Command/Script Path escribe python server.py.
  5. Configura el transporte: Elige STDIO en Transport Mode.
  6. Selecciona la herramienta que quieres ejecutar en Tool.
  7. Ejecuta el flujo. El resultado aparecerá en la salida Data y la herramienta estará disponible para el agente.

Plantillas

(Esta sección se omite porque no hay plantillas que utilicen este componente.)

Componentes Relacionados

  • MCP Tools – Permite crear y gestionar herramientas que se ejecutan en el servidor MCP.
  • MCP Server Configuration – Configura parámetros avanzados del servidor MCP.

Consejos y Mejores Prácticas

  • Usa Mapping Mode cuando necesites procesar listas de datos; evita ejecutar el componente una vez por cada registro.
  • Define Tool Description con claridad para que el agente entienda cuándo usar la herramienta.
  • Mantén la credencial segura: no compartas la clave API y revisa los permisos de acceso.

Consideraciones de Seguridad

  • La credencial MCP Remote server debe almacenarse con los permisos mínimos necesarios.
  • Si usas HTTP, habilita HTTPS para proteger la comunicación.
  • Revisa los logs del servidor MCP para detectar accesos no autorizados.