Saltar al contenido principal

MCP

Instala la conexión

Cómo agregar Nirvai a Claude Code, Codex, Cursor o cualquier cliente MCP con un solo comando, enseñarle a tu asistente qué puede hacer Nirvai y aprobar lo que construye.

Instalar es como entregarle a un colega la tarjeta de acceso que acabas de crear. Con tu token de conexión copiado, es un solo comando: tu dirección de Nirvai (ya incluida abajo) más el token.

Ejecuta el comando de tu asistente​

Reemplaza <YOUR_TOKEN> por el token de conexión de Ajustes → Conexiones.

Tu dirección de conexión de Nirvaihttps://3kt55hmm4ixi5duur67snxkgz40nklgn.lambda-url.us-west-2.on.aws/nirvai/mcp
Claude Code
claude mcp add --transport http nirvai "https://3kt55hmm4ixi5duur67snxkgz40nklgn.lambda-url.us-west-2.on.aws/nirvai/mcp" --header "Authorization: Bearer <YOUR_TOKEN>"
Cualquier cliente MCP
npx add-mcp "https://3kt55hmm4ixi5duur67snxkgz40nklgn.lambda-url.us-west-2.on.aws/nirvai/mcp" --header "Authorization: Bearer <YOUR_TOKEN>"

Reemplaza <YOUR_TOKEN> por el token de conexión que copiaste.

Y listo — tu asistente ya ve Nirvai. Pídele "¿Qué tengo en Nirvai?" y listará tus agentes, bases de datos y conexiones. Lo primero que suele ofrecer es reconciliar lo que ya sabe de ti en tu proyecto compartido.

Prueba un comando de barra

En el campo de texto de tu asistente, escribe /nirvai: para ver los comandos integrados de Nirvai — connect, remember, recall, new_agent, activity y más. Son atajos que inician los pasos correctos por ti. Consulta Comandos.

Enséñale qué puede hacer Nirvai​

Tu asistente ya puede acceder a Nirvai, pero un chat nuevo no sabe cuándo usar cada capacidad — una base de datos, un proyecto, una automatización. Deja un archivo inicial en tu proyecto y las aprende todas. Elige tu asistente, descarga el archivo (o cópialo) y edítalo como quieras.

Para
Conjunto inicial
your-project / CLAUDE.md
CLAUDE.md
Instrucciones de Nirvai que tu agente lee en cada sesión
Cuándo se carga
Se carga en el contexto al inicio de cada sesión de Claude Code.

Le indica al agente que Nirvai está conectado y — la parte que le falta a una sesión nueva — cuándo recurrir a cada capacidad. Cópialo y edítalo a tu gusto.

Working with Nirvai (connected over MCP)

Nirvai is your backend and native UI: shared memory, structured databases, hundreds

of credentialed tools, cloud skills, agents, live apps, and automations — with an

activity feed where every action you take is visible and deep-linked.

The shape of every action

  • Discover, don't guess: nirvai_list_resources(kind) then nirvai_describe(ref). Address resources by their uuid, never by name.
  • One thing per call: nirvai_execute(alias, args, description, session). description is a REQUIRED one-line "why" — it is what the user reads in their feed.
  • Keep a session: nirvai_create_session(name) once, pass its uuid as session on every related call so the work threads together.
  • Every call returns a link. Hand it to the user; never paste raw data dumps.

First move in a new session

  1. nirvai_download_skill_package("_root", session) and read it.
  2. nirvai_list_resources for what already exists — reuse by uuid before creating.
  3. nirvai_describe the thing you will touch, download its entity pack, then act.

