Utilisation

Sécurité : Pour vérifier l’authenticité du conteneur et inspecter son SBOM, consultez le Guide d’attestation & vérification.

Qu’est-ce que MCP ?

Le Model Context Protocol (MCP) est un protocole ouvert qui standardise la façon dont les assistants IA communiquent avec les sources de données et les outils. Le serveur MCP Subnoto implémente ce protocole pour permettre aux assistants IA comme Claude Desktop et Cursor d’interagir avec les services de signature de Subnoto.

Outils IA pris en charge

Claude Desktop

Ajoutez à votre configuration Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json sur macOS, %APPDATA%\Claude\claude_desktop_config.json sur Windows) :

{
    "mcpServers": {
        "subnoto": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "MCP_TRANSPORT",
                "-e",
                "API_ACCESS_KEY",
                "-e",
                "API_SECRET_KEY",
                "subnoto/mcp-server:latest"
            ],
            "env": {
                "MCP_TRANSPORT": "stdio",
                "API_ACCESS_KEY": "votre_clé_d_accès_ici",
                "API_SECRET_KEY": "votre_clé_secrète_ici"
            }
        }
    }
}

Cursor IDE

Ajoutez à votre configuration MCP Cursor (~/.cursor/mcp.json) :

{
    "mcpServers": {
        "subnoto": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "MCP_TRANSPORT",
                "-e",
                "API_ACCESS_KEY",
                "-e",
                "API_SECRET_KEY",
                "subnoto/mcp-server:latest"
            ],
            "env": {
                "MCP_TRANSPORT": "stdio",
                "API_ACCESS_KEY": "votre_clé_d_accès_ici",
                "API_SECRET_KEY": "votre_clé_secrète_ici"
            }
        }
    }
}

Utilisation du conteneur

Transport Stdio (pour les assistants IA)

Le transport stdio est conçu pour l’intégration avec les assistants IA comme Claude Desktop et Cursor :

docker run -i --rm \
  -e MCP_TRANSPORT=stdio \
  -e API_ACCESS_KEY=votre_clé_d_accès_ici \
  -e API_SECRET_KEY=votre_clé_secrète_ici \
  subnoto/mcp-server:latest

Note : Ce mode est interactif et attend des messages du protocole MCP sur stdin. Il est destiné à être utilisé par les outils IA, pas directement par les utilisateurs.

Transport HTTP (pour les applications web)

Pour les intégrations web, utilisez le transport HTTP :

docker run -p 8080:8080 --rm \
  -e API_ACCESS_KEY=votre_clé_d_accès_ici \
  -e API_SECRET_KEY=votre_clé_secrète_ici \
  subnoto/mcp-server:latest

Le serveur MCP sera disponible à http://localhost:8080/mcp.

Utilisateurs Mac (Apple Silicon) : Si vous rencontrez des problèmes de connexion, liez explicitement à localhost et spécifiez la plateforme :

docker run --platform linux/amd64 -p 127.0.0.1:8080:8080 --rm \
  -e API_ACCESS_KEY=votre_clé_d_accès_ici \
  -e API_SECRET_KEY=votre_clé_secrète_ici \
  subnoto/mcp-server:latest

Authentification API

Pour utiliser le serveur MCP, vous avez besoin d’une clé d’accès et d’une clé secrète. Ces identifiants sont fournis lorsque vous créez une clé API dans votre espace de travail Subnoto.

Obtention des identifiants

1. Connectez-vous à votre espace de travail Subnoto sur app.subnoto.com
2. Naviguez vers Paramètres → Clés API
3. Créez une nouvelle clé API
4. Sauvegardez la ACCESS_KEY et la SECRET_KEY en toute sécurité

Outils disponibles

Le serveur MCP expose automatiquement tous les endpoints de l’API publique Subnoto comme outils MCP. Les outils courants incluent :

Gestion de l’espace de travail

• workspace_list - Lister tous les espaces de travail
• utils_whoami - Obtenir les informations d’utilisateur authentifié

Gestion des contacts

• contact_list - Lister les contacts dans un espace de travail
• contact_get - Obtenir un contact spécifique
• contact_create - Créer de nouveaux contacts
• contact_update - Mettre à jour les informations de contact
• contact_delete - Supprimer des contacts

Gestion des modèles

• template_list - Lister les modèles disponibles

Gestion des enveloppes

• envelope_create - Créer une nouvelle enveloppe
• envelope_create-from-template - Créer une enveloppe à partir d’un modèle
• envelope_get - Obtenir les détails d’une enveloppe
• envelope_add-recipients - Ajouter des destinataires à une enveloppe
• envelope_delete-recipients - Supprimer des destinataires d’une enveloppe
• envelope_send - Envoyer une enveloppe aux destinataires
• envelope_get-document - Télécharger un document d’une enveloppe
• envelope_get-proof - Télécharger le document de preuve pour une enveloppe complétée

Variables d’environnement

Le serveur MCP prend en charge les variables d’environnement suivantes :

Variable	Description	Défaut	Requis
MCP_TRANSPORT	Mode de transport : stdio ou http	http	Non
API_ACCESS_KEY	Clé d’accès API Subnoto	-	Oui
API_SECRET_KEY	Clé secrète API Subnoto	-	Oui
API_BASE_URL	URL de base de l’API Subnoto	https://enclave.subnoto.com	Non
DISABLE_ATTESTATION	Désactiver la vérification d’attestation	false	Non
ATTESTATION_PUBLIC_KEYS	Clés publiques d’attestation encodées en base64	-	Non
OPENAPI_PATH	Chemin vers le schéma OpenAPI	/app/public-openapi.json	Non

Exemple d’utilisation avec les assistants IA

Une fois configuré, vous pouvez interagir avec le serveur MCP via votre assistant IA. Par exemple, dans Claude Desktop ou Cursor :

Utilisateur : “Liste tous mes modèles de signature”

Assistant IA : Utilise l’outil template_list pour récupérer les modèles

Utilisateur : “Crée une enveloppe à partir du modèle NDA pour [email protected]”

Assistant IA : Utilise les outils envelope_create-from-template et envelope_add-recipients

Utilisateur : “Envoie l’enveloppe”

Assistant IA : Utilise l’outil envelope_send

Dépannage

Problèmes de connexion

Si le serveur MCP ne parvient pas à se connecter :

1. Vérifiez que vos identifiants API sont corrects
2. Vérifiez que Docker est en cours d’exécution
3. Pour le transport HTTP, assurez-vous que le port 8080 n’est pas déjà utilisé
4. Pour les utilisateurs Mac avec Apple Silicon, utilisez le flag --platform linux/amd64

Découverte d’outils

Pour voir tous les outils disponibles dans votre assistant IA :

• Claude Desktop : Vérifiez la section des outils dans l’interface
• Cursor : Les outils sont automatiquement disponibles lors de l’utilisation de la fonctionnalité de mention @

Prochaines étapes

• Explorez le Helm Chart pour le déploiement Kubernetes
• Apprenez sur l’Attestation & Vérification pour la validation de sécurité
• Visitez la documentation de l’API pour des informations détaillées sur les endpoints