Vos connexions¶

OS connaît trois sortes de connexions que vous créez vous-même :

Votre propre compte auprès d'un service externe. Certains outils de l'AI Toolbox fonctionnent avec votre propre compte auprès d'un service, comme un système de tickets. Vous connectez ce compte une fois, puis les outils l'utilisent quand vous les exécutez.
Une application IA que vous connectez à un groupe de l'AI Toolbox. Une application IA sur votre propre ordinateur, comme Claude Code ou Cursor, peut utiliser les outils d'un groupe. Chaque connexion a sa propre clé.
Une app d'IA qui travaille dans OS lui-même. Une app d'IA comme Claude Code, Claude Desktop ou Cursor peut travailler dans vos organisations avec vos droits : rechercher des membres, créer un assistant, modifier un groupe. Vous vous connectez depuis l'app ; il n'y a pas de clé.

Vous ne voyez et ne gérez que vos propres connexions. Les deux premières se trouvent sur la page Mes connexions et sont ouvertes à toute personne qui peut utiliser l'AI Toolbox, dans une organisation dont le service comprend l'AI Toolbox. La troisième se trouve sur la page Travailler depuis une app d'IA et fonctionne dans chaque organisation qui autorise les apps d'IA.

Ouvrir Mes connexions¶

Ouvrez AI Toolbox et choisissez Mes connexions dans la barre du haut. Après vous être connecté à un service, vous revenez aussi ici de vous-même.

Sous Mes connexions figure chaque service pour lequel l'un de vos outils demande votre propre connexion, avec Connecté ou Non connecté. S'il est écrit Aucun de vos outils ne demande votre propre connexion., vous n'avez rien à connecter.

Choisissez Connecter à côté du service.
Votre navigateur va sur la page de connexion du service. Connectez-vous et donnez votre accord.
Vous revenez sur Mes connexions, avec le message Connecté à « nom ». Si vous avez refusé, le message dit que la connexion a été refusée.

À partir de là, les outils de ce service fonctionnent avec votre compte, quand vous les exécutez dans la boîte à outils et quand un assistant les utilise pour vous. Tant que vous n'êtes pas connecté, un tel outil dans la boîte à outils indique que vous devez d'abord connecter votre propre compte. Un assistant peut alors vous donner un lien pour vous connecter ; vous voyez ensuite ici si cela a fonctionné.

Déconnecter. Choisissez Déconnecter et confirmez. OS oublie votre connexion ; le service lui-même n'est pas informé. Si vous voulez aussi retirer l'accès là-bas, faites-le auprès du service.

Si un service affiche de nouveau Non connecté alors que vous vous étiez connecté, votre connexion au service a expiré ou a été révoquée. Choisissez de nouveau Connecter.

Connecter une application IA à un groupe¶

Vous connectez une application IA à un seul groupe de l'AI Toolbox. L'application reçoit les outils de ce groupe que vous pouvez utiliser à ce moment. Un outil ajouté plus tard au groupe n'arrive dans l'application qu'avec une nouvelle connexion.

Ouvrez le groupe dans l'AI Toolbox et choisissez Connecter une application IA dans la barre du haut.
Saisissez un Nom auquel vous reconnaissez la connexion, par exemple Portable, Claude Code.
Choisissez Valable jusqu'au : par défaut dans 30 jours, 90 jours au plus. Ensuite, la connexion ne fonctionne plus et vous en créez une nouvelle.
Choisissez Créer la clé.

L'écran affiche alors, seulement maintenant :

l'Adresse de la connexion ;
la Clé. Conservez-la comme un mot de passe : qui la détient utilise les outils du groupe en votre nom. OS ne la montre plus jamais ;
une commande pour Claude Code et un bloc pour Cursor, avec l'adresse et la clé déjà remplies.

Sous Pas dans cette connexion, l'écran nomme chaque outil du groupe que l'application ne reçoit pas, et pourquoi. Une application IA ne peut pas utiliser un outil qui fonctionne avec votre propre compte auprès d'un service, ni un outil qui a besoin de plus que lui-même, comme des connaissances ou un modèle. Un espace de données partagé avec vous, l'application peut seulement le lire.

S'il est écrit Ce groupe n'est encore lié à aucun ensemble d'outils, le groupe ne peut pas encore être connecté à une application IA. Demandez à un administrateur de lier d'abord le groupe à un ensemble d'outils.

Claude Code¶

Copiez la commande sous Claude Code et exécutez-la dans un terminal. Elle ressemble à ceci, avec l'adresse et la clé de votre connexion :

claude mcp add --transport http service-client \
    https://<adresse>/api/v1/mcp/toolsets/service-client \
    --header "Authorization: Bearer ack_..."

Ensuite, claude mcp list affiche la connexion, et Claude Code peut utiliser les outils du groupe.

Cursor¶

Copiez le bloc sous Cursor dans le fichier MCP de Cursor (.cursor/mcp.json dans votre projet, ou ~/.cursor/mcp.json pour tous vos projets). S'il contient déjà des serveurs, ajoutez seulement l'entrée de cette connexion à mcpServers :

{
  "mcpServers": {
    "service-client": {
      "url": "https://<adresse>/api/v1/mcp/toolsets/service-client",
      "headers": { "Authorization": "Bearer ack_..." }
    }
  }
}

Claude Desktop¶

Claude Desktop ne peut pas utiliser une connexion à un groupe : ses connecteurs personnalisés se connectent avec OAuth et n'ont pas de champ pour la clé. Avec Claude Desktop, vous travaillez en revanche dans OS lui-même.

