Saltar al contenido

Privacidad y analítica

Utilizamos cookies técnicas necesarias y, solo si das tu consentimiento, analítica y pixels de marketing para mejorar la web y medir campañas.

Política de privacidadPolítica de cookies
Docs
GuíasDesarrolladores
Español
EspañolEnglishFrançaisDeutschItaliano

Empezar a desarrollar

  • Tu primera llamada a la API
  • Límites, versiones y cabeceras

API

  • API de marca

MCP

  • Servidor MCP

Conectores

  • Conectores de una marca
Empezar a desarrollar
Guía4 min de lectura

Tu primera llamada a la API

Crea un token personal, comprueba quién eres con GET /api/v1/me, lista tus marcas y lee sus trabajos; después conecta un agente por MCP.

Abrir en la app
Português
Русский
한국어
日本語
中文
हिन्दी
Abrir la app
Dónde
Tu cuenta › Desarrolladores
En esta página
  • 1. Crea un token personal
  • 2. Comprueba quién eres
  • 3. Lista tus marcas
  • 4. Lee los trabajos de una marca
  • 5. Conecta un agente por MCP
  • Token personal o cuenta de servicio
  • Siguientes pasos

Esta guía te lleva de cero a una llamada que funciona contra tus marcas reales. Sirve para un script, una automatización o una integración que actúe como tú. Si la integración es de la organización y no de una persona, al final verás cuándo usar una cuenta de servicio.

Necesitas una cuenta de Nömad con acceso al menos a una marca, y curl o cualquier cliente HTTP.

1. Crea un token personal

  1. Abre Tu cuenta › Desarrolladores y pulsa «Nuevo token».
  2. Ponle un «Nombre» que te diga dónde lo usas, por ejemplo «Script de informes».
  3. Deja la «Caducidad» en 90 días (recomendado).
  4. En «Qué puede hacer», elige «Solo lectura» para esta guía.
  5. En «Marcas», déjalo vacío para que llegue a todas tus marcas, o elige solo las que necesites.
  6. Pulsa «Crear token» y copia el token con «Copiar token».

Importante

Crear o rotar un token pide haber iniciado sesión hace menos de 10 minutos. Si hace más, el formulario te pide «Confirma que eres tú» (código por correo, contraseña o Google) y conserva lo que habías escrito.

El token completo solo se muestra una vez; Nömad guarda únicamente su huella. Tiene esta forma:

nmu_live_v1_<prefijo 10 hex>_<secreto 64 hex>_<suma de control 8 hex>

Guárdalo en tu gestor de secretos o en una variable de entorno, nunca en el código:

export NOMAD_TOKEN="nmu_live_v1_…"

2. Comprueba quién eres

curl https://app.nomad.ooo/api/v1/me \
  -H "Authorization: Bearer $NOMAD_TOKEN"

La respuesta dice a nombre de quién actúa el token, a qué marcas llega y con qué permisos:

{
  "data": {
    "id": "…",
    "type": "me",
    "attributes": { "profile": { "full_name": "Pegu Jurado", "username": "pegujurado", "locale": "es" } },
    "relationships": { "brands": [{ "id": "…", "type": "brand", "attributes": { "short_id": "BRD-8C1TZA", "name": "Mi marca" }, "membership": { "role": "admin" } }] },
    "credential": { "kind": "personal_token", "name": "Script de informes", "scopes": ["brands:read", "works.read"], "brand_ids": null, "expires_at": "…" }
  }
}

Si recibes 401 unauthenticated, revisa que el token esté completo y siga activo. Cada respuesta lleva X-Request-Id: cítalo si nos escribes.

3. Lista tus marcas

Para recorrer solo las marcas, sin sus miembros:

curl "https://app.nomad.ooo/api/v1/me/brands?limit=50" \
  -H "Authorization: Bearer $NOMAD_TOKEN"

Apunta el short_id (BRD-8C1TZA) o el id de la marca con la que vas a trabajar. Cualquier token puede listar sus marcas, aunque no le hayas dado más permisos.

4. Lee los trabajos de una marca

