Connecter et automatiserMCP ou API : premier test

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 ?

MCPAPI REST
UsageUn assistant ou hôte compatible appelle les outils OrbitVotre code appelle des routes HTTP
Point d’entréehttps://orbit.easyconnector.app/mcphttps://orbit.easyconnector.app/api/v1
Mise en placeConsignes du client dans Connexion → MCPClé et exemples dans Connexion → API
Première vérificationLister les espaces autorisésLire /spaces
Référence complèteMCPAPI

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

Ouvrez la bonne console

Dans Orbit, ouvrez MCP pour un assistant ou API pour votre code. Suivez les instructions du client choisi. La création de clés du compte est réservée aux personnes autorisées.

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 BrainAccéder au contexte des espaces autorisés ; certains appels consomment une lecture incluse
Écrire le BrainAjouter des mémoires, organiser ou proposer des changements selon l’outil
Générer dans StudioDé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 espacesOutils 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.