Connecter Cursor à Nodary

Avant de commencer

• L’application de bureau Cursor. La page de tarifs de Cursor ne précisait pas quelles offres incluent les serveurs MCP lors de notre vérification ; sur Enterprise, les administrateurs contrôlent l’accès MCP, et une équipe peut tenir une liste de serveurs autorisés.
• Un compte Nodary. Le serveur MCP est inclus dans toutes les offres ; sur Free, tant que l’espace reste dans les limites de l’offre : 1 projet, 10 documents et dossiers, 2 membres. Cursor ne dépense aucune Comète : il utilise son propre modèle.

Ajouter Nodary à mcp.json

1. Ouvrez ~/.cursor/mcp.json dans votre dossier personnel (Nodary dans tous les projets) ou .cursor/mcp.json dans un projet (ce projet seulement) et ajoutez le serveur :

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

   Copier
2. Ouvrez « Customize » dans la barre latérale de Cursor, trouvez nodary parmi les serveurs MCP, activez-le et connectez-vous quand Cursor le demande : la page de consentement de Nodary s’ouvre dans votre navigateur.
3. Approuvez l’accès. Cursor liste alors les outils de Nodary comme disponibles.

Partager le fichier : un .cursor/mcp.json versionné dans le dépôt donne le même serveur à toute l’équipe ; chacun se connecte toujours avec son propre compte. Ne versionnez jamais une clé d’API.

Se connecter et choisir les espaces

La page de consentement de Nodary indique l’application qui demande l’accès et l’adresse vers laquelle elle sera renvoyée. Connectez-vous si ce n’est pas déjà fait, puis choisissez les espaces que Cursor pourra atteindre : avec un seul espace, vous le sélectionnez ; avec plusieurs, aucun n’est coché d’avance, cochez donc chacun de ceux que Cursor pourra utiliser. Si vous vous êtes connecté il y a plus de 10 minutes, Nodary vous redemande votre mot de passe. Approuvez, et le navigateur vous ramène à Cursor.

Cursor agit alors en votre nom : il voit et modifie seulement ce que votre rôle permet, dans les espaces cochés. Son accès dure 60 minutes à la fois et Cursor le renouvelle seul.

Utiliser Nodary depuis l’agent

Formulez votre demande simplement. Cursor utilise les outils de Nodary quand votre demande en a besoin et, par défaut, demande votre accord avant d’en lancer un. Quelques demandes pour commencer :

• Lis le document de conception de l’API dans Nodary et vérifie ce point d’accès par rapport à lui.
• Rédige un enregistrement de décision pour le passage à Postgres, range-le dans Architecture et relie-le à la spécification.
• Quels documents du projet Backend sont encore des brouillons, et qui en est responsable ?

Avec une clé d’API à la place

Placez votre clé dans la variable d’environnement NODARY_API_KEY et envoyez-la dans un en-tête ; Cursor lit ${env:NODARY_API_KEY} dans votre environnement :

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

Créez la clé dans Nodary, sous « Profil », « Clés d’API et MCP ». Elle commence par gdc_, ne s’affiche qu’une fois, agit avec vos droits, peut être limitée à un projet et expire après 30, 90 ou 365 jours, ou jamais, selon votre choix.

Si quelque chose ne fonctionne pas

• Les outils de Nodary n’apparaissent pas : ouvrez « Customize » et vérifiez que nodary est activé, puis lisez les erreurs dans le panneau « Output », sous « MCP Logs ».
• La connexion n’aboutit pas : connectez-vous plutôt avec une clé d’API, comme ci-dessus.
• Une première requête qui reçoit une réponse 401 est normale : elle indique au client où se connecter.
• quota_locked : l’espace dépasse l’offre Free après son essai et reste bloqué jusqu’à ce que le propriétaire s’abonne. Tout refonctionne dès l’abonnement.
• billing_locked : un paiement a échoué, l’espace reste donc bloqué jusqu’à ce que le propriétaire le règle dans la facturation de l’espace. Tout refonctionne dès que le paiement passe.
• workspace_suspended : Nodary a suspendu l’espace, plus rien ne l’atteint, agents compris. Le propriétaire peut écrire à support@nodary.ai.
• workspace_required : la connexion atteint plusieurs espaces, nommez donc celui où travailler, ou reconnectez-vous en ne cochant qu’un espace.

Questions

À lire ensuite