DéveloppeursMCP

MCP

Référence du serveur MCP d’Orbit : endpoint, transport, OAuth 2.1, connexion des clients, écran d’autorisation et tools exposés.

Orbit expose un serveur MCP public, servi sur /mcp (l’ancien /api/mcp reste compatible), qui branche votre Brain et Studio sur un client compatible (Claude, ChatGPT, Claude Code, Cursor, vos agents ou toute plateforme tierce). Il peut construire un Context Pack, vérifier l’alignement, organiser le Brain avec des Nodes, proposer des changements que vous validez dans Orbit, consigner et relire ce que font vos agents, parcourir vos générations, créations et Favoris Studio, lire le catalogue des modèles, lancer une génération, suivre son état et relire l’Artifact durable, uniquement dans les accès (scopes) et les espaces que vous lui accordez.

Endpointhttps://orbit.easyconnector.app/mcp (URL canonique ; https://orbit.easyconnector.app/api/mcp reste servie à l’identique pour les connexions existantes)
TransportHTTP, JSON-RPC 2.0 en POST (réponse application/json), sans session
Version du protocolerévision 2026-07-28 de la spécification MCP ; les clients restés en 2025-11-25 sont toujours pris en charge (la version est négociée à l’initialisation)
Nom du serveurOrbit (titre Orbit Brain)
AuthentificationAuthorization: Bearer … : jeton OAuth 2.1 ou clé orb_…
Scopes proposésbrain:read, brain:write, studio:read, studio:generate, artifacts:read, activity:read, activity:write, et spaces:manage quand l’API Spaces est ouverte (voir Scopes)

Le MCP et l’API REST partagent les mêmes credentials et les mêmes capabilities de domaine. Sans scope demandé, OAuth ne propose que la lecture du Brain : brain:read. L’écriture (brain:write, activity:write), la gestion des espaces (spaces:manage) et la génération payante (studio:generate) ne sont jamais accordées implicitement.

Pour une première connexion guidée, suivez MCP ou API : premier test. Cette page conserve la référence détaillée des appels.

Ajouter Orbit dans un client MCP

Le serveur Orbit expose une URL commune : https://orbit.easyconnector.app/mcp. Elle est aussi affichée, avec les étapes de chaque client, dans la page MCP d’Orbit (menu Connexion de la barre latérale). Les exemples ci-dessous sont conditionnels : un client et son abonnement doivent effectivement prendre en charge le serveur MCP personnalisé et l’authentification. Ils ne constituent pas une certification d’intégration de bout en bout pour tous les hôtes, et les libellés d’un client peuvent changer sans que cette page le suive aussitôt.

Valable pour claude.ai et pour l’application Claude (Desktop et mobile). Ouvrez Personnalisation (Customize), puis Connecteurs. Choisissez +, puis Ajouter un connecteur personnalisé. Nommez-le « Orbit », collez l’URL MCP et validez ; si Claude demande un client OAuth, laissez l’enregistrement automatique. Choisissez ensuite Connecter : Claude découvre les métadonnées OAuth d’Orbit et ouvre l’écran d’autorisation d’Orbit (décrit plus bas), où vous choisissez les accès et les espaces accordés, puis revient connecté. Aucune clé à copier. Sur les offres Team et Enterprise, un propriétaire de l’organisation Claude ajoute d’abord le connecteur pour tous ; chaque membre choisit ensuite Connecter.

Écran d’autorisation d’Orbit

Un client OAuth ouvre /oauth/authorize. L’écran est une carte compacte, sur fond noir, qui tient sur un téléphone :

  • En-tête. L’initiale du client, une flèche et le logo Orbit, le titre « [nom du client] veut accéder à votre Orbit », le compte concerné (nom du compte et e-mail du membre connecté) et un encart « App non vérifiée » qui nomme l’hôte de retour : n’importe qui peut déclarer une application sous n’importe quel nom, continuez seulement si vous avez lancé la connexion depuis cet hôte.
  • Accès demandés. Une ligne par accès, avec son libellé et sa description (« Lire le Brain », « Nourrir le Brain », « Lire les générations Studio »…), que vous pouvez décocher. 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é », « Gérer les espaces et leurs accès »). « Générer avec Studio » porte le badge Utilise des crédits : il dépense vos crédits Orbit, comme dans l’application.
  • Lecture seule par défaut. Si le client ne nomme aucun scope, seul « Lire le Brain » est proposé. Le texte sous la liste le rappelle : rien n’est supprimé et aucun crédit Orbit n’est dépensé (sauf génération Studio demandée).
  • Espaces visibles. Les espaces que vous pouvez lire apparaissent en puces, aucune n’est cochée d’avance. Un accès au Brain exige d’en choisir au moins un dès que le compte en a ; un espace créé plus tard demande une nouvelle autorisation. Un espace privé d’un autre membre n’est jamais proposé.
  • Décision. Autoriser l’accès ou Annuler, puis l’hôte vers lequel vous revenez. Annuler, ne cocher aucun accès, ou n’avoir choisi aucun espace alors que le Brain est demandé renvoie au client error=access_denied.

Quand la demande est invalide (lien incomplet, protection PKCE absente, mauvaise adresse de serveur, application inconnue, adresse de retour ou accès non déclarés), l’écran explique la cause en une phrase, précise que rien n’a été accordé et renvoie vers Orbit. Si la demande a changé pendant que la page était ouverte (par exemple un autre compte s’est connecté entre-temps), l’écran affiche « Cette demande a expiré » : relancez la connexion depuis le client. Un code d’autorisation, une fois émis, n’est valable que 10 minutes.

Tools exposés

Cette liste est la référence canonique, relue contre le registre des tools du serveur. La réponse de tools/list contient trente-deux tools aujourd’hui ; les cinq tools de l’API Spaces, marqués « en cours de déploiement », s’y ajoutent (trente-sept) quand cette API est ouverte. Tant qu’elle ne l’est pas, ils n’apparaissent pas dans tools/list et les appeler répond « Unknown MCP tool. ». Chaque tool déclare son scope OAuth (securitySchemes) et ses annotations : readOnlyHint, idempotentHint (vrai pour toute lecture et pour les écritures marquées idempotentes), openWorldHint: false, et destructiveHint, vrai pour brain_review_proposal et brain_revoke_space. Les descriptions sont en anglais : leur lecteur est un LLM.

Les anciens tools studio_list_projects et studio_get_project n’existent plus : un client qui les appelle reçoit « Unknown MCP tool. ». Pour retrouver une génération ou une création, utilisez studio_list_generations et artifact_list.