Cada operación de Nömad es un método: POST a su nombre con la marca y la entrada en el cuerpo.

curl https://app.nomad.ooo/api/v1/works.list \
  -H "Authorization: Bearer $NOMAD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "brand": "BRD-8C1TZA", "status": "active", "limit": 10 }'
{
  "data": {
    "items": [
      { "id": "…", "name": "Identidad visual", "productName": "Identidad visual", "status": "in_progress",
        "statusCategory": "started", "dueDate": null, "progress": { "done": 3, "total": 7 }, "waitingOnBrand": 1 }
    ],
    "nextCursor": null
  }
}

waitingOnBrand cuenta las tareas que esperan a tu marca. Si nextCursor no es null, pásalo como cursor en la siguiente llamada.

Ya tienes una integración que funciona. Para escribir, crea otro token con permisos de cambio en las áreas que necesites y envía Idempotency-Key en cada escritura que puedas reintentar: está explicado en API de marca.

5. Conecta un agente por MCP

Si lo que quieres es que Claude, ChatGPT, Cursor o VS Code trabajen con tus marcas, no necesitas token: se conectan al servidor MCP de Nömad con OAuth.

  1. En tu cliente, añade un conector o servidor MCP remoto con esta dirección:

    https://app.nomad.ooo/api/mcp
    
  2. Autoriza en la pantalla de Nömad que se abre y elige a qué marcas llega.

  3. Pídele algo, por ejemplo «¿Qué trabajos de mi marca esperan algo de mí?».

Consultar siempre puede, con tus permisos. Los cambios siguen la política de agentes de cada marca (solo consultar, con aprobación o directo) y los que esperan tu aprobación te llegan a Tu cuenta › Aprobaciones. Los pasos por cliente están en Servidor MCP y la parte de la marca en Acceso externo.

Token personal o cuenta de servicio

Token personal (nmu_) Cuenta de servicio (nmw_)
Dónde se crea Tu cuenta › Desarrolladores En el workspace, Desarrolladores
Quién lo crea Cualquier persona, para sí misma El propietario o un administrador del workspace
Actúa como Tú, nunca con más permisos que tu rol en cada marca Una identidad de la organización con su propio rol en las marcas
Si quien lo creó se va Deja de llegar a lo que esa persona deja; se revoca si elimina su cuenta Sigue funcionando
Úsalo para Tus scripts y automatizaciones La tienda, el ERP o una integración de la empresa

Crear, limitar, rotar y revocar los dos está en Tokens y cuentas de servicio.

Siguientes pasos

  • Límites, versiones y cabeceras: cuántas llamadas puedes hacer y qué cabeceras leer.
  • Errores: cada código, su estado HTTP y qué hacer.
  • Permisos y roles: qué alcance necesita cada operación.
  • Eventos y webhooks: enterarte de los cambios sin preguntar.

Sigue leyendo

  • Límites, versiones y cabecerasLas cifras exactas de la API y del MCP de Nömad (peticiones por minuto, tamaño del cuerpo, paginación, caducidad y número de tokens) y las cabeceras, la versión y los documentos legibles por máquina.
  • API de marcaMétodos, autenticación, escrituras, idempotencia, paginación y errores.
  • Servidor MCPConectar Claude, ChatGPT o Cursor a tus marcas.
  • Tokens y cuentas de servicioCrear, limitar, rotar y revocar tokens personales y de la organización.

Actualizado el 16 de noviembre de 2026

AnteriorCómo pedir ayudaSiguienteLímites, versiones y cabeceras
¿No encuentras lo que buscas? EscríbenosEscríbenosIr a la app
© 2026 Nömad · Documentación de NömadLinkedInInstagramThreadsFacebookTikTokYouTubeX
Ir a nomad.oooVolver arriba

En esta página

  • 1. Crea un token personal
  • 2. Comprueba quién eres
  • 3. Lista tus marcas
  • 4. Lee los trabajos de una marca
  • 5. Conecta un agente por MCP
  • Token personal o cuenta de servicio
  • Siguientes pasos