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. Hoy funciona un servidor piloto por marca con cuatro herramientas de lectura y clientes autorizados uno a uno. El servidor único multimarca descrito aquí se activa en la fase «Registro y MCP».

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.

{
  "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.

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 y outputSchema; la salida va en structuredContent y también como texto JSON para clientes antiguos.
• 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.
• Escrituras que piden confirmación devuelven input_required con un resumen; el cliente pregunta a la persona y reintenta con su respuesta.
• Tareas largas (imágenes) devuelven una tarea que el cliente sigue con tasks/get.

Recursos y prompts

• nomad://brand/{brand}/genome, /kit y /soul: la marca como contexto que otro agente puede leer.
• Prompts brand-brief, brand-voice y weekly-review para empezar bien una conversación.