Where each kind of data belongs

  • Databases — anything that is a LIST OF RECORDS THAT NEEDS ORDER: a CRM of contacts, a task tracker, leads, inventory, invoices. Spaces hold Databases (tables) with typed columns (text, status, select, date, person, relation, file) and views (grid, kanban, calendar, form). Verbs: db.create_space, db.create_database, db.create_view, db.insert, db.update, db.select. Hand back the table link.
  • Projects — long-term KNOWLEDGE ABOUT SPECIFIC THINGS you must remember across conversations: a client's preferences, an ongoing investigation, decisions and their reasons. A knowledge graph plus a file appendix. Verbs: projects.recall, projects.add, projects.store_file. Reach for a Project when the fact matters next week, not just this turn — and projects.recall BEFORE you answer from memory.
  • Live apps — an interactive dashboard or app built on the user's real tools and data, not a static report. Verbs under live_apps.*.
  • Agents — build and run AI agents on the user's account: agents.run, agents.create. Delegate a real task, then show the run transcript link.
  • Automations — a workflow on a trigger (manual, schedule, webhook, or an app event) with agent steps and free deterministic steps. Flow: automations.templates then automations.validate(spec) then automations.create(spec); hand off the review link — the user tests and activates.
  • Tools & credentials — connect a provider and run its credentialed tools in the cloud. Call credentials.native_requirements and tools.search_templates FIRST, then tools.use. Built-ins: web.search, web.fetch, media.image.
  • Skills — run one of the user's cloud skills end to end: skills.run.
  • Help — docs.search / docs.read for product documentation.

Non-negotiables

  • You NEVER hold a secret. Propose a credential by field NAME; the user types the value on the link Nirvai returns. Never ask the user to paste an API key into chat.
  • Reuse before you create. A retry with the same idempotency_key will not duplicate.
  • One plain-language description per action. It is the spine of the activity feed.

Master tools

nirvai_list_resources · nirvai_describe · nirvai_execute · nirvai_create_session ·

nirvai_list_sessions · nirvai_get_session · nirvai_sync_session · nirvai_transfer_file ·

nirvai_download_skill_package

Recipes

Stand up a CRM

  1. db.create_space { name: "Sales" }
  2. db.create_database { database_session, name: "Contacts", columns: [...] }
  3. db.insert / db.select — hand back the table link.

Remember a client across sessions

  1. projects.create_store { name, description } (description = when to use it)
  2. projects.add to store observations; projects.recall next time before answering.

Run a task with an agent

  1. nirvai_list_resources("agents") then pick by uuid
  2. agents.run { agent_uuid, message } then show the run link.

Ship an automation

  1. automations.templates then pick a trigger
  2. automations.validate(spec) then fix the reported issues
  3. automations.create(spec) then send the review link; the user tests + activates.
O deja que el asistente lo escriba

¿Ya está conectado? Solo ejecuta /nirvai:setup_file y tu asistente escribe este archivo en tu proyecto por ti.

Qué pasa después: propone, tú apruebas​

Tu asistente nunca cambia nada a tus espaldas. Trabaja en su propio chat y, cuando está listo, te entrega un marcador hacia Nirvai — una página de revisión con los detalles y un único botón de Crear. Ves una vista previa de lo que construyó antes de guardar nada. Es el mismo flujo ya sea una live app, un agente, una herramienta o un acceso:

Claude Code

Listo — armé tu live app de Embudo de ventas con tus negocios de HubSpot. Revísala y guárdala:

Live appEmbudo de ventasAbrir revisión en Nirvai
Vista previa
Embudo de ventasLIVE
Abiertos128
Ganados$42k
Tasa73%
Claude Code

Configuré un Agente de Soporte con tu herramienta de búsqueda de pedidos y tus documentos de ayuda. Revísalo:

AgenteAgente de SoporteAbrir revisión en Nirvai
Vista previa
Agente de SoporteResponde sobre pedidos
3 herramientas1 base de datosDocumentos

Los secretos siempre los escribes tú, en la página segura de Nirvai — nunca a través del asistente. Nada se guarda hasta que haces clic en Crear.

Solución de problemas​

ProblemaSolución
El comando muestra la dirección como <your-nirvai-backend>La dirección de conexión no se configuró para esta compilación de la documentación. Toma la dirección exacta desde Ajustes → Conexiones en la app — aparece junto al comando de instalación ahí.
"No autorizado" / el asistente no ve nadaEl token es incorrecto, expiró o fue revocado. Crea uno nuevo en Ajustes → Conexiones y vuelve a ejecutar el comando.
Puede leer pero no crearLos permisos del token son muy limitados. Crea un token nuevo con escribir y crear habilitados.
Una página de revisión pide una contraseñaEs lo esperado — los secretos siempre los ingresas tú, en la página segura de Nirvai. Tu asistente no puede completar un acceso por ti.

Siguiente paso​

Feed de Actividad

Ve cada acción que hizo tu asistente, con enlace directo al resultado.

Referencia MCP

Qué expone la conexión y las reglas que la mantienen segura.