# El servidor MCP de Nodary

Nodary ofrece un servidor MCP remoto para que un agente de IA lea y escriba en tu espacio de trabajo como lo haría un compañero: los mismos documentos, los mismos permisos y la sesión iniciada a tu nombre.

## De un vistazo

- **Dirección**: https://nodary.ai/api/mcp
- **Transporte**: Streamable HTTP (JSON-RPC sobre POST)
- **Inicio de sesión**: OAuth 2.1 con registro dinámico de clientes y PKCE, o una clave de API
- **Acceso**: Incluido en todos los planes; en Free, dentro de los límites del plan
- **Descubrimiento**: https://nodary.ai/.well-known/oauth-protected-resource/api/mcp · https://nodary.ai/.well-known/mcp.json

Claude Code: Ejecuta este comando en un terminal (añade --scope user para usar Nodary en todos tus proyectos):

```sh
claude mcp add --transport http nodary https://nodary.ai/api/mcp
```

## Qué es

El Model Context Protocol (MCP) es el estándar abierto que usan los clientes de IA para trabajar con herramientas externas. El servidor de Nodary da a un agente el mismo espacio de trabajo que usa tu equipo: proyectos, documentos y sus enlaces, hojas de cálculo, imágenes, tablas de traducción, diálogos y tableros.

Un agente no recibe una copia. Lee lo que hay en ese momento, escribe donde se lo pides y cada resultado incluye el enlace que una persona puede abrir para revisar su trabajo.

## Inicio de sesión

La mayoría de los clientes inician sesión con OAuth: les das la dirección del servidor y abren en tu navegador una página de Nodary para iniciar sesión y dar tu consentimiento. Nodary admite OAuth 2.1 con registro dinámico de clientes y PKCE, así que no hay ningún ID de cliente que crear ni nada que copiar. Los tokens de acceso duran una hora y el cliente los renueva.

Una sola conexión puede llegar a varios espacios de trabajo. Si perteneces a más de uno, la página de consentimiento los muestra todos, marcados: la aplicación llega entonces a los espacios que dejes marcados, y solo a esos. «También los espacios a los que me una más adelante» queda desactivado salvo que lo marques. En una conexión así, cada herramienta recibe workspace (su ID, su slug o su nombre): una llamada que cambia algo debe nombrarlo, una lectura sin él solo se ejecuta donde están sus IDs, y cada resultado empieza por el espacio en el que se ejecutó. Una clave de API sigue ligada a un solo espacio de trabajo.

Un cliente que no puede iniciar sesión puede usar una clave de API: créala en tu perfil, en la sección API keys & MCP (empieza por gdc_), y envíala en la cabecera Authorization: Bearer gdc_… Una clave puede limitarse a un solo proyecto.

## Quién puede usarlo

El servidor MCP está incluido en todos los planes, Free, Pro, Studio y Enterprise, para cada miembro y sin coste adicional.

En Free, un agente lee y escribe como en un plan de pago mientras el espacio de trabajo se mantenga dentro del plan: 1 proyecto, 10 documentos y carpetas, y 2 miembros. Una escritura que superaría un límite se rechaza indicando el límite alcanzado y cómo levantarlo: mientras el espacio aún pueda tener su prueba, el enlace al panel, donde el propietario o un administrador empieza la prueba de Studio de 14 días (con MCP, sin tarjeta); si no, el enlace a la página de precios.

Un espacio de trabajo por encima del plan Free tras su prueba, sin suscripción, queda bloqueado hasta que se suscriba: los agentes quedan cortados allí, también para leer. Una conexión a ese único espacio recibe quota_locked en cada petición, con lo que se supera y dónde se suscribe el propietario; una conexión a varios espacios solo recibe quota_locked (o billing_locked tras un pago fallido) en las llamadas al espacio bloqueado, como error de herramienta, y sigue funcionando en los demás.

