# 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: el motor de Sypnia (código abierto, en tu propia infraestructura) y Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/start/install-with-your-agent/

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](https://docs.sypnia.com/es/start/quickstart-self-host)), su llave de ingesta, y un token de API para el agente.

## Configúralo

**Claude Code**

1. Agrega las skills de Sypnia:
   ```bash
   claude plugin marketplace add sypnia/skills
   claude plugin install sypnia@sypnia
   ```
2. Conecta el servidor MCP:
   ```bash
   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**

1. Agrega las skills de Sypnia: En Cursor, abre **Customize**, elige **From GitHub Repository** e importa `sypnia/skills`.
2. Conecta el servidor MCP:

   `.cursor/mcp.json`
   ```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**

1. Pega este prompt:
   ```text
   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](https://docs.sypnia.com/es/mcp/skills). Todas las formas de conectar el servidor MCP, y qué token darle, están en [Conectar](https://docs.sypnia.com/es/mcp/connect).

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. `identify` va 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](https://docs.sypnia.com/es/concepts/projects-keys-and-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](https://docs.sypnia.com/es/mcp/connect).

### 3. Un problema hace el viaje completo

Sigue [Tu primer problema](https://docs.sypnia.com/es/start/your-first-problem): 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](https://docs.sypnia.com/es/start/quickstart-cloud) o [Inicio rápido: alojamiento propio](https://docs.sypnia.com/es/start/quickstart-self-host).