ToolRôleScopeTypeDisponibilité
brain_list_spaceslister les espaces que ce credential peut lirebrain:readlecturepar défaut
brain_get_profilepetit Context Pack de départ (profil durable)brain:readlecture, compte une lecturepar défaut
brain_get_contextcontexte d’un espace, prêt pour un prompt (compatibilité Memory)brain:readlecture, compte une lecturepar défaut
brain_get_context_packContext Pack sourcé pour une intention, sur un ou plusieurs espacesbrain:readlecture, compte une lecturepar défaut
brain_check_alignmentpréflight evidence-first avant une action ou un brouillonbrain:readlecture, compte une lecturepar défaut
brain_searchchercher des mots dans les mémoiresbrain:readlecture, compte une lecturepar défaut
brain_rememberajouter une mémoire (écriture directe, compatibilité pilier)brain:writeécriturepar défaut
brain_propose_changeproposer un changement que vous validez dans Orbitbrain:writeécriture, idempotentpar défaut
brain_list_proposalslister les propositions d’un espacebrain:readlecturepar défaut
brain_review_proposalrefuser une proposition (l’approbation se fait dans Orbit)brain:writeécriture, destructifpar défaut
brain_import_skilldéposer une Skill portable en propositionbrain:writeécriture, idempotentpar défaut
brain_list_skillslister les Skills approuvées d’un espacebrain:readlecturepar défaut
brain_get_skilllire une Skill versionnée (manifeste et fichiers)brain:readlecturepar défaut
brain_quotalectures incluses restantes et stockagebrain:readlecturepar défaut
brain_log_activityconsigner le travail d’un agent (ajout seul)activity:writeécriturepar défaut
brain_list_activityrelire le journal d’activité des agentsactivity:readlecturepar défaut
brain_list_nodeslire les Nodes et Edges d’un espacebrain:readlecturepar défaut
brain_create_nodecréer un Nodebrain:writeécriturepar défaut
brain_update_nodemodifier un Nodebrain:writeécriturepar défaut
brain_link_nodesrelier deux Nodes du même espacebrain:writeécriture, idempotentpar défaut
brain_attach_node_resourcerattacher une ressource du Brain à un Nodebrain:writeécriture, idempotentpar défaut
brain_create_spacecréer un espacespaces:manageécriture, idempotenten cours de déploiement
brain_update_spacerenommer, décrire ou changer la visibilité d’un espacespaces:manageécriture, idempotenten cours de déploiement
brain_list_space_grantslister qui atteint un espacespaces:managelectureen cours de déploiement
brain_grant_spacedonner l’accès à un espacespaces:manageécriture, idempotenten cours de déploiement
brain_revoke_spaceretirer l’accès à un espacespaces:manageécriture, idempotent, destructifen cours de déploiement
studio_list_generationsparcourir l’historique de vos générations Studiostudio:readlecturepar défaut
artifact_listparcourir vos créations Studio durablesartifacts:readlecturepar défaut
studio_get_capabilitiescatalogue des modèles et modes, formats, limites et estimations de prixstudio:readlecturepar défaut
studio_list_favoritesparcourir vos Favoris (avatars et références enregistrés)studio:readlecturepar défaut
studio_get_avatarlire un avatar enregistré et sa planche d’identitéstudio:readlecturepar défaut
studio_canvas_getlister vos graphes Canvas, ou en lire un avec ses modifications proposéesstudio:readlecturepar défaut
studio_canvas_proposeproposer un lot de modifications d’un graphe Canvas, à relire dans Orbit (gratuit)studio:generateécriture, idempotentpar défaut
studio_generatelancer une génération (payante)studio:generateécriture, idempotentpar défaut
studio_get_generationlire l’état et le résultat d’une générationstudio:readlecturepar défaut
studio_reviseréviser une image (upscale ou variation, payante)studio:generateécriture, idempotentpar défaut
artifact_getlire une création Studio et sa lignéeartifacts:readlecturepar défaut

Chaque tool répond avec content (texte) et structuredContent (JSON). Une erreur d’argument ou de domaine est un résultat isError: true dont structuredContent.error.code est stable : invalid_params, not_found, no_space, space_required, capacity_full, activation_required, quota_exceeded, forbidden, parent_invalid, member_inactive, invalid_skill, secret_refused, rate_limited. Les tools de propositions renvoient aussi les refus du domaine (invalid, notAllowed, notFound, idempotencyConflict, alreadyReviewed, inProgress, approvalRequiresOrbit). Un espace ou un projet d’un autre compte, un espace privé d’un autre membre ou un espace hors de la liste autorisée du credential répond not_found, exactement comme un identifiant inconnu.

Les anciens endpoints/Tools de Memory exposent encore les cinq rôles IDENTITY, GUIDELINES, KNOWLEDGE, ITEMS, PEOPLE pour compatibilité. Ils sont legacy et ne doivent pas structurer une nouvelle intégration. Le graphe utilisateur flexible est exposé par brain_list_nodes et les Tools Node ; le Context Pack n’exige pas qu’un Segment ou Fact appartienne à un pilier. Voir Brain : espaces, Nodes et mémoires.

Quota de 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 (UTC) de votre abonnement : 3 000 lectures par tranche de 120 CU, partagées avec l’API REST. Les autres tools (dont brain_quota), et une lecture qui échoue, ne comptent pas. Rien n’est facturé à l’usage.

  • Quota épuisé : résultat isError: true avec structuredContent.error = { code: "quota_exceeded", status: 402, limit, used, resetsAt } ; le message donne la date du renouvellement et la sortie (ajouter des pas de +60 CU à l’abonnement).
  • Orbit pas encore activé sur le compte : activation_required (status: 402) ; brain_remember répond la même erreur, rien n’est écrit.

brain_list_spaces

Liste les espaces du compte que ce credential peut lire (voir Restriction par espace). Entrée : aucun argument.

{
  "spaces": [
    { "id": "…", "name": "Ma marque", "template": "brand", "templateLabel": "Marque", "memories": 12, "cu": 38 }
  ],
  "capacity": { "usedCu": 38, "capacityCu": 120 }
}

brain_get_context

Le contexte d’un espace, prêt à injecter dans un prompt.

ArgumentTypeRôle
spaceIdchaîne, facultatifl’espace à lire ; facultatif si le compte n’a qu’un espace
pillarstableau de rôles, facultatifseulement ces piliers (défaut : les cinq)
maxCharsentier de 1 000 à 100 000, défaut 12 000longueur maximale du texte context

