Docs

Autenticación

Qué token recibe el servidor MCP, qué permiso necesita, dónde va el token en cada tipo de conexión y cómo cuidarlo.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. El token
  2. Dónde va el token
  3. Mantenlo fuera de tu repositorio
  4. Varios proyectos
  5. Cambiar o revocar un token
  6. Errores
  7. No al lanzar

Motor Nube El servidor MCP usa la misma credencial que la API HTTP: un token de API. No tiene cuenta ni contraseña aparte, y no abre ninguna ventana para iniciar sesión.

El token

TipoToken de API, sps_ y 40 caracteres
Permiso que necesitaread. Nada más
A qué llegaA un proyecto. Un token pertenece exactamente a uno
Dónde crearloSypnia Cloud: en la app, en los ajustes del proyecto. Alojamiento propio: sypnia token create --name "Mi agente" --scopes read, o POST /v1/tokens

read basta para las diez herramientas, incluida resolve_problem: marcar un problema como resuelto es una de las marcas reversibles que un token read puede hacer. Mira los permisos.

No le des a un agente un token con admin. El servidor no lo usa, y el token que queda en la configuración de tu agente se podría usar directo contra la API para revocar llaves o borrar datos. Tampoco uses el token raíz de un motor alojado por ti.

Dónde va el token

ConexiónCómo viaja el token
Servidor remoto (Sypnia Cloud o tu motor)En el encabezado Authorization de cada petición: Authorization: Bearer sps_…
Servidor local (@sypnia/mcp)En la variable de entorno SYPNIA_API_TOKEN. El servidor local lo envía después a la API en el mismo encabezado

El servidor remoto no guarda el token. Lo comprueba con el motor en cada petición y lo usa para leer tu proyecto, igual que lo haría la API.

Mantenlo fuera de tu repositorio

Un token en un archivo subido al repositorio es un token filtrado. Los dos clientes pueden leerlo del entorno.

Claude Code

En un .mcp.json compartido, escribe ${SYPNIA_API_TOKEN} y define la variable en la máquina de cada persona:

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

Un servidor que agregas para ti, sin --scope project, se guarda en tus propios ajustes, no en el repositorio.

Varios proyectos

Un token es un proyecto, así que una conexión es un proyecto. Para trabajar con dos proyectos, agrega el servidor dos veces con dos nombres, cada uno con su token:

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

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

Tu agente ve entonces sypnia-shop.problems y sypnia-blog.problems, y no puede confundirlos.

Cambiar o revocar un token

  1. Crea un token nuevo.
  2. Ponlo en la configuración y reinicia el cliente.
  3. Revoca el anterior: en la app, con sypnia token revoke <id del token>, o con DELETE /v1/tokens/{token_id}.

Un token revocado se rechaza en menos de un minuto. Si un token pudo haberse filtrado, revócalo primero.

Errores

El servidor respondeQué significa
401 unauthorizedNo hay token, o es desconocido, revocado o vencido
403 wrong_credentialSe envió una llave de ingesta (spk_…). El servidor MCP solo recibe tokens de API
403 forbiddenEl token no tiene el permiso read
429 rate_limitedEl token hizo más de 600 peticiones en un minuto. El agente debe esperar y reintentar

No al lanzar

Iniciar sesión por el navegador (OAuth), donde el cliente abre una página y tú apruebas, no está disponible al lanzar. El token en el encabezado es la única forma.

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