Connecter un outil avec MCP ou l’API
Choisissez votre méthode de connexion, accordez les accès utiles et vérifiez une première lecture du Brain.
Objectif : obtenir une première lecture vérifiée depuis votre outil, avec un périmètre explicite. Vous devez disposer d’un compte Orbit, d’un espace utile et des droits nécessaires à la connexion choisie.
MCP ou API ?
| MCP | API REST | |
|---|---|---|
| Usage | Un assistant ou hôte compatible appelle les outils Orbit | Votre code appelle des routes HTTP |
| Point d’entrée | https://orbit.easyconnector.app/mcp | https://orbit.easyconnector.app/api/v1 |
| Mise en place | Consignes du client dans Connexion → MCP | Clé et exemples dans Connexion → API |
| Première vérification | Lister les espaces autorisés | Lire /spaces |
| Référence complète | MCP | API |
La compatibilité réelle dépend du client, de sa version et du parcours qu’il prend en charge. Un nom présent dans le catalogue n’est pas une preuve qu’une connexion donnée fonctionne déjà de bout en bout.
Première connexion, premier test
Limitez les accès
Commencez en lecture. Choisissez explicitement les espaces nécessaires. Un espace créé plus tard n’entre pas automatiquement dans une autorisation limitée ; un espace privé d’un autre membre reste fermé.
Testez avec une information non sensible
Demandez la liste des espaces puis une information vérifiable dans l’un d’eux. Comparez la réponse au Brain et à sa source. N’accordez pas l’écriture simplement pour corriger un test de lecture mal configuré.
Contrôlez et révoquez si nécessaire
Consultez les applications connectées ou les clés dans la console. Une connexion inutilisée peut être révoquée. Les permissions du membre continuent de s’appliquer à chaque appel.
Prompt de vérification MCP
Utilise la connexion Orbit pour lister uniquement les espaces auxquels tu as accès.
Dans l’espace que je choisirai ensuite, retrouve [un fait connu] et indique sa source.
Si tu ne trouves pas de preuve, dis-le explicitement.
Ne crée aucune mémoire, ne modifie rien et ne lance aucune génération.
Première lecture REST
Stockez votre clé dans une variable locale adaptée à votre environnement ; ne la copiez pas dans un dépôt, un prompt partagé ou une capture.
curl --fail-with-body \
-H "Authorization: Bearer $ORBIT_API_KEY" \
'https://orbit.easyconnector.app/api/v1/spaces'
Cette requête lit la liste des espaces autorisés. Pour un Context Pack, les champs attendus et les erreurs, utilisez les exemples de la référence API plutôt que d’inventer des paramètres.
Avant d’élargir les droits
| Capacité | Effet à comprendre |
|---|---|
| Lire le Brain | Accéder au contexte des espaces autorisés ; certains appels consomment une lecture incluse |
| Écrire le Brain | Ajouter des mémoires, organiser ou proposer des changements selon l’outil |
| Générer dans Studio | Dépenser des crédits avec les droits et budgets du membre |
| Journal d’activité | Consigner ou lire une activité ; ne crée pas de mémoire |
| Gérer les espaces | Outils optionnels, exposés seulement lorsque cette fonction est activée |
Une proposition demande une validation humaine dans Orbit ; un client externe ne peut pas l’approuver à votre place. L’écriture directe de mémoire reste une capacité distincte : si vous accordez brain:write, ne supposez pas que toutes les écritures passent par des propositions.
Encadrer un agent externe
Définissez une mission, des limites et une preuve de résultat.