Sortie : space (id, name, template, templateLabel), pillars[] (role, label, note, memories[]), context (texte), maxChars, truncated, omittedMemories.

Sans spaceId : si le compte a plusieurs espaces, l’erreur space_required liste leurs ids ; s’il n’en a aucun, no_space. Le texte context ne dépasse jamais maxChars : piliers dans l’ordre des rôles, mémoires de la plus ancienne à la plus récente, une mémoire imbriquée juste après son parent. Chaque mémoire gardée garde son titre ; les corps longs sont raccourcis équitablement ; si même les titres ne tiennent pas, les dernières mémoires sont omises avec une note.

brain_get_context_pack

Construit le meilleur paquet de contexte pour une intention, sur un ou plusieurs Spaces autorisés.

ArgumentTypeRôle
taskchaîne, 1 à 8 000 caractèresl’intention, la tâche ou la question à servir
spaceIdstableau de chaînes, 32 au plus, facultatifseulement ces Spaces ; omis = tous les Spaces que ce credential peut lire
asOfdate/heure ISO, facultatifcoupe historique : ne livre pas un Fact avant qu’Orbit puisse le connaître
maxCharsentier de 1 000 à 100 000, facultatifbudget caractères
maxCuentier ≥ 1, facultatifbudget de sélection en CU ; ce n’est pas une facturation

Le pack récupère des Memories et des Segments, fusionne les listes lexicales/sémantiques/structurelles/graphe par RRF pondérée, puis reranke un ensemble borné lorsque le provider est disponible. Tous les candidats passent par les mêmes gates de provenance, temporalité et budget.

La sortie porte notamment fragments[] de type memory ou segment, memoryId/segmentId lorsque pertinent, factIds, les références d’Evidence (sourceId, snapshotId, evidenceId, locator et rôle), whyIncluded, les contradictions non résolues sélectionnées, budget, retrieval, diagnostics, engineVersion et degraded.

retrieval expose l’état réel des couches lexical, segments, structural, semantic, indexing, graph, fusion et rerank. Si une couche optionnelle est indisponible, le pack reste exploitable mais degraded l’annonce : aucun fallback n’est silencieux.

brain_get_profile

Un petit Context Pack de départ, indépendant de la tâche : identité durable, préférences, directives approuvées et interdits pertinents (3 000 caractères et 20 CU de sélection au plus). Entrée : spaceIds facultatif (32 au plus) ; omis, tous les Spaces que ce credential peut lire. Sortie : profile (un Context Pack) et, si un fragment vient d’une source tierce, notice. Compte pour une lecture. Un profil vide reste vide : pour un vrai travail, demandez un Context Pack avec brain_get_context_pack. Même contenu que GET /profile.

Cherche des mots dans les titres et corps des mémoires, meilleurs résultats d’abord (insensible à la casse ; un mot dans le titre pèse plus qu’un mot dans le corps).

ArgumentTypeRôle
querychaîne, 1 à 200 caractèresles mots cherchés
spaceIdchaîne, facultatifseulement cet espace
pillarrôle, facultatifseulement ce pilier
limitentier de 1 à 50, défaut 10nombre de résultats

Sortie : query et hits[] (spaceId, spaceName, memoryId, pillar, pillarLabel, title, snippet, source, score, updatedAt).

brain_remember

Ajoute une Memory via le chemin de compatibilité legacy, qui exige encore un pillar. Pour une nouvelle intégration, privilégiez le Context Pack, les Nodes et les écritures gouvernées plutôt que de construire votre modèle autour de ce champ.

ArgumentTypeRôle
spaceIdchaînel’espace où écrire
pillarrôlele pilier de la mémoire
titlechaîne, 1 à 120 caractèrestitre
bodychaîne, 20 000 caractères au pluscontenu
kindchaîne de 1 à 40 caractères, facultatiflibellé libre (défaut note)
parentIdchaîne, facultatifimbriquer sous une mémoire du même espace

Sortie : memory (id, spaceId, pillar, parentId, kind, title, body, source: "MCP", createdAt, updatedAt). La mémoire compte dans la capacité du compte : un Brain plein répond capacity_full et rien n’est écrit. Le membre qui a autorisé le client doit avoir le droit d’écrire dans le Brain (sinon forbidden). Pour une écriture rejouable sans doublon, utilisez l’API REST et son en-tête Idempotency-Key.

Propositions de changement et Skills

Un client peut proposer un changement durable du Brain sans jamais l’appliquer lui-même.

  • brain_propose_change enregistre une proposition en attente dans un Space autorisé : operation vaut create_memory, correct_memory, remove_memory, publish_skill ou archive_skill ; title (160 caractères au plus), body (20 000 caractères au plus), description (1 024), targetId (la Memory à corriger ou retirer), pillar (facultatif, défaut KNOWLEDGE), skillSlug (pour une Skill) et idempotencyKey (8 à 160 caractères) obligatoire. Réponse : proposal, applied: false, requiresExplicitReview: true. Une proposition ne touche jamais les Facts ni les Sources.
  • brain_import_skill lit un fichier SKILL.md (64 Kio au plus, dans la limite de 64 Kio de la requête ; en-tête name en kebab-case de 64 caractères au plus et description de 1 024 au plus, puis la procédure en Markdown) et le dépose comme proposition publish_skill en attente. Une clé d’en-tête inconnue est refusée avec une erreur explicite. Rien n’est exécuté ni installé : ni hook, ni script, ni secret, et chaque texte est contrôlé contre les secrets. L’import de fichiers d’accompagnement (references/, scripts/, assets/) est en cours de déploiement : tant qu’il n’est pas ouvert, un import qui en contient répond bundles_disabled et seul le SKILL.md est accepté.
  • brain_list_proposals liste les propositions d’un Space (status : PENDING par défaut, APPLIED, REJECTED ou ALL). Un membre sans droit d’écriture ne voit que les siennes.
  • brain_review_proposal (proposalId, decision, confirmed: true) : l’approbation ne se fait que dans Orbit, page Propositions à valider (/brain/review) ; un client externe qui envoie approve reçoit approvalRequiresOrbit. Il peut en revanche enregistrer un refus explicite.
  • brain_list_skills liste les Skills approuvées et actives d’un espace ; brain_get_skill (spaceId, slug, version facultative) rend une Skill versionnée : par défaut (format: "bundle") son en-tête, un manifeste (chemins, tailles, empreintes sha256) et tous ses fichiers, SKILL.md en premier ; avec format: "skill_md", le seul SKILL.md. compareToVersion ajoute la liste des fichiers ajoutés, retirés et modifiés depuis cette version. Orbit n’installe rien dans le client : l’export est une lecture explicite (l’API REST sert aussi un export zip).

