Conectar Cursor a Nodary

Antes de empezar

• La app de escritorio de Cursor. La página de precios de Cursor no indicaba qué planes incluyen servidores MCP cuando lo comprobamos; en Enterprise, los administradores controlan el acceso MCP, y un equipo puede mantener una lista de servidores permitidos.
• 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. Cursor no gasta Cometas: usa su propio modelo.

Añadir Nodary a mcp.json

1. Abre ~/.cursor/mcp.json en tu carpeta personal (Nodary en todos los proyectos) o .cursor/mcp.json en un proyecto (solo ese proyecto) y añade el servidor:

   {
     "mcpServers": {
       "nodary": {
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }

   Copiar
2. Abre Customize en la barra lateral de Cursor, busca nodary entre los servidores MCP, actívalo e inicia sesión cuando Cursor lo pida: la página de consentimiento de Nodary se abre en tu navegador.
3. Aprueba el acceso. Cursor muestra entonces las herramientas de Nodary como disponibles.

Compartir el archivo: un .cursor/mcp.json versionado en el repositorio da el mismo servidor a todo el equipo; cada persona sigue iniciando sesión con su propia cuenta. Nunca versiones una clave de API.

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 Cursor podrá llegar: con un solo espacio, lo seleccionas; con varios, ninguno viene marcado, así que marca cada uno que Cursor 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 Cursor.

Cursor 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 Cursor lo renueva solo.

Usar Nodary desde el agente

Pídeselo al agente con tus palabras. Cursor usa las herramientas de Nodary cuando tu petición las necesita y, por defecto, pide tu aprobación antes de ejecutar una. 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

Guarda tu clave en la variable de entorno NODARY_API_KEY y envíala en un encabezado; Cursor lee ${env:NODARY_API_KEY} de tu entorno:

{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env: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

• No aparecen las herramientas de Nodary: abre Customize y comprueba que nodary está activado; luego lee los errores en el panel Output, en MCP Logs.
• 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