SikkerKey

Présentation du serveur MCP

Gérez votre coffre-fort SikkerKey depuis Claude Code, Codex, Cursor et d'autres clients IA compatibles MCP.

Le serveur MCP SikkerKey est un binaire local qui permet à un client IA de gérer votre coffre-fort via des appels d'outils structurés. Il utilise le protocole Model Context Protocol sur stdio et expose 17 outils pour tout ce qu'un agent IA est autorisé à manipuler : applications et projets, métadonnées des secrets, planifications de rotation, politiques d'accès, leurres, machines, agents IA, jetons d'inscription, journal d'audit, alertes, webhooks, liste blanche IP, référence SDK, support et corbeille.

Le serveur MCP s'exécute localement à côté du client IA. Il s'authentifie auprès de SikkerKey à l'aide d'une paire de clés Ed25519 liée à une identité d'agent IA par coffre-fort, le même schéma de requêtes signées que le SDK et la CLI utilisent pour les identités de machine.

Un agent IA est provisionné comme un membre de l'organisation : il détient un ensemble de portées de gestion et un rôle d'accès, et son autorité est limitée en temps réel par le rôle du coffre-fort et le rôle d'accès de l'utilisateur qui l'a créé. Il ne peut jamais faire plus que ce que cet utilisateur peut faire actuellement.

Quand l'utiliser

Utilisez le serveur MCP lorsque vous souhaitez qu'un client IA (Claude Code, Codex, Cursor, etc.) agisse en tant qu'opérateur sur votre coffre-fort : provisionner des machines, placer des leurres, configurer des politiques, auditer l'activité récente, configurer des alertes, rédiger des tickets de support. C'est le plan de gestion.

Utilisez les SDK ou la CLI lorsqu'une application ou un humain a besoin de lire les valeurs en clair des secrets au moment de l'exécution. Le serveur MCP ne peut pas lire le texte en clair. Ces flux sont liés aux identités de machine, qui constituent une classe d'identité distincte.

Ce qu'il peut faire

Outil	Objectif
manage_projects	Parcourir les applications et projets accessibles par l'agent. Lecture seule ; les applications et projets sont créés par le propriétaire du coffre-fort.
manage_secrets	Créer / mettre à jour / faire tourner / restaurer des secrets. Lister les métadonnées. Gérer les planifications de rotation dynamique.
manage_temporary_secrets	Créer des liens de partage uniques autodestructeurs.
manage_policies	Créer des politiques d'accès et les lier aux secrets.
manage_canaries	Placer des secrets leurres défensifs qui gèlent un projet en cas de lecture non autorisée.
manage_machines	Lister, approuver, renommer, révoquer des machines. Voir l'historique des noms.
manage_ai_agents	Gérer d'autres agents IA sur le coffre-fort (cycle de vie uniquement ; les modifications de portée et de rôle d'accès se font uniquement via le tableau de bord).
manage_project_machines	Attacher des machines aux projets, définir des autorisations par secret.
manage_enrollment	Émettre et révoquer des jetons d'inscription pour les machines éphémères.
manage_trash	Lister, restaurer ou purger les secrets supprimés de manière réversible.
manage_alerts	Configurer les actions d'audit qui déclenchent l'envoi d'alertes.
manage_webhooks	Gérer les canaux de livraison sortants des webhooks.
manage_ipallowlist	Configurer la liste blanche IP pour l'authentification des machines.
read_audit	Interroger le journal d'audit, exporter en CSV, voir les statistiques et l'activité récente.
support	Ouvrir et répondre aux tickets de support, gérer les pièces jointes.
manage_sdks	Consulter les SDK d'exécution de SikkerKey : commandes d'installation, prérequis d'exécution, extraits de démarrage rapide.
whoami	Décrire l'agent appelant : ses portées de gestion, son rôle d'accès et son activité récente.

Ce qu'il ne peut pas faire

La surface MCP est aveugle en lecture sur les valeurs des secrets stockés. Aucune de ces actions n'est accessible via un outil :

• Lire le texte en clair d'un secret existant.
• S'authentifier en tant qu'identité de machine pour lire les secrets via la surface SDK/CLI.
• Modifier les portées de gestion ou le rôle d'accès d'un autre agent IA (tableau de bord uniquement, pour empêcher l'escalade de privilèges entre agents).
• Provisionner de nouvelles machines via le flux de téléchargement du trousseau de clés (l'émission de jetons est exposée ; le téléchargement du trousseau est une classe de confiance supérieure et reste réservé au tableau de bord).
• Émettre de nouveaux jetons d'amorçage d'agent IA (également réservé au tableau de bord).
• Détruire un coffre-fort, gérer la facturation, modifier l'authentification du compte ou accepter des invitations sur le coffre-fort de quelqu'un d'autre.

Les actions d'écriture comme manage_secrets.create et update_value acceptent une entrée en clair de l'IA, la chiffrent côté serveur avec un chiffrement par enveloppe et ne renvoient jamais la valeur. La réponse contient uniquement un identifiant et une version. Voir le Modèle de sécurité pour le contrat complet sur le texte en clair.

Compatibilité

Le serveur MCP utilise la version de protocole 2025-11-25 et fonctionne avec tout client implémentant MCP sur stdio. Clients testés :

• Claude Code (CLI Anthropic)
• Codex CLI (OpenAI)
• Cursor
• Continue

Le binaire est livré sous la forme d'un seul exécutable Go lié statiquement, sans dépendances d'exécution. Voir Configuration pour l'installer et l'enregistrer auprès de votre client.

Source

Le serveur MCP est open source. Le code source Go complet est sur GitHub, publié sous licence MIT.

En quoi un agent IA diffère d'une machine

Un coffre-fort SikkerKey possède deux classes d'identité qui s'authentifient avec des requêtes signées Ed25519 :

• Les machines consomment des secrets. Elles figurent dans la table des machines, sont ajoutées aux projets, se voient accorder l'accès à des secrets spécifiques et s'authentifient auprès de la surface SDK / CLI pour lire le texte en clair au moment de l'exécution.
• Les agents IA gèrent le coffre-fort. Ils figurent dans une table d'agents IA distincte, sont provisionnés comme un membre de l'organisation (un ensemble de portées de gestion plus un rôle d'accès qui délimite leur portée de projet) et s'authentifient auprès des routes /v1/ai/... qui ne renvoient jamais de texte en clair.

Les deux tables sont physiquement distinctes dans la base de données. Il n'existe aucun chemin via la surface MCP pour s'authentifier en tant que machine, et les recherches d'authentification de machine ne voient pas les agents IA. Compromettre l'identité d'un agent IA donne à l'attaquant les capacités de gestion de l'agent, et uniquement celles-ci. Cela ne donne aucun chemin pour lire les valeurs des secrets stockés, et les capacités elles-mêmes sont limitées en temps réel par ce que l'utilisateur qui a créé l'agent peut faire actuellement (voir Modèle de sécurité).

Prochaines étapes

• Configuration : installer le binaire, provisionner un agent IA, l'enregistrer auprès de votre client IA.
• Référence des outils : chaque outil, action et portée.
• Modèle de sécurité : authentification, autorisation, contrat sur le texte en clair, audit.