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.
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.
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.
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.
Tu cuenta › Desarrolladores y pulsa «Nuevo 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_…"
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.
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.
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.
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.
En tu cliente, añade un conector o servidor MCP remoto con esta dirección:
https://app.nomad.ooo/api/mcp
Autoriza en la pantalla de Nömad que se abre y elige a qué marcas llega.
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 (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.
Actualizado el 16 de noviembre de 2026