# MCP y skills

> Conecta 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.

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/mcp/

Para agentes: Empieza aquí para conectar un agente de código a Sypnia: el servidor MCP (remoto, alojado por ti, local por stdio), sus diez herramientas, las dos skills (sypnia-setup, sypnia-fix), ejemplos y seguridad.

**\[Motor]** **\[Nube]** Sypnia le entrega el arreglo al agente que escribió el código. Esta sección explica cómo: un **servidor MCP** al que tu agente de código puede preguntar, y **skills** que le enseñan a trabajar con Sypnia.

> **En palabras simples**
>
> MCP es una forma estándar de que un agente de código (Cursor, Claude Code y otros) use herramientas externas. Conectas Sypnia una vez y, desde entonces, puedes escribir «¿qué está fallando en producción?» y tu agente lo consulta, lee la causa y arregla el código. Una skill es un archivo corto de instrucciones que le dice al agente cómo hacer bien un trabajo, por ejemplo agregar Sypnia a tu proyecto.

**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`.

## Qué puede hacer tu agente

| Tú dices                                     | Tu agente llama a                                  | Recibe                                                                                                             |
| -------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| «¿Qué está fallando en producción?»          | `health`                                           | Los problemas abiertos que afectan a más personas, las comprobaciones caídas, las páginas que se pusieron lentas   |
| «Arregla el problema del botón de pagar»     | `problem`, y `resolve_problem` después del arreglo | La causa con su evidencia, la pila con líneas de código, lo que hizo la persona, la traza, lo que cambió           |
| «¿Qué vio este cliente?»                     | `search`, `sessions`, `session`                    | La sesión, paso a paso, sin nada de lo que escribió                                                                |
| «¿Por qué está lenta la página de búsqueda?» | `performance`                                      | Los números de la página y el elemento detrás de cada uno                                                          |
| «Configura Sypnia en este proyecto»          | La skill `sypnia-setup`                            | El SDK instalado, la llave leída de una variable de entorno, los source maps en el build, una primera comprobación |

El servidor lee. Su única escritura es marcar un problema como resuelto, y puedes apagarla. Nunca hace merge de código y nunca devuelve grabaciones.

## Dónde corre

|                                         | Motor de Sypnia (código abierto, en tu propia infraestructura) | Sypnia Cloud (servicio pago, con un plan gratis) |
| --------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------ |
| Servidor remoto                         | Lo sirve tu motor en `<tu URL base>/mcp`                       | `https://mcp.sypnia.com/mcp`                     |
| Servidor local (\`@sypnia/mcp\`, stdio) | Sí. Llama a la API de tu motor                                 | Sí. Llama a la API de la nube                    |
| Herramientas                            | Las diez                                                       | Las diez                                         |
| Skills                                  | Sí                                                             | Sí                                               |

## En esta sección