Un nouveau secret, ou mettre fin à la connexion¶

Sous Applications IA, sur Mes connexions, figure chaque application IA que vous avez connectée à un groupe, avec le groupe, le début de la clé et la date d'expiration de la connexion.

Nouveau secret. Si vous avez perdu la clé, ou si quelqu'un d'autre l'a peut-être vue, choisissez Nouveau secret. L'ancienne clé cesse aussitôt de fonctionner ; la nouvelle est affichée une fois, et la connexion expire le même jour qu'avant. Mettez la nouvelle clé dans votre application IA.
Mettre fin. Choisissez Mettre fin et confirmez. L'application IA ne peut plus utiliser les outils du groupe.

Qui configure l'AI Toolbox de votre organisation peut aussi mettre fin à vos connexions.

Quand vous ne pouvez plus utiliser la boîte à outils¶

OS met fin de lui-même à vos connexions à des groupes quand vous ne pouvez plus utiliser l'AI Toolbox : quand votre adhésion est désactivée ou supprimée, quand vous perdez le droit à l'AI Toolbox, ou quand le service de l'organisation ne comprend plus l'AI Toolbox. Si vous êtes retiré de l'organisation, OS oublie aussi les connexions de vos propres comptes auprès de services externes.

Utiliser OS depuis une app d'IA¶

Une app d'IA peut aussi travailler dans OS lui-même, avec vos droits : rechercher des membres, créer un assistant, modifier un groupe. Vous connectez l'app une fois, et elle travaille ensuite dans chaque organisation dont vous êtes membre et qui autorise les apps d'IA. Ce que vous ne pouvez pas faire, l'app ne le peut pas non plus.

Ouvrez la page Travailler depuis une app d'IA dans le menu sous votre nom, ou avec le bouton Travailler depuis une app d'IA sur Mes connexions. Les deux apparaissent dès qu'une de vos organisations autorise les apps d'IA.

Sous Où c'est possible, vous voyez pour chaque organisation ce qu'un administrateur a choisi :

Réglage	Ce que l'app peut y faire
Désactivé	Rien. Chaque organisation commence ainsi.
Lecture seule	Consulter ce que vous pouvez voir, mais ne rien modifier.
Lecture et modification	Tout ce que vous pouvez faire, y compris inviter, modifier et supprimer.

Si chaque organisation est sur Désactivé, la page indique qu'aucune de vos organisations n'autorise les apps d'IA. Un administrateur de votre organisation peut l'activer (Paramètres de l'organisation).

Connecter l'app¶

Sous Connecter une app d'IA, copiez l'Adresse. Si l'app n'a qu'une chose à faire, choisissez d'abord un Domaine, comme Membres, Groupes, AI Assistants ou Paramètres : avec moins d'outils, l'app choisit mieux.
Choisissez l'onglet de votre app et suivez ce qui y est indiqué :
- Claude Code : exécutez la commande dans un terminal, lancez Claude Code et tapez /mcp.
- Claude Desktop : dans Claude, ouvrez Paramètres › Connecteurs, choisissez Ajouter un connecteur personnalisé, saisissez Artific OS comme nom et l'adresse comme URL, puis choisissez Se connecter.
- Cursor : placez le bloc dans .cursor/mcp.json de votre projet, ou dans ~/.cursor/mcp.json pour tous vos projets.
- Autre app : toute app qui prend en charge MCP sur HTTP avec connexion (OAuth) peut se connecter avec l'adresse. Une app qui ne peut envoyer qu'une clé fixe dans un en-tête ne peut pas se connecter.
L'app ouvre votre navigateur. Connectez-vous à OS comme d'habitude et choisissez Donner l'accès. Le nom de l'app sur cette page est celui que l'app se donne elle-même : ne donnez l'accès que si vous venez de lancer l'app vous-même.

Pour Claude Code, la commande ressemble à ceci :

claude mcp add --transport http artific-os https://<adresse>/api/v1/mcp

Ce que l'app modifie figure dans le journal d'audit de l'organisation avec votre nom et celui de l'app. Le fournisseur de l'app, comme Anthropic ou Cursor, voit ce que l'app lit, comme ce que vous y collez vous-même.

Déconnecter une app¶

Sous Apps connectées figure chaque app qui a travaillé dans vos organisations avec votre compte, après son premier appel : quand vous l'avez utilisée la première et la dernière fois, et dans quelles organisations. Choisissez Déconnecter et confirmez. L'app ne peut alors plus rien faire dans vos organisations, dès maintenant. Pour l'utiliser à nouveau, reconnectez-vous depuis l'app.

Un administrateur peut aussi déconnecter l'une de vos apps, mais seulement dans l'organisation qu'il gère ; dans vos autres organisations, l'app continue de fonctionner.

Par l'API¶

Vos propres connexions à des services : GET /api/v1/organisations/{id}/toolbox/connections les affiche, et POST, GET et DELETE …/toolbox/mcp-servers/{nom}/authorization en commencent, en lisent et en oublient une. Vos applications IA connectées à un groupe : POST …/toolbox/mcp-connections avec group, label et expires_at crée une connexion et renvoie la clé une fois ; GET …/toolbox/mcp-connections les affiche, POST …/mcp-connections/{id}/rotate crée un nouveau secret et DELETE …/mcp-connections/{id} met fin à une connexion. Les apps d'IA qui travaillent dans OS : GET /api/v1/me/mcp-clients les affiche et DELETE /api/v1/me/mcp-clients/{client_id} en déconnecte une.