Instalar con tu agente de código
Deja que Claude Code, Cursor o cualquier agente de código agregue Sypnia a tu proyecto, qué va a cambiar, el prompt exacto para agentes sin skills y qué revisar después.
Esta página es para quien prefiere no editar el código a mano. Tu agente de código puede agregar Sypnia a tu proyecto por ti. Funciona igual para Sypnia Cloud y para un motor con alojamiento propio: el agente pregunta cuál usas.
Al final tendrás: el SDK instalado y arrancado en tu proyecto, los source maps subidos por tu compilación, tu agente conectado a Sypnia para que pueda leer problemas, y una primera comprobación de que los eventos llegan.
Necesitas: un proyecto (en Sypnia Cloud, créalo en app.sypnia.com; en tu propio motor, mira el inicio rápido con alojamiento propio), su llave de ingesta, y un token de API para el agente.
Configúralo
Claude Code
-
Agrega las skills de Sypnia
claude plugin marketplace add sypnia/skills claude plugin install sypnia@sypnia -
Conecta el servidor MCP
claude mcp add --transport http sypnia \ https://mcp.sypnia.com/mcp \ --header "Authorization: Bearer YOUR_API_TOKEN"
Luego dile: «Configura Sypnia en este proyecto».
Cursor
-
Agrega las skills de Sypnia
En Cursor, abre Customize, elige From GitHub Repository e importa
sypnia/skills. -
Conecta el servidor MCP
.cursor/mcp.json { "mcpServers": { "sypnia": { "url": "https://mcp.sypnia.com/mcp", "headers": { "Authorization": "Bearer ${env:SYPNIA_API_TOKEN}" } } } }
Luego dile: «Configura Sypnia en este proyecto».
Any agent
-
Pega este prompt
Lee https://docs.sypnia.com/es/llms.txt y sigue la guía de inicio rápido a la que apunta. Agrega Sypnia a este proyecto: instala @sypnia/browser, llama a init() con la llave de mi proyecto (pídemela) y dime cómo comprobar que llegó la primera sesión.
Un agente sin skills ni MCP igual puede leer todas las páginas: cada una es Markdown plano en su dirección más .md.
Se instalan dos cosas, y cada una hace un trabajo distinto:
| Qué es | Para qué sirve | |
|---|---|---|
| Las skills de Sypnia | Instrucciones que tu agente carga cuando una tarea las necesita: sypnia-setup agrega Sypnia a un proyecto, sypnia-fix arregla un problema que Sypnia reportó. Código abierto, MIT. | El agente configura Sypnia bien a la primera, en vez de adivinar de memoria. |
| El servidor MCP | Una conexión de tu agente a tu proyecto de Sypnia. | El agente puede preguntar «¿qué está fallando en producción?» y leer el problema, la traza y la sesión él mismo. |
Qué puede tocar cada skill, y cómo actualizarla o quitarla, está en Skills. Todas las formas de conectar el servidor MCP, y qué token darle, están en Conectar.
Un agente que no tiene ni skills ni MCP igual puede hacer la configuración: la pestaña Any agent es un prompt que lo apunta a esta documentación, que cualquier agente puede leer como texto simple.
Qué va a hacer el agente
Empieces como empieces, una configuración correcta son estas cinco cosas. Lee el diff del agente contra esta lista antes de aceptarlo.
| # | El agente debería | Tú deberías ver |
|---|---|---|
| 1 | Elegir el SDK que corresponde: @sypnia/next para Next.js, @sypnia/browser para cualquier otra app web, @sypnia/node para un servidor Node. Instalarlo con el gestor de paquetes de tu proyecto. | Una dependencia nueva en package.json, dos si el proyecto tiene un frontend y un backend Node. |
| 2 | Llamar a init una vez, donde arranca la app, con la llave leída de una variable de entorno. | Una línea como project: import.meta.env.VITE_SYPNIA_PROJECT_KEY, y la variable en .env. Para Next.js: withSypnia en next.config.ts y dos archivos pequeños de instrumentación. |
| 3 | Poner environment de modo que solo tu dominio real reporte como production, y release con el commit corto de git. | Ambos en las opciones de init, o dejados a withSypnia, que los pone solo. |
| 4 | Subir los source maps en tu compilación y dejarlos fuera de lo que se publica, con el token de API leído de un secreto llamado SYPNIA_API_TOKEN. | Un paso en tu compilación o en tu CI. Ningún token en el código. |
| 5 | Correr una primera comprobación y decirte dónde mirar. | La petición que hay que buscar en la pestaña Network del navegador, y dónde aparece la primera sesión. |
Y tres cosas que no debe hacer:
- Poner un token de API (
sps_…) en el código o en una variable pública. Solo la llave de ingesta (spk_…) es pública. Si ves un token en el diff, recházalo y revoca el token. - Apagar el enmascarado o intentar grabar lo que se escribe. No existe una opción para eso, ni motivo para buscarla.
- Agregar llamadas por todo tu código. Los errores, los clics, las vistas de página y las peticiones se capturan sin ellas.
identifyva en un solo lugar, donde tu app sabe quién inició sesión.
Qué llave va dónde
| Llave | Empieza por | Quién la recibe | Dónde vive |
|---|---|---|---|
| Llave de ingesta | spk_ | Tu app | En el código o en una variable de entorno pública. Solo puede enviar. |
Token de API con read, y replay si el agente debe ver grabaciones | sps_ | Tu agente de código, por MCP | En la configuración propia del agente, nunca en el repositorio. |
Token de API con admin | sps_ | Tu compilación, para subir source maps | En los secretos de tu CI o de tu proveedor. |
Crea los dos tokens por separado, para poder revocar uno sin detener el otro. Mira Proyectos, entornos, llaves y tokens.
Revísalo después
El agente puede leer
Pregúntale a tu agente: «¿Qué está fallando en mi entorno de desarrollo?»
Deberías verEl agente llama a Sypnia y responde con una lista de problemas, o dice que no hay ninguno. Un error de autorización significa que el token falta o está mal: mira Conectar.Un problema hace el viaje completo
Sigue Tu primer problema: rompe algo a propósito, y luego pídele a tu agente que lo arregle.
Deberías verEl problema aparece en menos de 2 minutos, el agente lo lee, propone el cambio y, tras tu revisión, el problema queda resuelto.
Si prefieres hacerlo a mano
La misma configuración, paso a paso: Inicio rápido: Sypnia Cloud o Inicio rápido: alojamiento propio.