Docs

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.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Configúralo
  2. Qué va a hacer el agente
  3. Qué llave va dónde
  4. Revísalo después
  5. La app envía
  6. El agente puede leer
  7. Un problema hace el viaje completo
  8. Si prefieres hacerlo a mano

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

  1. Agrega las skills de Sypnia

    claude plugin marketplace add sypnia/skills
    claude plugin install sypnia@sypnia
  2. 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».

Se instalan dos cosas, y cada una hace un trabajo distinto:

Qué esPara qué sirve
Las skills de SypniaInstrucciones 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 MCPUna 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íaTú deberías ver
1Elegir 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.
2Llamar 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.
3Poner 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.
4Subir 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.
5Correr 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. identify va en un solo lugar, donde tu app sabe quién inició sesión.

Qué llave va dónde

LlaveEmpieza porQuién la recibeDónde vive
Llave de ingestaspk_Tu appEn 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 grabacionessps_Tu agente de código, por MCPEn la configuración propia del agente, nunca en el repositorio.
Token de API con adminsps_Tu compilación, para subir source mapsEn 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

  1. La app envía

    Corre tu app, haz clic en algo y filtra la pestaña Network del navegador por ingest.

    Deberías ver
    Un POST a …/v1/ingest/events respondido con 200, en menos de 10 segundos.
  2. El agente puede leer

    Pregúntale a tu agente: «¿Qué está fallando en mi entorno de desarrollo?»

    Deberías ver
    El 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.
  3. 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 ver
    El 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.

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar