GuidesUtiliser Orbit via MCP

Utiliser Orbit via MCP

Connecter Claude, ChatGPT, Claude Code, Cursor ou une autre plateforme compatible au serveur MCP d’Orbit.

Principe

Un client qui prend effectivement en charge le serveur MCP personnalisé, le transport et l’authentification requis peut s’authentifier auprès d’Orbit avec les droits que vous lui accordez, puis lire le contexte de votre Brain (ou y écrire si vous l’autorisez). L’existence du serveur Orbit ne garantit pas que chaque client, version ou abonnement permet la connexion, ni que l’hôte appellera automatiquement les tools.

Copier l’URL du serveur

https://orbit.easyconnector.app/mcp : la même pour tous les clients. Elle est aussi affichée, avec les étapes de chaque client, dans la page MCP d’Orbit (groupe Connexion de la barre latérale).

L’ajouter dans votre client

Si votre client ou abonnement propose l’ajout d’un serveur MCP personnalisé, choisissez cette option et collez l’URL.

  • Claude (claude.ai et l’application) : Personnalisation, puis Connecteurs, puis + et Ajouter un connecteur personnalisé. Nommez-le « Orbit », collez l’URL, validez, puis choisissez Connecter.
  • ChatGPT : Plugins, puis + et Add custom MCP server. Nommez-le « Orbit », collez l’URL, choisissez OAuth, acceptez l’avertissement et validez avec Create. Après une mise à jour d’Orbit, si un nouveau tool n’apparaît pas, ouvrez le connecteur et choisissez Refresh (Actualiser).
  • Claude Code : claude mcp add --transport http orbit https://orbit.easyconnector.app/mcp, puis /mcp, orbit et Authenticate.
  • Cursor : le bouton Ajouter à Cursor de la page MCP d’Orbit, ou l’entrée orbit avec la seule url dans mcp.json.

La disponibilité et l’emplacement des réglages varient selon le client, son offre et les réglages de votre administrateur ; ne considérez pas ces libellés comme un test de bout en bout réussi pour votre cas. Le détail de chaque client est dans la référence MCP.

Choisir les accès dans Orbit

Si le client prend en charge OAuth MCP, il ouvre la page d’autorisation d’Orbit : une carte compacte avec le logo Orbit, le nom du client, le compte concerné et l’hôte vers lequel vous reviendrez. Un encart rappelle que n’importe qui peut déclarer une application sous n’importe quel nom : continuez seulement si vous avez lancé la connexion vous-même.

Elle liste chaque accès demandé (« Lire le Brain », « Nourrir le Brain », « Lire les générations Studio »…), que vous pouvez décocher. Sans demande particulière du client, seule la lecture du Brain est proposée. Un accès d’écriture porte le badge Écriture et n’est jamais coché d’avance (« Nourrir le Brain », « Écrire dans le journal d’activité »). Un accès qui peut dépenser vos crédits (« Générer avec Studio », proposé seulement si le client le demande) porte le badge Utilise des crédits.

Cochez ensuite les espaces que ce client pourra utiliser, listés en puces : il ne verra que ceux-là, et un espace créé plus tard demandera une nouvelle autorisation. Choisissez enfin Autoriser l’accès ou Annuler. Si la demande change pendant que la page est ouverte, Orbit affiche « Cette demande a expiré » et n’accorde rien : relancez la connexion depuis le client. Si le client n’implémente pas ce flux, cette procédure ne s’applique pas.

Pour VS Code, vos scripts, votre CI ou une intégration serveur à serveur, utilisez plutôt une clé orb_… dans l’en-tête Authorization. Le Propriétaire du compte la crée dans la page API d’Orbit, avec le formulaire Créer une clé API (il s’ouvre en ligne, sans fenêtre modale) : il coche ses accès et choisit ses espaces ; par défaut, elle ne fait que lire.

Ce que le client peut faire

