Connecter ISMS Copilot à Claude Code

Claude fait le travail. ISMS Copilot est l'expert en conformité qu'il consulte et qui vérifie son travail. Vous décidez et signez.

Vous pouvez utiliser votre compte ISMS Copilot directement depuis Claude Code, Cursor, ou tout outil d'IA compatible MCP. Une fois connecté, votre outil d'IA peut lister vos espaces de travail et documents, lire vos mémoires, et tenir de véritables conversations ISMS Copilot, agissant en votre nom et couvert par votre abonnement existant.

Ce dont vous avez besoin

• Un compte ISMS Copilot. La connexion est couverte par votre abonnement, sans facturation séparée.
• Un terminal avec Claude Code (ou un autre client MCP) installé.
• Certaines fonctionnalités dépendent de votre plan (voir Choisir le mode de réponse).

Connexion en trois étapes

Déjà connecté avec un jeton d'accès personnel ? Supprimez d'abord ce serveur, sinon Claude Code continue de l'utiliser : claude mcp remove ismscopilot.

1. Ajoutez le serveur (aucun jeton nécessaire) :

claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp

2. Dans une session Claude Code, exécutez /mcp, sélectionnez ismscopilot, et suivez les étapes dans votre navigateur. Depuis un terminal, claude mcp login ismscopilot fait la même chose.
3. Connectez-vous à ISMS Copilot et cliquez sur Approuver dans la page de consentement.

Ensuite, demandez par exemple, "liste mes espaces de travail ISMS Copilot."

claude.ai et Claude Desktop se connectent à la même URL de serveur avec la même connexion : voir Connecter n'importe quel client MCP. ChatGPT se connecte de la même manière, en tant qu'application MCP personnalisée : voir la même page. Pour Cursor et Codex, voir Connecter Cursor et Codex.

Solution de repli : se connecter avec un jeton d'accès personnel

Utilisez un jeton lorsque la connexion n'est pas possible, par exemple en CI ou sur une machine sans interface graphique :

1. Dans ISMS Copilot, ouvrez Paramètres, puis Applications connectées.
2. Cliquez sur Créer un jeton. Donnez-lui un nom (par exemple, "Claude Code CI"), choisissez les permissions qu'il doit avoir (voir Permissions), et copiez le jeton. Vous ne le verrez qu'une seule fois.
3. Collez la commande affichée dans votre terminal. Elle ressemble à ceci :

claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp --header "Authorization: Bearer pat-isms-..."

Ce que votre outil d'IA peut faire

Une connexion peut lire et faire ce qui suit, et rien d'autre. Une connexion par authentification obtient chaque ligne ci-dessous ; un jeton obtient les lignes que ses permissions couvrent :

Ainsi, depuis votre outil d'IA, vous pouvez lister vos espaces de travail et documents, créer un espace de travail personnel, ajouter ou modifier une mémoire, et tenir une conversation ISMS Copilot ancrée, le tout sans quitter votre éditeur.

Choisir le mode de réponse (Fast, Think, et Beyond)

Le serveur ne choisit pas de mode. Votre orchestrateur utilise Fast par défaut, Think pour les vérifications et les analyses multi-étapes, et Beyond sur demande, pour une vérification finale juste avant un audit, ou pour la rédaction de recherches approfondies. Si l'orchestrateur omet mode, ISMS Copilot utilise Fast.

• Fast (par défaut) : réponses rapides, sans raisonnement approfondi.
• Think : raisonnement plus approfondi pour les vérifications et les analyses multi-étapes. Réservé aux plans payants. Sur un plan gratuit, une demande Think revient à Fast.
• Beyond : plan, brouillon et vérification multi-étapes. Réservé aux plans payants, 10 exécutions par jour UTC (50 sur Unlimited). À l'échelle de quelques minutes. L'orchestrateur doit passer mode: "beyond" sur create_conversation ou send_message, puis interroger get_reply environ toutes les 10-20 secondes jusqu'à ce que l'exécution soit terminée. Si Beyond ne peut pas s'exécuter, le tour répond via le flux normal et inclut beyond_denied_reason.

En pratique :

• « Réfléchis bien à cela » suffit pour Think.
• « Utilise Beyond » ou « exécute cela dans Beyond » suffit pour Beyond. Sans cela, l'orchestrateur peut tout de même choisir Beyond pour une vérification finale juste avant un audit, ou pour la rédaction de recherches approfondies.

Un tour Fast ou Think qui n'est pas prêt en ligne retourne status: "generating". L'orchestrateur interroge alors get_reply environ toutes les 2-5 secondes jusqu'à ce qu'il retourne complete.

Voir Utiliser le mode Beyond.

Si vous atteignez une limite d'utilisation

Connexions par authentification (Claude, ChatGPT) : le message d'erreur indique la limite et quand elle sera réinitialisée, sans invitation à mettre à niveau. Le JSON contient reset_at mais jamais upgrade_url, usage_url ou extra_usage_buyable. Les champs de mise à niveau et d'achat décrits ci-dessous n'apparaissent que sur les connexions par jeton d'accès personnel.

