Docs

Conectar

Conecta Claude Code, Cursor o cualquier otro cliente MCP al servidor MCP de Sypnia, remoto o local, con el comando o el fragmento exacto para cada uno.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. El camino corto
  2. Cuál servidor
  3. Conecta tu cliente
  4. Agrega el servidor
  5. Compruébalo
  6. Escribe la configuración
  7. Define el token
  8. Compruébalo
  9. Comprueba que funciona
  10. Opciones del servidor local
  11. Cuando no funciona
  12. Sigue con

Motor Nube Esta página es para quien usa un agente de código que habla MCP.

Al final tendrás: tu agente de código conectado a Sypnia, respondiendo «¿qué está fallando en producción?» con datos reales de tu proyecto.

Antes de empezar necesitas un token de API con el permiso read. Créalo en la app (Sypnia Cloud) o con sypnia token create --name "Mi agente" --scopes read (alojamiento propio). Mira Autenticación.

El camino corto

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

Qué hacen las skills

El resto de la página es lo mismo, completo: cada cliente, un motor alojado por ti y el servidor local.

Cuál servidor

Hay tres formas de llegar a las mismas diez herramientas. Elige una.

ServidorDirecciónÚsalo cuando
Remoto, Sypnia Cloudhttps://mcp.sypnia.com/mcpTu proyecto está en Sypnia Cloud. No hay nada que instalar
Remoto, tu motor<tu URL base>/mcpAlojas tú el motor. El motor lo sirve junto a la API
Local (@sypnia/mcp)Un programa en tu máquina, por stdioTu cliente solo soporta stdio, o tu motor no es alcanzable desde donde se conecta el cliente. Llama a la API HTTP por ti

Los servidores remotos hablan Streamable HTTP y reciben el token en el encabezado Authorization. El local necesita Node.js 20 o posterior y toma el token de una variable de entorno.

Conecta tu cliente

Claude Code

  1. Agrega el servidor

    Corre uno de estos en el directorio de tu proyecto.

    Sypnia Cloud:

    Terminal
    claude mcp add --transport http sypnia \
      https://mcp.sypnia.com/mcp \
      --header "Authorization: Bearer YOUR_API_TOKEN"

    Un motor alojado por ti:

    Terminal
    claude mcp add --transport http sypnia \
      https://sypnia.example.com/mcp \
      --header "Authorization: Bearer YOUR_API_TOKEN"

    El servidor local:

    Terminal
    claude mcp add --env SYPNIA_API_TOKEN=YOUR_API_TOKEN --transport stdio sypnia \
      -- npx -y @sypnia/mcp

    Para un motor alojado por ti con el servidor local, agrega --env SYPNIA_BASE_URL=https://sypnia.example.com antes de --transport.

    Deberías ver
    Claude Code confirma que agregó el servidor sypnia.
  2. Compruébalo

    Terminal
    claude mcp list
    Deberías ver
    sypnia aparece como conectado. Dentro de una sesión, /mcp muestra el servidor y sus herramientas.

Por defecto el servidor se agrega para ti, en este proyecto. Agrega --scope user para tenerlo en todos los proyectos, o --scope project para compartirlo con tu equipo por medio de un archivo .mcp.json en la raíz del repositorio. En ese archivo, toma el token del entorno para que nunca quede en un commit:

.mcp.json
{
  "mcpServers": {
    "sypnia": {
      "type": "http",
      "url": "https://mcp.sypnia.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SYPNIA_API_TOKEN}"
      }
    }
  }
}

Para quitar el servidor: claude mcp remove sypnia.

Comprueba que funciona

Pregúntale a tu agente:

Text
¿Qué está fallando en producción?
Deberías ver

El agente llama a la herramienta health (tu cliente puede pedirte permiso) y responde con los datos de tu proyecto. Si no hay nada mal, lo dice. Los clientes muestran la llamada bajo el nombre del servidor: sypnia.health, sypnia:health o mcp__sypnia__health.

Opciones del servidor local

@sypnia/mcp lee estas. Las opciones de línea de comandos ganan sobre las variables.

VariableOpciónPor defectoQué es
SYPNIA_API_TOKENNingunaNinguno, obligatoriaEl token de API
SYPNIA_BASE_URL--base-url <url>https://api.sypnia.comLa URL base de tu motor, sin /v1
SYPNIA_PROJECT--project <id o slug>NingunoSolo con una credencial que ve varios proyectos
SYPNIA_MCP_READ_ONLY--read-onlyfalsetrue quita resolve_problem

Cuando no funciona

Qué vesPor quéQué hacer
401 unauthorizedFalta el token, está mal escrito, revocado o vencidoCrea un token nuevo y actualiza la configuración. Revisa que haya exactamente un espacio después de Bearer
El servidor conecta y no lista herramientasEl cliente habla con la dirección equivocadaLa URL debe terminar en /mcp
403 wrong_credentialUsaste una llave de ingesta (spk_…)Usa un token de API (sps_…)
Funciona desde tu portátil y no desde un agente en la nubeTu motor no es alcanzable desde alláExpón el motor, o corre el servidor local donde sí lo alcance
Falta resolve_problemEl servidor está en solo lecturaMira Seguridad
Las respuestas son de otra appEl token es de otro proyectoCada token es de un proyecto. Agrega un servidor por proyecto, cada uno con su nombre, por ejemplo sypnia-shop y sypnia-blog

Sigue con

  • Skills: deja que tu agente configure Sypnia y arregle problemas siempre de la misma forma.
  • Ejemplos: tres sesiones, de la pregunta al arreglo.
  • Referencia de herramientas: cada herramienta y lo que devuelve.

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