Journal d’activité des agents

Le journal d’activité répond à « qu’a fait Claude Code aujourd’hui ? » depuis n’importe quel client connecté. C’est un registre, pas une mémoire : une entrée n’est jamais modifiée, ne devient jamais une Memory, un Fact ni un fragment de Context Pack, et ne passe donc pas par une proposition. Elle se lit aussi dans Orbit, page Brain → Activité des agents (/brain/activity, en lecture seule). Les entrées sont gardées 180 jours. Les deux tools ont un équivalent REST, /activity, et ne comptent pas dans les lectures incluses.

brain_log_activity

Scope activity:write. Ajoute une entrée au journal.

ArgumentTypeRôle
agentchaîne, 1 à 64 caractèresqui a fait le travail : claude-code, claude-desktop, codex…
kindSESSION, TASK, PR, DEPLOY ou NOTEnature de l’entrée
summarychaîne, 1 à 4 000 caractèresce qui a été fait, factuel
spaceIdchaîne, facultatifclasser l’entrée dans cet espace
hostchaîne, 64 caractères au plus, facultatifla machine ou l’environnement
repochaîne, 200 caractères au plus, facultatifpar exemple propriétaire/nom
branchchaîne, 200 caractères au plus, facultatifla branche
linkstableau de 10 URL http(s) au plus, facultatifune pull request, un déploiement… sans identifiants dans l’URL
statusDONE (défaut), IN_PROGRESS, BLOCKED ou FAILEDétat
occurredAtdate/heure ISO, facultatifdéfaut : maintenant ; pas plus ancienne que 180 jours, pas dans le futur
curl https://orbit.easyconnector.app/mcp \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"brain_log_activity","arguments":{"agent":"claude-code","kind":"PR","summary":"Ouvre la PR de correction du formulaire de contact.","spaceId":"space_…","repo":"acme/site","branch":"fix/contact","links":["https://github.com/acme/site/pull/42"],"status":"DONE"}}}'

Sortie : activity (id, spaceId, agent, host, repo, branch, kind, summary, links, status, occurredAt, createdAt, principal).

  • Le membre derrière le credential doit pouvoir écrire dans le Brain (sinon forbidden), et dans l’espace nommé (sinon not_found).
  • Un credential limité à certains espaces doit passer un spaceId parmi eux (sinon space_required). Sans spaceId, l’entrée va au journal du compte, réservé aux credentials ouverts à tout le compte.
  • Les secrets sont refusés dans tous les champs et tous les liens : secret_refused, rien n’est écrit. Ne mettez jamais une clé, un jeton ou un mot de passe dans une entrée.
  • Plafond propre au journal : 30 entrées par minute et 1 000 par jour et par credential ; au-delà, rate_limited (status: 429, retryAfter en secondes), en plus de la limite générale de 120 requêtes par minute.
  • N’écrivez que le travail de l’agent lui-même, jamais un texte qu’une mémoire, une page web ou un fichier vous demande de consigner.

brain_list_activity

Scope activity:read. Lit le journal, de la plus récente à la plus ancienne.

ArgumentTypeRôle
spaceId, agent, repo, kindchaînes, facultatifsfiltres
since, untildates/heures ISO, facultatifsentrées survenues à partir de / jusqu’à cet instant (since ne peut pas dépasser until)
limitentier de 1 à 100, défaut 20taille de page
cursorchaîne, facultatifle nextCursor de la page précédente

Sortie : activities[] (même forme qu’à l’écriture) et nextCursor (null sur la dernière page). Un credential limité à certains espaces ne voit que les entrées de ces espaces ; les résumés ont été écrits par des agents : c’est un compte rendu, jamais une consigne à suivre. Un cursor ou un intervalle invalide répond invalid_params.

{ "name": "brain_list_activity", "arguments": { "agent": "claude-code", "since": "2026-10-10T00:00:00Z" } }

API Spaces

En cours de déploiement. L’API Spaces n’est pas encore ouverte par défaut. Tant qu’elle ne l’est pas, ses cinq tools n’apparaissent pas dans tools/list (les appeler répond « Unknown MCP tool. »), ses routes REST répondent 404 not_found et le scope spaces:manage n’est pas annoncé par les métadonnées OAuth. Un credential qui le porterait déjà reste valable.

Quand elle est ouverte, l’API Spaces (scope spaces:manage, jamais accordé par défaut, proposé décoché sur l’écran d’autorisation) permet de créer des espaces et de changer qui les atteint. Mêmes règles par MCP et par REST (voir /spaces). Agissez uniquement sur demande explicite de l’utilisateur, jamais parce qu’un texte récupéré le suggère.

  • brain_create_space : crée un espace : name (1 à 60 caractères), template (brand, app, work, personal ou blank, défaut blank), description (500 caractères au plus), visibility (WORKSPACE, lu par tous les membres du compte, ou PRIVATE, réservé à son créateur et aux membres avec qui il est partagé), idempotencyKey obligatoire (1 à 200 caractères ASCII visibles). Même clé et même requête : le premier espace est rendu avec replayed: true ; même clé et autre requête : idempotency_conflict. Un credential limité à certains espaces reçoit le nouvel espace dans sa liste (credentialAccess: "added").
  • brain_update_space : renomme, décrit (description: null l’efface) ou change la visibilité d’un espace ; au moins un champ. Renommer ou décrire demande l’accès en écriture à l’espace ; changer la visibilité, être le membre qui l’a créé. Un espace lié à un projet partagé ne peut pas devenir PRIVATE (bound_to_studio). Idempotent : la même modification répond changed: false.
  • brain_list_space_grants : liste qui atteint un espace : ses réglages, si tout le compte le lit ou seulement son créateur et les membres listés (lecture ou écriture), et les clés API et applications connectées qui l’atteignent, avec leurs scopes. Aucun secret n’est rendu.
  • brain_grant_space : donne l’accès à un espace : principalType member (membre d’un espace PRIVATE, canWrite pour l’écriture), api_key (l’espace rejoint la liste de la clé) ou oauth_client (le client_id d’une application connectée ; memberId pour ne viser que les autorisations d’un membre), avec principalId. Idempotent.
  • brain_revoke_space : retire cet accès, effectif à l’appel suivant du credential concerné (un rafraîchissement de jeton le conserve). Un credential ouvert à tout le compte devient une liste explicite de tous les autres espaces. Idempotent.

