Saltearse al contenido

El asistente desde Claude y otras aplicaciones

El Asistente IA no vive solo en el panel del dashboard. NappAI ofrece un servidor MCP con las mismas herramientas que usa el asistente, así que puedes trabajar con tu cuenta desde fuera:

Desde…Qué consigues
Claude Code, con el plugin de NappAIMontar, probar y arreglar flujos y gestionar tu cuenta desde la terminal, con las mismas instrucciones con las que trabaja el asistente.
Claude (la aplicación y cowork) u otro cliente MCPLo mismo, añadiendo NappAI como conector.
Otra aplicación, como NexusEncargarle una automatización al asistente de NappAI desde el asistente de esa aplicación, sin abrir NappAI.

Lo que puede hacer y con qué permisos

Con tu clave API, un cliente MCP llega a lo mismo que el asistente del chat: los flujos, las ejecuciones, las versiones, las programaciones, los entornos, las credenciales, el equipo, las alertas, los perfiles de ejecución, el registro de actividad, la facturación… Ver Qué puede hacer el asistente.

  • Actúa como tú. Usa la cuenta de quien creó la clave API y su rol: lo que tu rol no permite, el cliente tampoco puede hacerlo.
  • Pide permiso igual. Lo que tiene efectos reales (ejecutar, publicar, programar, cambiar la cuenta) se prepara primero sin aplicarse, con el cambio exacto. El cliente te lo enseña y solo lo aplica si dices que sí.
  • Queda registrado. Lo que hace aparece en el registro de actividad a tu nombre, marcado desde un cliente MCP, y lo que apunte en tu memoria sale como «lo apuntó un cliente MCP».
  • Gasta de tu cuenta. Las ejecuciones que lance cuentan en tu consumo, como las tuyas.

Lo que necesitas

  1. Una clave API de NappAI. Créala en Configuración → Claves API, mejor una solo para este uso, para poder retirarla sin afectar a lo demás. Consulta Claves API.
  2. La dirección del servidor MCP de NappAI. Tiene la forma https://<servidor de NappAI>/flow-editor-mcp/mcp, con el mismo servidor que ves en las direcciones de Acceso a API de un flujo. Si no lo tienes claro, pídesela a tu administrador.

Desde Claude Code: el plugin de NappAI

El plugin trae las instrucciones con las que trabaja el asistente de NappAI (planificar, buscar en el catálogo, construir, arreglar, migrar desde n8n, Make o Zapier, montar un RAG o un agente de voz y gestionar la cuenta) y los comandos para conectar el servidor MCP.

1. Instala el plugin:

Ventana de terminal
claude plugin marketplace add nappai-dev/nappai-plugin
claude plugin install nappai@napptilus

Para que se actualice solo, en una sesión de Claude Code abre /plugin → Marketplaces → napptilus → Enable auto-update.

2. Guarda tu clave API en un fichero que solo puedas leer tú:

Ventana de terminal
mkdir -p ~/.nappai
printf '%s' 'PEGA_TU_CLAVE_API' > ~/.nappai/api-key
chmod 600 ~/.nappai/api-key

3. Conéctalo. Dentro de Claude Code:

/nappai:connect https://<servidor de NappAI>/flow-editor-mcp/mcp

Comprueba la clave antes de guardarla y registra el servidor con un tiempo de espera de 10 minutos, porque montar o ejecutar un flujo grande puede tardar más de lo que Claude Code espera por defecto. Después, reabre Claude Code.

ComandoQué hace
/nappai:connect [dirección]Conecta el servidor con tu clave. Repetirlo actualiza la clave, por ejemplo después de regenerarla.
/nappai:statusDice si el plugin está cargado, si el servidor está conectado y contesta, y de dónde sale la clave.
/nappai:disconnectDesconecta el servidor. No borra el fichero de la clave.

A partir de ahí, pídele a Claude Code lo que le pedirías al asistente: «Monta en NappAI un flujo que lea los correos con factura y guarde los importes en mi hoja de Google». Las instrucciones del plugin entran solas cuando hacen falta.

Cuando monta un flujo, deja también la nota de resumen en el lienzo. Si no la quieres, díselo.

Desde Claude (la aplicación y cowork)

En Claude, NappAI se añade como conector personalizado. Al conectarlo, inicias sesión con tu cuenta de NappAI en lugar de pegar una clave:

  1. En Claude, abre Configuración → Conectores → Añadir conector personalizado.
  2. Ponle un nombre, por ejemplo NappAI, y como dirección la del servidor MCP: en NappAI en la nube, https://api.nappai.tech/flow-editor-mcp/mcp.
  3. Abre Configuración avanzada y escribe el ID de cliente OAuth nappai_claude.client. El secreto se deja vacío.
  4. Pulsa Añadir y después Conectar: se abre el inicio de sesión de NappAI. Entra con tu cuenta y vuelves a Claude con el conector listo.

El conector trabaja con tu cuenta y tu rol, igual que con una clave API, y no hace falta volver a conectarlo mientras lo uses al menos una vez al mes. Si tu NappAI es una instalación propia, la dirección y el ID de cliente te los da tu administrador, que tiene que activar el inicio de sesión para conectores; si al conectarlo Claude no encuentra dónde iniciar sesión, es que falta eso.

Las instrucciones del plugin también sirven en Claude si tu organización lo añade a su biblioteca.

Encargar automatizaciones desde otra aplicación

Una aplicación conectada a NappAI puede encargarle una automatización al asistente de NappAI, como si alguien se la pidiera en el chat. Es lo que hace Nexus con su integración Automatizaciones con NappAI: desde el asistente de Nexus pides, por ejemplo, «cuando gane una oportunidad, crea la factura en Holded», y el asistente de NappAI la planifica, la monta, la prueba y te la deja lista.

Así funciona:

  1. Un administrador de la otra aplicación la conecta a NappAI con una clave API de NappAI. Conviene crearla con un usuario de NappAI dedicado a la integración, porque los encargos se hacen en nombre de quien creó la clave.
  2. Desde esa aplicación pides lo que quieres con tus palabras.
  3. El asistente de NappAI trabaja igual que en el chat. Lo que en el chat serían botones te llega a través de la otra aplicación: sus preguntas con las opciones, las peticiones de permiso y las credenciales que tienes que crear en NappAI (con el enlace para hacerlo). La otra aplicación no puede contestar ni aprobar nada por ti.
  4. Al terminar, te da los enlaces a los flujos que ha creado o cambiado.

El encargo es una conversación más del asistente: queda guardada en la cuenta de NappAI y cuenta en su consumo. Para que funcione, el asistente tiene que estar activado en la organización de NappAI, con su credencial del modelo. El administrador de Nexus puede configurar esa credencial y elegir el modelo sin salir de Nexus: NappAI comprueba la clave antes de guardarla. Si el asistente no está disponible, la otra aplicación recibe el motivo y cómo arreglarlo.