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):

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

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)

Abre Customize, luego Connectors, y elige Add custom connector.
Introduce https://nodary.ai/api/mcp. Cuando Claude pregunte cómo registrarse, elige Register automatically.
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

En Settings, en Security and login, activa Developer mode.
Crea una app para un servidor MCP remoto con la dirección https://nodary.ai/api/mcp e inicio de sesión OAuth.
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

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
```
En Claude Code, escribe /mcp, elige nodary e inicia sesión desde el navegador.

Con una clave de API

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

Cursor

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"
    }
  }
}
```
Cursor te propone iniciar sesión la primera vez que el servidor lo pide.

Con una clave de API

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

VS Code (GitHub Copilot)

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"
    }
  }
}

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

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

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

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.