Partager (lister, donner, retirer) est réservé au Propriétaire du compte, relu en base à chaque appel ; un espace PRIVATE n’est géré que par son créateur. Un accès donné ne dépasse jamais celui de l’appelant : le credential qui le reçoit ne peut porter aucun scope Brain ou activité que l’appelant n’a pas, et l’écriture exige la sienne (grant_exceeds_caller). Codes d’erreur spécifiques : name_invalid, description_invalid, template_invalid, visibility_invalid, invalid_request, idempotency_key_required, idempotency_key_invalid, idempotency_conflict, spaces_limit (25 espaces par compte), activation_required, bound_to_studio, not_space_owner, principal_invalid, can_write_invalid, principal_not_found, principal_is_owner, space_not_private, principal_lacks_access, grant_exceeds_caller, forbidden, not_found. Ils portent aussi un status (l’équivalent HTTP).

brain_check_alignment

Préflight evidence-first avant une action ou un draft important. Entrée : task, et facultativement action, draft, spaceIds, asOf, maxChars.

Deux conclusions seulement :

  • no_relevant_context / no_evidence_found : Orbit n’a retrouvé aucune preuve pertinente ; ce n’est pas une garantie d’alignement ;
  • review_required / review_context_before_proceeding : des contraintes, décisions, faits ou contradictions pertinents doivent être conciliés.

La réponse contient les signaux et le Context Pack complet utilisé pour les établir. Dans un host tiers, le client doit appeler ce Tool explicitement ; le serveur MCP ne voit pas passivement chaque tour de conversation.

Graphe utilisateur

brain_list_nodes rend les Nodes et Edges d’un Space. brain_create_node, brain_update_node, brain_link_nodes et brain_attach_node_resource organisent la connaissance sans la copier.

Un Node peut référencer des Memories, Sources, Facts et Segments. Une Edge ne peut relier que deux Nodes du même Space. Ces objets sont des vues/collections utilisateur, jamais la vérité canonique.

brain_quota

Où en est le compte sur ses lectures incluses du mois, sans compter pour une lecture. Entrée : aucun argument. À appeler avant une longue série de brain_get_context, brain_get_context_pack ou brain_search.

{
  "limit": 3000,
  "used": 412,
  "remaining": 2588,
  "resetsAt": "2026-11-01T00:00:00.000Z",
  "activated": true,
  "storage": {
    "usedBytes": 12400000000,
    "includedBytes": 50000000000,
    "addonBlocks": 0,
    "addonBytes": 0,
    "quotaBytes": 50000000000,
    "brainBytes": 9100000000,
    "studioBytes": 3500000000,
    "state": "ok",
    "graceEndsAt": null
  }
}

storage donne le stockage du compte (voir Stockage), en octets (1 Go = 10⁹ octets) : usedBytes (fichiers originaux comptés, chacun une fois), includedBytes (inclus avec l’offre), addonBlocks et addonBytes (blocs de +100 Go ajoutés), quotaBytes (le total permis), brainBytes et studioBytes (par surface ; un fichier présent dans les deux compte une fois dans chacune, la somme peut donc dépasser usedBytes), state (ok, warning à 80 %, grace au-delà du quota pendant 14 jours, waiting ensuite : un nouveau fichier du Brain attend, un envoi Studio est refusé) et graceEndsAt (date ISO de fin de la grâce, null sous le quota). Au-delà du quota, rien n’est supprimé ni bloqué en lecture.

Mêmes chiffres que GET /quota de l’API REST.

Studio headless et Artifacts

Les tools Studio suivent un ordre simple : découvrir (catalogue, historique, créations, Favoris), puis générer seulement après l’accord explicite de l’utilisateur, puis relire. Les lectures ne dépensent rien et ne comptent pas dans les lectures incluses.

Les adresses de fichiers renvoyées (url) sont des routes protégées d’Orbit, servies seulement à un navigateur connecté au compte ; ce ne sont pas des téléchargements publics pour un agent (fileAccess: "browser-session-required"). Ne devinez jamais une adresse ni une identité : réutilisez les identifiants et mentions renvoyés.

studio_get_capabilities

Scope studio:read. Lit le catalogue de génération en vigueur, calculé par le même code serveur que l’interface de Studio, sans réserver de crédit ni appeler de fournisseur payant. Entrée : aucun argument. Sortie : capabilities avec canGenerate, l’état des fournisseurs et du stockage, les cas image et vidéo (formats, durées, résolutions), les modèles de voix, les modèles de composition, les préréglages de scène, les placements, les Skills et pricing: "estimates-only…". Une ligne du catalogue n’est pas la promesse qu’un fournisseur réussira : le moteur valide chaque demande et calcule le prix réel.

studio_list_generations

Scope studio:read. Parcourt l’historique des générations du membre (image, vidéo, voix, composition…), de la plus récente à la plus ancienne. Entrée : limit (1 à 50, défaut 20) et offset (0 à 10 000, défaut 0). Sortie : history avec generations[] (id, kind, capability, status, modelId, artifactId, url, mediaType, createdAt, settledAt, chargedUsd), nextOffset, hasMore et fileAccess. Sert à retrouver un generationId ou un artifactId sans le connaître d’avance ; n’interroge aucun fournisseur.

artifact_list

Scope artifacts:read. Parcourt les créations Studio durables du membre (images, clips et autres médias). Mêmes limit et offset. Sortie : library avec artifacts[] (id, kind, status, mediaType, bytes, modelId, url, createdAt), nextOffset, hasMore et fileAccess. artifact_get donne ensuite la lignée complète d’une création.

studio_list_favorites

Scope studio:read. Liste les Favoris réellement utilisés par Studio (pas une recherche dans les mémoires du Brain) : les avatars enregistrés du membre, avec leur planche d’identité, et ses images de référence enregistrées. Entrée : category (all par défaut, avatars ou references), limit (1 à 50 par catégorie, défaut 20) et offset. Les Favoris sans projet (« libre ») sont listés, ainsi que les Favoris historiques rattachés à un ancien projet du même compte (ils portent alors legacyScopeId). Un avatar réutilisable porte la mention { "type": "character", "id": "<avatarId>" }, une référence la mention { "type": "reference", "id": "<referenceId>" }.

studio_get_avatar

Scope studio:read. Lit un avatar enregistré par son identifiant (avatarId, requis) : image d’origine, planche d’identité (identitySheet : une image 16:9 en six zones, null tant qu’elle n’existe pas) et mention réutilisable. Seuls les avatars du membre lui-même sont rendus ; un autre identifiant répond not_found.

