Saltar al contenido principal

Conecta tu Agente

Conectar tu propio asistente de IA a Nirvai es como darle una credencial de empleado: lo configuras una vez y, a partir de ahí, puede usar tu memoria, tus bases de datos y tus herramientas de Nirvai — y todo lo que hace queda registrado en tu cuenta para que lo revises.

Sigues usando el asistente en el que ya confías (Claude Code, Codex u otro). Nirvai se convierte en su cerebro compartido y de largo plazo.

Antes de empezar​

  • Una cuenta de Nirvai.
  • Un asistente compatible instalado: Claude Code, OpenAI Codex o cualquier asistente que hable MCP (el estándar abierto que hoy admiten la mayoría de los asistentes de programación).
  • Una terminal — pegarás un comando o un bloque de configuración.

Paso 1 — Crea tu token de conexión​

  1. En Nirvai, abre Ajustes → Conexiones.
  2. Haz clic en Nueva conexión, ponle un nombre (p. ej. "Mi portátil"), elige para qué asistente es y qué puede hacer: Leer, Ejecutar, Escribir, Crear.
  3. Copia el token que aparece — empieza con nrv_pat_ y solo se muestra una vez.
aviso

Trata el token como una contraseña. Es el único secreto que vive en tu máquina — las contraseñas de tu cuenta y los accesos a tus apps conectadas nunca salen de Nirvai.

Paso 2 — Conecta tu asistente​

Elige tu asistente y reemplaza nrv_pat_... por el token del Paso 1.

Claude Code​

claude mcp add --transport http nirvai \
  https://nirvana-ai.app/nirvai/mcp \
  --header "Authorization: Bearer nrv_pat_..."

OpenAI Codex​

Guarda el token como variable de entorno y añade el servidor a ~/.codex/config.toml:

export NIRVAI_PAT="nrv_pat_..."
[mcp_servers.nirvai]
url = "https://nirvana-ai.app/nirvai/mcp"
bearer_token_env_var = "NIRVAI_PAT"
nota

La configuración de servidores remotos de Codex cambia entre versiones. Si estas claves no coinciden con tu Codex, revisa su documentación de MCP para los nombres actuales — la dirección y el token no cambian.

Otro asistente​

Cualquier asistente que hable MCP se conecta a la misma dirección:

  • Dirección MCP: https://nirvana-ai.app/nirvai/mcp
  • Cabecera: Authorization: Bearer nrv_pat_...

Si tu asistente no habla MCP pero puede llamar a un servicio web, apúntalo a la descripción legible por máquina en https://nirvana-ai.app/nirvai y usa la misma cabecera.

Paso 3 — Haz que Nirvai sea lo predeterminado​

Conectarlo le da a tu asistente la capacidad de usar Nirvai. Este paso lo convierte en costumbre — para que, cuando digas "recuerda esto para la próxima vez", lo guarde en Nirvai y no en un archivo local que se pierde.

  1. Instala la skill de Nirvai (recomendado) — copia la carpeta de la skill nirvai en el directorio de skills de tu asistente (en Claude Code es ~/.claude/skills/). Le enseña cuándo recurrir a tu memoria, bases de datos y herramientas.
  2. Añade una línea al archivo que tu asistente lee cada vez que arranca — CLAUDE.md para Claude Code, AGENTS.md para Codex y la mayoría de los demás:
Esta máquina está conectada a Nirvai — mi memoria de largo plazo, bases de datos y herramientas.
Cuando algo deba durar más allá de esta sesión, compartirse o revisarse después,
lo guardo en Nirvai en lugar de en un archivo local o en mis propias notas.
tip

Tu asistente no "recuerda" que está conectado — vuelve a leer estos archivos en cada sesión. Por eso configurarlo una vez sigue funcionando cada vez que lo abres.

Pruébalo​

Abre tu asistente y pídele algo que deba conservarse:

"Recuerda que nuestro tono de marca es cálido y conciso, para la próxima vez."

Debería guardarlo en Nirvai. Abre Ajustes → Conexiones → Actividad del Agente y verás la acción, con un enlace directo a lo que creó.

Solución de problemas​

ProblemaSolución
"Unauthorized" / 401El token es incorrecto, fue revocado o le falta el prefijo Bearer . Crea uno nuevo en Ajustes → Conexiones.
El asistente no ve las herramientasVerifica que la dirección sea exactamente https://nirvana-ai.app/nirvai/mcp y reinicia el asistente.
Se niega a escribir o crearLos permisos del token son demasiado limitados. Crea uno con Escribir / Crear habilitados.
Igual guardó en un archivo localAñade la línea del Paso 3 a CLAUDE.md / AGENTS.md — eso es lo que hace que Nirvai sea lo predeterminado.
No aparece nada en Actividad del AgenteLa acción pudo haber sido una lectura (no siempre se listan). Prueba con un mensaje de "recuerda esto".

Qué sigue​

  • Bases de Datos — los registros estructurados que tu asistente ya puede leer y actualizar.
  • Agentes — los empleados de IA que puede ejecutar por ti.
  • Automatizaciones — programa ese trabajo para que se ejecute solo.