La connexion utilise la même limite d'utilisation que l'application de chat : l'allocation de votre abonnement, avec l'heure de réinitialisation affichée dans l'application. Si create_conversation ou send_message atteint la limite, le premier message d'erreur est la phrase d'attente ou de mise à niveau (incluant l'heure de la prochaine réinitialisation) et le bloc JSON inclut reset_at. Les comptes solo et les propriétaires d'organisation obtiennent également upgrade_url. Les membres d'organisation obtiennent à la place la phrase d'équipe : demandez au propriétaire un supplément d'utilisation, ou attendez la prochaine fenêtre de 4 heures. Leur JSON contient quota_scope, org_role, et extra_usage_buyable, et aucun lien de mise à niveau.

Vous pouvez :

1. Attendre jusqu'à reset_at.
2. Ouvrir upgrade_url dans un navigateur tout en étant connecté au même compte ISMS Copilot (comptes solo et propriétaires d'organisation).
3. Lorsque le JSON contient fallback_available: true et que le dépassement de votre plan est disponible (comptes payants solo avec Advanced Data Protection désactivé ; jamais sur un pool d'équipe), dites à l'orchestrateur de continuer : sur votre accord explicite, il renvoie avec overflow_consent: true et le tour s'exécute sur le même dépassement jusqu'à 2x que l'application web propose (la réponse contient overflow_active: true).
4. Continuer à utiliser les outils de lecture. Les espaces de travail, mémoires, documents et informations du compte fonctionnent toujours après la limite de chat.

Voir Que faire lorsque vous atteignez votre limite d'utilisation.

Les paramètres restent dans l'application web

Les paramètres protégés du compte sont en lecture seule depuis la connexion (les entreprises, mentionnées ci-dessus, sont l'exception : une connexion par authentification, ou un jeton avec company_context:write, peut les créer, les modifier et les supprimer, et les lier ou délier des espaces de travail, jusqu'à la limite de votre plan). En particulier, Advanced Data Protection (qui achemine vos données via un fournisseur basé dans l'UE, sans rétention) ne peut pas être activé ou désactivé depuis votre outil d'IA.

Si vous demandez à votre outil d'IA des informations sur la Protection des Données, il peut indiquer si elle est activée pour votre compte et vous orientera vers Paramètres, Protection des Données à chat.ismscopilot.com pour la modifier. Cela est délibéré : un jeton de connexion ne doit pas pouvoir modifier un paramètre global de résidence des données.

Permissions

Lorsque vous vous connectez et cliquez sur Approuver, l'outil obtient un ensemble fixe : lire votre compte, espaces de travail, documents (métadonnées), mémoires et entreprises ; interroger ISMS Copilot, lire les réponses et marquer une réponse bloquée comme échouée ; créer, modifier et supprimer des entreprises et les lier ou délier des espaces de travail, modifier des mémoires, et créer des espaces de travail. Il ne peut pas créer de clés API ni acheter des crédits. Les modifications qu'il apporte sont étiquetées dans ISMS Copilot avec le nom de l'outil, comme Added by OAuth app: <name> ou Updated by OAuth app: <name>.

Lorsque vous créez un jeton à la place, vous choisissez exactement ce qu'il peut faire (lire les espaces de travail, lire les documents, lire et écrire les mémoires, démarrer des conversations, etc.). N'accordez que ce dont vous avez besoin. Un jeton qui ne peut que lire vos espaces de travail ne peut pas modifier vos mémoires ni démarrer de conversations.

Vous pouvez voir et déconnecter chaque connexion à tout moment dans Paramètres, Applications connectées : les jetons dans la liste des jetons, les connexions par authentification sous Agents connectés.

Reconnecter ou faire tourner un jeton

Si une connexion par authentification cesse de fonctionner (par exemple après l'avoir déconnectée), exécutez /mcp, sélectionnez ismscopilot et connectez-vous à nouveau.

Si vous vous êtes connecté avec un jeton et souhaitez en utiliser un nouveau, supprimez d'abord le serveur existant. Sinon, Claude Code conserve l'ancien jeton :

claude mcp remove ismscopilot

Ensuite, ajoutez à nouveau le serveur, avec authentification ou avec le nouveau jeton.

Sécurité

• Une connexion agit en votre nom, elle peut donc accéder exactement à ce que votre compte peut déjà atteindre, limité par ce que vous avez approuvé ou les permissions que vous avez accordées.
• Elle est couvert par votre abonnement, sans facturation séparée.
• Vous pouvez la déconnecter à tout moment dans Paramètres, Applications connectées. La déconnexion prend effet immédiatement.
• Traitez un jeton comme un mot de passe. Si l'un d'eux est exposé, révoquez-le et créez-en un nouveau.

Dépannage

• Connecté mais les outils n'apparaissent pas : réexécutez la commande de connexion avec --scope user, ou exécutez claude mcp remove ismscopilot et ajoutez-le à nouveau.
• Échec de l'authentification ou "nécessite une authentification" : une connexion par authentification a été déconnectée ou a expiré : exécutez /mcp et connectez-vous à nouveau. Un jeton peut avoir été révoqué ou expiré : créez-en un nouveau dans Paramètres, Applications connectées.
• Le mode Think ne semble pas plus approfondi : Think nécessite un plan payant. Sur un plan gratuit, il revient à Fast.
• Beyond s'est exécuté comme une réponse normale : l'orchestrateur a probablement omis mode. Demandez-lui d'envoyer mode: "beyond", ou dites « utilise Beyond » au tour suivant. Vérifiez beyond_denied_reason si une demande Beyond a été rétrogradée.