Servidor MCP

Nömad tiene un único servidor MCP para todas tus marcas en https://app.nomad.ooo/api/mcp. Al conectarlo eliges qué marcas y qué alcances concedes; las herramientas son las mismas capacidades que usa Nödo.

Estado. Disponible para clientes autorizados uno a uno. Un único servidor en /api/mcp con una sola conexión para todas las marcas que abras en el consentimiento; sus herramientas salen del registro y reciben brand. La ruta antigua por marca sigue funcionando.

Catálogo progresivo. La lista de herramientas trae las capacidades principales; todo lo demás que se puede hacer en Nömad (cada acción de cada pantalla) se encuentra con nomad_find (busca por lo que quieres hacer), se lee con nomad_describe (entrada, salida, permiso y si espera aprobación) y se ejecuta con nomad_call, por la misma puerta de permisos y la misma política de agentes. Así la lista no crece con la app y el agente siempre ve el contrato vigente.

Conectar

• Claude: Ajustes › Conectores › Añadir conector personalizado, pega la URL y autoriza.
• ChatGPT: Ajustes › Apps y conectores › Crear, pega la URL y autoriza.
• Cursor, VS Code y otros clientes: añade un servidor remoto HTTP con la URL; el cliente abre el consentimiento de Nömad.

Clientes admitidos desde el primer día: Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT (chatgpt.com, ChatGPT desktop), Cursor (Cursor editor), Visual Studio Code (GitHub Copilot agent mode). Otros clientes se añaden tras revisarlos.

{
  "mcpServers": {
    "nomad": { "url": "https://app.nomad.ooo/api/mcp" }
  }
}

Autorización

• OAuth 2.1 con PKCE sobre Supabase Auth (OAuth 2.1 + PKCE). El servidor publica sus metadatos de recurso protegido (RFC 9728) y responde 401 con WWW-Authenticate para que el cliente descubra dónde autorizar.
• El token va siempre en la cabecera Authorization y tiene como audiencia este servidor (RFC 8707); tokens de otra audiencia se rechazan y nunca se reenvían a terceros.
• Si una herramienta necesita un alcance que no concediste, la respuesta es 403 insufficient_scope con todos los alcances necesarios a la vez.
• En el consentimiento eliges marcas y alcances; puedes revocarlo en Ajustes › MCP.
• Leer siempre se puede, dentro del consentimiento. Lo que un agente cambia lo decide la política de agentes de la marca (Ajustes › Nödo › Agentes externos, o el workspace › Desarrolladores): Solo consultar, Con aprobación (por defecto: cada cambio espera en tu cuenta › Aprobaciones y te avisamos) o Directo. Borradores, ideas y peticiones de revisión no esperan: ya dejan la decisión a una persona.
• Lo crítico nunca es de un agente, diga lo que diga la política: borrar para siempre, publicar, envíos masivos, cobros y roles críticos responden agent_write_blocked.

Protocolo

• Revisión 2026-07-28, sin sesión: cada petición es independiente y el servidor implementa server/discover.
• Nombres de herramienta con guion bajo (works_list), válidos en todos los clientes y en voz.
• Cada herramienta declara inputSchema; la salida va en structuredContent y también como texto JSON para clientes antiguos. El esquema de salida de cada herramienta está en esta referencia y no viaja en tools/list, para no gastar contexto del modelo en cada turno; el servidor valida cada respuesta contra él.
• Límites: 240 peticiones por minuto por conexión (persona y cliente) y 20 tokens fallidos por minuto por dirección; al pasarse, 429 con Retry-After. Un resultado de más de 25.000 tokens se rechaza con result_too_large: pide menos elementos, el formato conciso o la página siguiente con cursor.
• Anotaciones: readOnlyHint en lecturas, destructiveHint en lo que borra o desconecta, idempotentHint y openWorldHint cuando sale de Nömad. Son pistas para el cliente, no la seguridad: esa la pone la puerta de permisos.
• Errores de negocio con isError: true y un mensaje que el modelo puede usar para corregir; errores de protocolo como JSON-RPC.
• Listas paginadas con cursor opaco y orden determinista.
• Una escritura que espera aprobación no es un error: la herramienta responde structuredContent.status = "approval_required" con el enlace donde la persona decide. El agente lo dice y no la repite; se ejecuta una sola vez cuando se aprueba.
• Tareas largas (imágenes) devuelven una tarea que el cliente sigue con tasks/get.

Recursos y prompts

• Recurso nomad://brand/{brand}/genome: el resumen del Genoma que otro agente puede leer, en las conexiones de una sola marca con permiso genome.read.
• Prompt brand-brief para preparar un brief con el contexto permitido de la marca.