AccèsScopeTools
Lire le Brainbrain:readbrain_list_spaces, brain_get_profile, brain_get_context, brain_get_context_pack, brain_check_alignment, brain_search, brain_quota, brain_list_nodes, brain_list_proposals, brain_list_skills, brain_get_skill
Nourrir le Brainbrain:writebrain_remember, brain_create_node, brain_update_node, brain_link_nodes, brain_attach_node_resource, brain_propose_change, brain_import_skill, brain_review_proposal
Lire le journal d’activitéactivity:readbrain_list_activity
Écrire dans le journal d’activitéactivity:writebrain_log_activity
Lire les générations Studiostudio:readstudio_get_capabilities, studio_list_generations, studio_get_generation, studio_list_favorites, studio_get_avatar
Lire les créations Studioartifacts:readartifact_list, artifact_get
Générer avec Studiostudio:generatestudio_generate, studio_revise (dépensent vos crédits Orbit)
Gérer les espaces et leurs accèsspaces:managebrain_create_space, brain_update_space, brain_list_space_grants, brain_grant_space, brain_revoke_space : en cours de déploiement, pas encore proposés

Les anciens tools studio_list_projects et studio_get_project n’existent plus. Pour une génération, le projet est facultatif : studio_generate crée sans projet quand projectId est omis. Un client découvre d’abord le catalogue (studio_get_capabilities), vos Favoris (studio_list_favorites) ou vos générations passées (studio_list_generations), puis ne lance une génération payante qu’avec votre accord.

Un usage typique : choisir les espaces autorisés avec brain_list_spaces, vérifier le quota avec brain_quota, demander un Context Pack par intention avec brain_get_context_pack, chercher un détail avec brain_search, et utiliser brain_get_context seulement lorsqu’un contexte déterministe d’espace est réellement souhaité. Un agent de code peut consigner ce qu’il a fait avec brain_log_activity (entrée en ajout seul, qui n’alimente jamais le contexte) ; vous relisez ce journal dans Orbit, page Brain → Activité des agents, ou avec brain_list_activity.

Chaque client OAuth connecté apparaît dans la page MCP d’Orbit, carte Applications connectées, où vous pouvez le déconnecter à tout moment : ses jetons cessent de fonctionner aussitôt.

La liste complète des tools, le détail d’OAuth, les limites et les erreurs sont dans la référence MCP. Le serveur suit la révision 2026-07-28 de la spécification MCP et reste compatible avec les clients en 2025-11-25. La gestion des espaces par MCP ou API (créer, renommer, partager) est en cours de déploiement et n’est pas encore ouverte par défaut.

Écritures

brain_remember ajoute directement une mémoire dans un espace. brain_propose_change et brain_import_skill ne font que proposer : rien ne change tant que vous n’avez pas approuvé la proposition dans Orbit, page Propositions à valider ; un client peut refuser une proposition, jamais l’approuver à votre place. Il n’existe aucun tool de suppression directe. L’écriture demande un accès séparé (« Nourrir le Brain ») que vous pouvez refuser : le client reste alors en lecture seule. Chaque mémoire ajoutée compte dans la capacité de votre Brain ; quand elle est pleine, rien n’est écrit. Le journal d’activité est un registre à part : il ne devient jamais une mémoire.

Lectures incluses

brain_get_profile, brain_get_context, brain_get_context_pack, brain_check_alignment et brain_search comptent chacun pour une lecture du quota mensuel de votre abonnement (3 000 par tranche de 120 CU, partagé avec l’API). Rien n’est facturé à l’usage : une fois le quota épuisé, le client reçoit l’erreur quota_exceeded jusqu’au renouvellement mensuel, ou jusqu’à l’ajout de capacité. Le journal d’activité et les autres tools ne comptent pas. Détails dans la référence MCP.

MCP est une interface d’accès à Orbit. La mémoire reste indépendante du protocole : les mêmes lectures et écritures sont disponibles via l’API REST.

Ces tools existent côté Orbit, chacun derrière son accès. Cela ne garantit pas que votre client les appelle tous correctement : vérifiez-le avec votre client. La référence MCP fait autorité pour les tools appelables.