Conectar Claude Code a Nodary

Antes de empezar

• Claude Code, con sesión iniciada en una cuenta Pro, Max, Team, Enterprise o Console, o usado a través de un proveedor de nube como Amazon Bedrock. El plan gratuito de claude.ai no incluye Claude Code.
• Una cuenta de Nodary. El servidor MCP está en todos los planes; en Free, mientras el espacio de trabajo siga dentro del plan: 1 proyecto, 10 documentos y carpetas, 2 miembros. Claude Code no gasta Cometas: usa su propio modelo.

Añadir Nodary

1. Ejecuta este comando en una terminal:

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

   Copiar
2. Para usar Nodary en todos tus proyectos, añádelo a tu ámbito de usuario:

   claude mcp add --transport http --scope user nodary https://nodary.ai/api/mcp

   Copiar
3. En Claude Code, escribe /mcp, elige nodary e inicia sesión: la página de consentimiento de Nodary se abre en tu navegador. Si no se abre, copia la dirección que muestra Claude Code, o ejecuta:

   claude mcp login nodary

   Copiar

Ámbitos: local, el predeterminado, reserva Nodary para ti en este proyecto; user, para ti en todos tus proyectos; project escribe .mcp.json en la raíz del proyecto para que lo comparta todo el equipo.

Iniciar sesión y elegir los espacios

La página de consentimiento de Nodary indica la app que pide acceso y la dirección a la que volverá. Inicia sesión si hace falta y elige los espacios de trabajo a los que Claude Code podrá llegar: con un solo espacio, lo seleccionas; con varios, ninguno viene marcado, así que marca cada uno que Claude Code pueda usar. Si iniciaste sesión hace más de 10 minutos, Nodary vuelve a pedirte la contraseña. Aprueba, y el navegador te devuelve a Claude Code.

Claude Code actúa entonces como tú: ve y cambia solo lo que tu rol permite, en los espacios marcados. Su acceso dura 60 minutos cada vez y Claude Code lo renueva solo.

Usar Nodary desde la terminal

Pide las cosas con tus palabras. Claude Code llama a las herramientas de Nodary cuando tu petición las necesita y pregunta antes de usarlas, salvo que las hayas permitido. Algunas peticiones para empezar:

• Lee el documento de diseño de la API en Nodary y comprueba este endpoint con él.
• Escribe un registro de decisión sobre el paso a Postgres, guárdalo en Arquitectura y enlázalo con la especificación.
• ¿Qué documentos del proyecto Backend siguen siendo borradores y quién es su responsable?

Con una clave de API en su lugar

Envía tu clave en un encabezado:

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

Para compartir el servidor en .mcp.json sin compartir una clave, léela de una variable de entorno: Claude Code sustituye ${NODARY_API_KEY} en los encabezados de un servidor.

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

Crea la clave en Nodary, en Perfil, Claves de API y MCP. Empieza por gdc_, se muestra una sola vez, actúa con tus permisos, puede limitarse a un proyecto y caduca a los 30, 90 o 365 días, o nunca, como elijas.

Si algo no funciona

• claude mcp add no comprueba una clave: una incorrecta aparece como servidor fallido en /mcp.
• Para volver a iniciar sesión, elige Clear authentication en el menú /mcp, o ejecuta claude mcp logout nodary, y vuelve a iniciar sesión.
• Un documento largo llega cortado: Claude Code avisa por encima de 10.000 tokens de salida de herramienta y se detiene en 25.000 por defecto. Sube el límite con la variable de entorno MAX_MCP_OUTPUT_TOKENS, o pide una sola sección.
• El inicio de sesión no termina: conéctate con una clave de API, como arriba.
• Que una primera petición reciba la respuesta 401 es normal: le dice al cliente dónde iniciar sesión.
• quota_locked: el espacio de trabajo supera el plan Free tras su prueba y queda bloqueado hasta que el propietario se suscribe. Después vuelve a funcionar al instante.
• billing_locked: un pago falló, así que el espacio de trabajo queda bloqueado hasta que el propietario lo resuelva en la facturación del espacio. Vuelve a funcionar en cuanto se cobra el pago.
• workspace_suspended: Nodary ha suspendido el espacio de trabajo y nada llega a él, ni siquiera los agentes. El propietario puede escribir a support@nodary.ai.
• workspace_required: la conexión llega a varios espacios de trabajo, así que indica en cuál trabajar, o vuelve a conectar marcando solo uno.

Preguntas

Sigue leyendo