studio_canvas_get

Scope studio:read. Sans graphId, liste les graphes Canvas actifs du membre ; avec graphId, lit ce graphe enregistré : sa version, le catalogue des nœuds et les modifications proposées en attente. projectId est facultatif (par défaut, l’espace personnel « libre »). Un graphe n’appartient qu’à son auteur. Gratuit : ne lit aucun contenu du Brain cité, n’interroge aucun fournisseur et ne lance rien.

studio_canvas_propose

Scope studio:generate. Dépose un lot entier de modifications d’un graphe Canvas, validé contre le registre des nœuds et ses règles de connexion, sur la version exacte lue par studio_canvas_get (baseVersion). Gratuit : ne lance aucun nœud, ne réserve aucun crédit et n’appelle aucun modèle. La proposition n’est pas appliquée : seul l’auteur du graphe la prévisualise et l’applique dans le panneau copilote du Canvas, dans Orbit. Rejouer le même lot ne crée pas de doublon.

studio_generate

Scope studio:generate. Lance une génération avec le même moteur, le même ledger et les mêmes règles de références que le composer de Studio : crédits, plafonds, droits du membre, idempotence et contrôles du Context Pack. C’est un travail payant : demandez toujours l’accord de l’utilisateur avant de dépenser ses crédits.

ArgumentTypeRôle
idempotencyKeychaîne, 1 à 200 caractères, requisclé stable de rejeu pour cette génération
specobjet, requisla spécification de génération ; kind parmi image, video, voice, lipsync, gif, picto, avatar, edit, compose. Le serveur reste juge des fenêtres de cas, des références et du prix, et enregistre lui-même la trace des droits
mentionstableau de 8 références au plus, facultatifle contexte que la génération peut lire (voir ci-dessous)
projectIdchaîne ou null, facultatifancien identifiant de projet Studio, conservé pour les workflows historiques. Omettez-le : le serveur crée alors sans projet (null), dans le flux actuel centré sur le compte

mentions est le contexte que la génération peut lire : huit références { type, id } au plus, type parmi space, memory, node, source, url, project, character et reference (par exemple l’identifiant d’un espace donné par brain_list_spaces, ou la mention d’un avatar donnée par studio_list_favorites). Pour les générations compatibles, les citations de contexte explicites sont prioritaires ; en leur absence et avec un projet, un extrait d’au plus trois espaces partagés avec le compte, explicitement liés et encore autorisés, peut être lu. Les espaces privés sont exclus de cette sélection automatique. Sans projet ni citation de contexte, aucun contexte du Brain n’est ajouté. Chaque mention est autorisée de nouveau au moment de la génération, propriété comprise ; une référence inconnue, d’un autre compte ou interdite refuse toute la demande. Voir Citer son contexte.

Une génération vidéo peut rester asynchrone ; studio_get_generation permet d’en relire l’état.

studio_get_generation, studio_revise et artifact_get

  • studio_get_generation (scope studio:read, generationId requis) lit une génération du membre (ou du compte quand son rôle permet la lecture d’équipe) : statut, Artifact, coûts et erreur éventuelle. Pour une vidéo asynchrone, Orbit peut relever et régler sans risque un travail de fournisseur en retard avant de répondre.
  • studio_revise (scope studio:generate, payant) crée une révision upscale ou variation d’une image existante : sourceAssetId, edit et idempotencyKey requis, instruction (4 000 caractères au plus) et projectId (ancien, à omettre) facultatifs. Une nouvelle création est produite avec sa lignée ; l’original n’est jamais écrasé.
  • artifact_get (scope artifacts:read, artifactId requis) rend la création durable : id, projet éventuel, type, statut, média, taille, URL et identifiants des générations de sa lignée.

Transport et méthodes

Chaque message est un objet JSON-RPC 2.0 envoyé en POST sur l’endpoint (transport HTTP sans état). Il n’y a ni flux SSE, ni identifiant de session, ni lot : un tableau JSON est refusé comme requête invalide.

MéthodeComportement
initializeRenvoie la protocolVersion négociée avec le client (la révision 2026-07-28 visée, ou 2025-11-25 pour un client resté sur cette révision), capabilities: { tools: { listChanged: false } }, serverInfo et des instructions.
pingRenvoie {}.
tools/listRenvoie les trente-deux tools ci-dessus (trente-sept avec l’API Spaces ouverte). Un client garde souvent cette liste en cache : après une mise à jour d’Orbit, actualisez le connecteur (dans ChatGPT, Refresh).
tools/callExécute un tool, après vérification de son scope.
NotificationsTout message sans id, ou dont la méthode commence par notifications/ (notifications/initialized, notifications/cancelled…), reçoit 202 Accepted sans corps.

Un GET authentifié sur l’endpoint répond 405 (« Use POST for MCP JSON-RPC. »). OPTIONS répond 204 (pré-vol CORS).

