Saltearse al contenido

Usar servidores MCP

Un servidor MCP te da las herramientas de otra aplicación. En NappAI lo usas con el componente MCP Connection: eliges una herramienta del servidor y se la das a un agente, o la ejecutas como un paso más del flujo.

1. Elige el servidor

Tienes dos caminos:

  • Desde la categoría MCPs de la paleta. Pulsa + en el lienzo y entra en MCPs. Encontrarás más de cien servidores ya preparados, ordenados por temas: CRM y ventas, productividad, pagos, documentación, búsqueda web, bases de datos… Cada uno aparece con su nombre seguido de Mcp, por ejemplo Notion Mcp o Find-A-Domain Mcp. Arrástralo al lienzo: ya lleva la dirección del servidor y su forma de acceso.
  • Con la dirección de cualquier servidor. Si el servidor que quieres no está en la lista, usa el componente MCP Connection con una credencial MCP Remote server en la que escribes su dirección.

También puedes buscarlo por su nombre en Buscar componente.

2. Crea su credencial

Todo servidor necesita una credencial, aunque sea abierto. En el panel del componente, pulsa Crear nueva credencial o elige una que ya tengas. Según el servidor, la credencial te pide:

AccesoQué tienes que hacer
AbiertoSolo darle un nombre y pulsar Agregar.
Con clavePegar la clave que te da la aplicación.
Con inicio de sesiónPulsar el botón para iniciar sesión en tu cuenta del servicio y autorizar el acceso. NappAI guarda el permiso y lo renueva por ti.

Si un servidor admite varias formas de acceso, la credencial te deja elegir. Si creas una credencial MCP Remote server con la dirección de un servidor que tiene integración en la paleta, NappAI te lo avisa y te propone usar la integración, que es más sencilla.

Más sobre credenciales en Credenciales.

3. Dásela a un agente

  1. Conecta la salida Tool del componente a la entrada Tools del agente.
  2. En Tool, elige la herramienta del servidor que quieres usar. Al elegirla aparecen sus datos en Tool Arguments.
  3. En cada dato, pulsa el botón de Definido por IA para que lo rellene el agente en cada uso, o escribe un valor fijo.
  4. Explica en las instrucciones del agente cuándo debe usarla.

Para que un agente use varias herramientas del mismo servidor, añade un componente por herramienta.

También como paso del flujo

Sin conectarla a un agente, la herramienta se ejecuta como cualquier otro paso: rellenas sus datos en Tool Arguments, a mano o con valores de pasos anteriores, y su resultado sale por Data.

Desde un componente Python Code también puedes llamar a una herramienta MCP, por ejemplo para comprobar de una vez una lista entera de datos.

Buenas prácticas

  • Prueba primero en el playground: en Ejecuciones ves cada llamada al servidor, con lo que se envió y lo que devolvió.
  • Si la lista de Tool sale vacía, revisa la credencial: NappAI no ha podido conectar con el servidor.
  • Usa en cada flujo la credencial de la cuenta correcta del servicio, por ejemplo la de pruebas mientras lo montas.