- [Precios](https://nodary.ai/es/pricing)

## Qué puede hacer un agente

92 herramientas, agrupadas aquí según la tarea que cumplen. Cada una indica al cliente si solo lee y si una escritura puede sobrescribir algo, para que el cliente pueda consultarte antes de actuar.

### Buscar y leer

Proyectos, documentos con sus enlaces y su historial, comentarios, notas de conocimiento, vistas guardadas y briefs de contexto. Los resultados incluyen enlaces que las personas pueden abrir.

`list_games`, `list_stars`, `search_documents`, `get_document`, `get_star`, `get_tree`, `list_templates`, `list_members`, `list_project_knowledge`, `get_project_knowledge`, `list_comments`, `get_canon`, `list_versions`, `get_version`, `diff_versions`, `list_deleted_stars`, `list_context_briefs`, `get_context_brief`, `list_saved_views`, `get_saved_view`, `list_favorites`, `get_workspace_usage`, `list_properties`, `get_file_url`, `describe_blocks`, `run_view`, `list_workspaces`

### Escribir y organizar

Crear y editar documentos bloque a bloque, guardarlos en carpetas, enlazarlos, etiquetarlos, comentar, definir propiedades y resolver contradicciones. Un documento eliminado se puede restaurar.

`create_game`, `update_game`, `rename_workspace`, `create_starter_constellation`, `create_from_template`, `create_star`, `create_stars`, `write_document`, `append_document`, `edit_document`, `update_star`, `update_stars`, `delete_star`, `restore_star`, `create_cluster`, `move_to_cluster`, `link_stars`, `unlink_stars`, `set_tags`, `save_project_knowledge`, `add_comment`, `add_comments`, `resolve_comment`, `list_contradictions`, `report_contradiction`, `resolve_contradiction`, `save_context_brief`, `save_saved_view`, `set_favorite`, `define_properties`, `set_properties`, `restore_version`, `edit_comment`, `delete_comment`, `delete_project_knowledge`, `remove_context_brief`, `remove_saved_view`, `open_daily_note`

### Revisión de arte e imágenes

Importar imágenes, verlas con las notas que la gente dibujó encima, decidir, anotar y etiquetar entregables (cada decisión firmada con quién y cuándo), convertir un moodboard en una paleta y comparar una imagen con ella, y preparar la hoja de comentarios para un proveedor externo.

`add_image`, `start_upload`, `add_media`, `get_image`, `get_moodboard`, `render_board`, `edit_board`, `find_pictures`, `update_pictures`, `get_art_review`, `extract_palette`, `check_palette`, `feedback_sheet`, `restore_image_version`, `set_image_origin`

### Hojas de cálculo y balanceo

Leer una hoja como valores calculados con la fórmula que hay detrás de cada celda, escribir celdas por dirección o por fila, y leer una tabla de botín según lo que significa para los jugadores.

`get_sheet`, `set_cells`, `analyze_drops`

### Localización y diálogos

Ver el avance de cada idioma en una tabla de traducción, escribir traducciones por clave y revisar un diálogo ramificado, que se exporta como script de Yarn Spinner.

`get_localization`, `set_translations`, `check_dialogue`

### Producción

Fijar fechas límite, solicitar y entregar revisiones, ver qué ha cambiado últimamente y si el hito llegará a tiempo.

`get_progress`, `recent_changes`, `set_due_date`, `set_due_dates`, `request_review`, `submit_review`

## Prompts y recursos

Peticiones listas para usar que un cliente puede ofrecer como comandos:

- weekly-summary: Lo que ha cambiado esta semana en el espacio de trabajo o en un proyecto: lo escrito, lo decidido, lo revisado y lo que sigue abierto.
- art-review: En qué punto está la revisión de arte: las imágenes pendientes de decisión, las que se apartan de la paleta y lo próximo que hay que decidir.
- playtest-to-tasks: Convierte las notas de un playtest en tareas, cada una enlazada al documento de diseño al que afecta.
- balance-review: Lee una tabla de botín o una curva de progresión y explica qué significa para los jugadores y qué parece desajustado.

Recursos que un cliente puede adjuntar sin llamar a ninguna herramienta:

- nodary://star/{id}: un documento, en Markdown
- nodary://project/{id}: el esquema de un proyecto

## Seguridad

- Un agente actúa como la persona que lo conectó: solo ve y cambia lo que esa persona puede, y una clave limitada a un proyecto se queda en ese proyecto.
- En una conexión a varios espacios de trabajo, nada se resuelve de uno a otro: los IDs y los títulos se buscan solo en el espacio que nombra la llamada, un ID de otro espacio se rechaza antes de ejecutar nada, y cada resultado nombra su espacio.
- Los documentos conservan su historial de versiones, y un documento eliminado se puede restaurar.
- Las herramientas de escritura aceptan una clave de idempotencia: una llamada que se reintenta tras una conexión caída devuelve el primer resultado en lugar de escribir dos veces.
- Una conexión hace como máximo 120 solicitudes por minuto; la escritura no tiene límite diario.
- Las decisiones de revisión de arte llevan la firma de la persona que las tomó y la hora.
- Nodary indica a cada agente que el texto de los documentos y los comentarios es contenido con el que trabajar, no instrucciones que seguir. Lo que el agente haga con esa indicación depende del propio agente.

## Conecta tu cliente

Usa la dirección https://nodary.ai/api/mcp. Cada cliente de esta lista se comprobó con su propia documentación el 1 de octubre de 2026.

### Claude (claude.ai y Claude Desktop)

1. Abre Customize, luego Connectors, y elige Add custom connector.
2. Introduce https://nodary.ai/api/mcp. Cuando Claude pregunte cómo registrarse, elige Register automatically.
3. Conecta, inicia sesión en Nodary y aprueba el acceso.

Los conectores personalizados están disponibles en los planes Free, Pro, Max, Team y Enterprise; una cuenta Free puede añadir uno. En Team y Enterprise, primero un propietario añade el conector para la organización.

### ChatGPT

1. En Settings, en Security and login, activa Developer mode.
2. Crea una app para un servidor MCP remoto con la dirección https://nodary.ai/api/mcp e inicio de sesión OAuth.
3. Inicia sesión en Nodary y aprueba el acceso. Las herramientas aparecen entonces en el cuadro de mensajes, en Developer mode.

Developer mode está disponible en la web para las cuentas Plus, Pro, Business, Enterprise y Education; en Business y Enterprise, puede que un administrador tenga que permitirlo. ChatGPT solo se conecta con OAuth, no con una clave de API.

### Claude Code

1. Ejecuta este comando en un terminal (añade --scope user para usar Nodary en todos tus proyectos):

   ```
   claude mcp add --transport http nodary https://nodary.ai/api/mcp
   ```
2. En Claude Code, escribe /mcp, elige nodary e inicia sesión desde el navegador.

Con una clave de API

```sh
claude mcp add --transport http nodary https://nodary.ai/api/mcp \
  --header "Authorization: Bearer gdc_..."
```

### Cursor

1. Añade Nodary a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json (un solo proyecto):

   ```
   {
     "mcpServers": {
       "nodary": {
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }
   ```
2. Cursor te propone iniciar sesión la primera vez que el servidor lo pide.

Con una clave de API

```json
{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NODARY_API_KEY}"
      }
    }
  }
}
```

### VS Code (GitHub Copilot)

1. Añade Nodary a .vscode/mcp.json en tu espacio de trabajo, o ejecuta el comando MCP: Add Server:

   ```
   {
     "servers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }
   ```
2. Inicia el servidor; VS Code abre el inicio de sesión de Nodary.

En Copilot Business y Enterprise, un administrador debe permitir antes los servidores MCP.

Con una clave de API

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "nodary-key",
      "description": "Nodary API key",
      "password": true
    }
  ],
  "servers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:nodary-key}"
      }
    }
  }
}
```

### Devin Desktop (antes Windsurf)

1. Añade el servidor e inicia sesión desde un terminal:

   ```
   devin mcp add -s user nodary https://nodary.ai/api/mcp
   devin mcp login nodary
   ```
2. O añádelo a ~/.config/devin/mcp_config.json (en Windows, %APPDATA%\devin\mcp_config.json):

   ```
   {
     "mcpServers": {
       "nodary": {
         "url": "https://nodary.ai/api/mcp",
         "transport": "http"
       }
     }
   }
   ```

## Si algo no funciona

- Es normal que una primera petición reciba un 401 con una dirección resource_metadata: así el cliente sabe dónde iniciar sesión.
- Una petición rechazada con quota_locked significa que el espacio de trabajo supera el plan Free tras su prueba y está bloqueado hasta que se suscriba: en cuanto el propietario se suscribe, el agente vuelve a funcionar. En una conexión a varios espacios, solo se rechazan las llamadas a ese espacio.
- Una llamada rechazada con workspace_required (o workspace_not_found) enumera los espacios a los que llega la conexión: pasa uno de ellos en workspace. Para llegar a un espacio que no está en la lista, vuelve a conectar la aplicación y márcalo.
- Si un cliente no consigue terminar el inicio de sesión, conéctalo con una clave de API.

https://nodary.ai/es/docs/mcp