Le serveur n’expose aujourd’hui que des tools : les méthodes resources/* et prompts/* répondent « Unknown MCP method. » (-32601). Des ressources MCP (le profil et les Skills approuvées) et un prompt de démarrage sont en cours de déploiement ; ils ne sont pas encore ouverts par défaut.

curl https://orbit.easyconnector.app/mcp \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"brain_get_context","arguments":{"pillars":["IDENTITY","GUIDELINES"],"maxChars":6000}}}'

Limites

LimiteValeur
Taille du corps64 Kio, comptés en octets (y compris pour un corps envoyé sans Content-Length)
Débit120 requêtes par minute et par identifiant (jeton OAuth ou clé)

Les réponses portent l’en-tête X-RateLimit-Remaining ; une réponse 429 ajoute Retry-After (en secondes).

Erreurs

Les messages d’erreur du MCP sont en anglais : leur lecteur est un client ou un LLM.

CasHTTPRéponse
Jeton absent, invalide, expiré ou révoqué401{ "error": "invalid_token", "error_description": "…" } et en-tête WWW-Authenticate
Trop de requêtes429JSON-RPC -32000 « Too many requests. »
Corps trop volumineux413JSON-RPC -32600 « Request too large. »
JSON illisible400JSON-RPC -32700 « Invalid JSON. »
jsonrpc différent de "2.0" ou method absente400JSON-RPC -32600 « Invalid JSON-RPC request. »
Méthode inconnue200JSON-RPC -32601 « Unknown MCP method. »
Tool inconnu200JSON-RPC -32602 « Unknown MCP tool. »
Scope manquant pour ce tool403JSON-RPC -32003 insufficient_scope: …, data.requiredScope, en-tête WWW-Authenticate avec error="insufficient_scope"
Argument invalide ou manquant200résultat de tool isError: true, code invalid_params

Une réponse 401 indique au client où découvrir l’autorisation, et ne propose que la lecture du Brain ; les autres accès se demandent explicitement :

WWW-Authenticate: Bearer realm="Orbit MCP", resource_metadata="https://orbit.easyconnector.app/.well-known/oauth-protected-resource/mcp", scope="brain:read"

Authentification

L’endpoint accepte deux types de jetons Bearer, tous deux limités à leurs scopes et au compte qui les a émis :

  • un jeton d’accès OAuth obtenu par le flux ci-dessous, avec les scopes que vous avez accordés : recommandé pour Claude, ChatGPT et tout client qui sait faire OAuth ;
  • une clé développeur orb_… créée dans Orbit (page API, formulaire en ligne), avec les scopes cochés à sa création : pour les clients headless, scripts, CI et intégrations serveur à serveur (voir API, section « Clés développeur »).

À chaque appel, Orbit relit le jeton et le membre en base : un jeton révoqué ou expiré, ou un membre retiré du compte, coupe l’accès immédiatement (une clé dont le créateur a été révoqué est refusée comme une clé révoquée ; member_inactive reste le garde-fou des autres credentials). Le rôle du membre décide s’il peut écrire dans le Brain.

Scopes

Un accès (scope) ouvre un groupe de tools, jamais un autre : brain:write n’accorde pas brain:read. Les libellés sont ceux de l’écran d’autorisation et du formulaire de clé.

ScopeLibellé dans OrbitOuvre
brain:readLire le Brainespaces, contexte, recherche, Context Pack, alignement, profil, quota, Nodes, propositions, Skills
brain:writeNourrir le BrainMemories, Nodes, propositions, import de Skill ; aucune suppression directe
studio:readLire les générations Studiostudio_get_capabilities, studio_list_generations, studio_get_generation, studio_list_favorites, studio_get_avatar, studio_canvas_get
studio:generateGénérer avec Studiostudio_generate, studio_revise ; dépense vos crédits Orbit ; studio_canvas_propose, gratuit
artifacts:readLire les créations Studioartifact_list, artifact_get
activity:readLire le journal d’activitébrain_list_activity
activity:writeÉcrire dans le journal d’activitébrain_log_activity ; une entrée à la fois
spaces:manageGérer les espaces et leurs accèsles tools de l’API Spaces, en cours de déploiement

brain:read, brain:write, activity:read, activity:write et spaces:manage portent sur des espaces : un client OAuth qui en demande un doit recevoir au moins un espace.

L’ancien scope projects:read (« Anciens projets Studio ») reste reconnu pour les clés et autorisations qui le portent déjà, mais il n’est plus proposé aux nouveaux clients et n’ouvre aucun tool MCP : il ne sert plus qu’à la route REST historique GET /projects.

Restriction par espace

Un credential n’ouvre que les espaces (Space) qui lui ont été accordés, en plus de ce que son membre a le droit de voir :

  • Autorisation OAuth : l’écran d’autorisation liste les espaces du compte que vous pouvez lire, en puces ; vous cochez explicitement ceux que l’application peut utiliser (aucun n’est coché d’avance). Dès que l’application demande un accès au Brain (ou au journal d’activité) et que le compte a au moins un espace, en cocher au moins un est obligatoire. Un espace créé plus tard demande une nouvelle autorisation. Le rafraîchissement du jeton garde la même liste.
  • Clé orb_… : la liste des espaces est choisie à la création, dans le formulaire de la page API (32 au plus) ; par défaut, tous les espaces que le Propriétaire voit à ce moment-là, que vous décochez au besoin. La sélection est fixe : un espace créé ensuite demande une nouvelle clé.
  • Liste vide : un credential restreint avec une liste vide n’ouvre aucun espace ; ce n’est jamais un accès à tout le compte.
  • Anciens credentials : les clés et autorisations créées avant cette restriction gardent un accès à l’ensemble des espaces du compte (la page API les marque « Ancien accès à tout le compte ») jusqu’à leur remplacement. Pour les restreindre, créez une nouvelle clé ou reconnectez l’application, puis révoquez l’ancienne.
  • Espaces privés : la liste autorisée ne remplace jamais les droits du membre. Un espace privé reste réservé à son créateur et aux membres à qui il l’a partagé, y compris par MCP ou API.

Un espace hors de la liste répond comme un identifiant inconnu (not_found). brain_list_spaces, le Context Pack sans spaceIds, la recherche, le profil, le graphe, les propositions, le journal d’activité et le contexte injecté dans une génération Studio sont tous limités à ces espaces.

Applications connectées

Chaque client autorisé par OAuth (Claude, ChatGPT…) apparaît dans la page MCP d’Orbit, carte Applications connectées : application, membre qui l’a connectée, accès accordés et dernier usage. Déconnecter une application coupe aussitôt tous ses jetons ; elle pourra être reconnectée plus tard. Le Propriétaire déconnecte l’application de n’importe quel membre du compte, un autre membre seulement les siennes. Révoquer un membre coupe de la même façon tout ce qu’il a connecté. Les clés orb_… ne figurent pas ici : elles se gèrent dans la page API, réservée au Propriétaire.

OAuth 2.1

Orbit est son propre serveur d’autorisation. Seuls les clients publics avec PKCE S256 sont acceptés : il n’y a pas de secret client.

ÉlémentValeur
Émetteur (issuer)https://orbit.easyconnector.app
Autorisationhttps://orbit.easyconnector.app/oauth/authorize
Jetonhttps://orbit.easyconnector.app/oauth/token
Enregistrement dynamiquehttps://orbit.easyconnector.app/oauth/register
Révocationhttps://orbit.easyconnector.app/oauth/revoke
Grant typesauthorization_code, refresh_token
response_typecode
PKCES256 uniquement
Authentification clientnone (jeton et révocation)
Paramètre iss dans la réponse d’autorisationoui
Ressource (resource)https://orbit.easyconnector.app/mcp (ou …/api/v1 pour un client qui n’utilise que l’API REST)
Scopes proposésbrain:read, brain:write, studio:read, studio:generate, artifacts:read, activity:read, activity:write (et spaces:manage quand l’API Spaces est ouverte)
Client ID Metadata Documentaccepté : un client peut se présenter par l’URL HTTPS d’un document de métadonnées public au lieu de s’enregistrer

Découverte

URLContenu
/.well-known/oauth-authorization-serverMétadonnées du serveur d’autorisation (RFC 8414) : les endpoints et méthodes ci-dessus, scopes_supported (la liste des scopes proposés ci-dessus), client_id_metadata_document_supported: true, op_policy_uri et op_tos_uri (la politique de confidentialité et les conditions).
/.well-known/oauth-protected-resourceMétadonnées de la ressource protégée (RFC 9728) : resource, authorization_servers, bearer_methods_supported: ["header"], scopes_supported (la même liste).
/.well-known/oauth-protected-resource/mcpLe même document pour la ressource canonique /mcp.
/.well-known/oauth-protected-resource/api/mcpCompatibilité avec l’ancienne ressource /api/mcp.

Ces documents sont publics, servis en GET, cachables 5 minutes et ouverts en CORS.

Parcours

Enregistrer le client

POST /oauth/register (JSON) avec client_name (1 à 200 caractères) et redirect_uris (1 à 10). Facultatif : scope (scopes séparés par des espaces ; un scope inconnu est refusé avec invalid_client_metadata). Réponse 201 avec un client_id (orbc_…), token_endpoint_auth_method: "none" et scope. Sans scope demandé, Orbit enregistre la liste des scopes proposés comme plafond de ce que le client pourra demander : ce n’est pas un accord. Seul ce que vous cochez sur l’écran d’autorisation entre dans un jeton.

Demander l’autorisation

Ouvrir /oauth/authorize avec response_type=code, client_id, redirect_uri (identique à une URI enregistrée), code_challenge (43 à 128 caractères base64url), code_challenge_method=S256, resource=https://orbit.easyconnector.app/mcp (obligatoire), state et, facultatif, scope (par exemple brain:read brain:write). Sans scope, seul brain:read est proposé. Un client qui veut écrire doit demander brain:write ; un client qui veut consigner son activité, activity:write (et activity:read pour la relire) ; un client qui veut générer doit demander explicitement studio:generate (et studio:read / artifacts:read selon son workflow).

Consentir dans Orbit

L’utilisateur se connecte à Orbit si nécessaire. L’écran d’autorisation lui montre le nom du client, le compte concerné, l’hôte de retour et chaque accès demandé, qu’il peut décocher (les accès d’écriture ne sont jamais cochés d’avance), puis les espaces du Brain accessibles à cette application, qu’il coche un par un. Il choisit ensuite Autoriser l’accès ou Annuler. Orbit redirige vers redirect_uri avec code, state et iss, ou avec error=access_denied (refus, aucun accès laissé coché, ou aucun espace choisi alors que le Brain est demandé).

Échanger le code

POST /oauth/token en application/x-www-form-urlencoded avec grant_type=authorization_code, code, client_id, redirect_uri, code_verifier et, facultatif, resource. Réponse : access_token, token_type: "Bearer", expires_in: 3600, refresh_token, scope (exactement les scopes accordés).

Rafraîchir

Même endpoint avec grant_type=refresh_token, refresh_token et client_id. Chaque rafraîchissement émet un nouveau couple de jetons, garde les mêmes scopes et les mêmes Spaces, et invalide l’ancien.

Règles

  • Redirect URI : https:// obligatoire, sauf http:// sur boucle locale (localhost, 127.0.0.1, ::1). Ni identifiants (user:pass@) ni fragment (#).
  • Noms réservés : un client_name contenant « orbit » ou « easyconnector » (comparaison sans accents, sans casse, sans espaces ni ponctuation) est refusé avec invalid_client_metadata, pour qu’un tiers ne puisse pas se présenter sous la marque Orbit sur l’écran de consentement.
  • token_endpoint_auth_method, s’il est fourni, doit valoir none.
  • Un client_id créé par enregistrement dynamique est conservé : ChatGPT et Claude le réutilisent pour cette connexion. Les codes d’autorisation expirés et les jetons morts ont leur propre rétention, sans invalider le client enregistré.
  • Durées : code d’autorisation 10 minutes, à usage unique ; jeton d’accès 1 heure ; refresh token 30 jours. Le client_id DCR n’expire pas automatiquement.
  • Rejeu : réutiliser un code ou un refresh token déjà consommé révoque toute la famille de jetons de ce client pour ce membre.
  • Un scope inconnu est refusé (invalid_scope), jamais ignoré. Aucun scope n’en implique un autre : brain:write n’accorde pas brain:read.
  • Un jeton émis pour /mcp (ou pour l’ancienne ressource /api/mcp) est aussi accepté par l’API REST /api/v1 ; un jeton émis pour /api/v1 n’ouvre pas le MCP.

Révocation

POST /oauth/revoke en application/x-www-form-urlencoded avec token, client_id et, facultatif, token_type_hint (access_token ou refresh_token). La réponse est toujours 200 sans corps (RFC 7009), que le jeton existe ou non ; un jeton reconnu révoque toute sa famille.

Erreurs OAuth

Les endpoints OAuth répondent au format standard { "error": "…", "error_description": "…" } (invalid_request, invalid_client_metadata, invalid_grant, invalid_scope, invalid_target, unsupported_grant_type) en 400, avec Cache-Control: no-store. L’enregistrement dynamique a un plafond global de 600 requêtes par minute plutôt qu’un plafond par IP, car ChatGPT et Claude utilisent des pools d’adresses partagés. Les endpoints de jeton et de révocation restent limités par appelant et client_id ; au-delà, 429 avec "error": "rate_limited".

CORS

/mcp répond avec Access-Control-Allow-Origin: *, autorise les en-têtes authorization, content-type et idempotency-key, et envoie Cache-Control: no-store. L’ancienne route /api/mcp garde le même comportement pour compatibilité.

Disponibilité

Sont exposés par défaut : la restriction par espace, les propositions validées dans Orbit, les Skills portables (le SKILL.md seul à l’import), le Studio headless, les Artifacts, le graphe utilisateur, l’Alignment Check et le journal d’activité des agents. En cours de déploiement, pas encore ouverts par défaut : l’API Spaces (scope spaces:manage, REST et MCP), l’import de fichiers d’accompagnement d’une Skill, et les ressources et prompts MCP. L’archivage et la suppression protégés de la connaissance (au-delà de la proposition de retrait d’une Memory) ne sont pas exposés : ils restent des opérations faites dans Orbit.

Le principe ne change pas : MCP est un port vers le Brain, jamais un accès direct à ses tables, et le client ne reçoit que ce que ses scopes autorisent.

Pour le modèle mental, voir Comprendre le Brain. Pour l’API REST, voir API.