Serveur MCP
Le serveur MCP de Contracko connecte votre espace de travail contractuel à l'assistant IA que vous utilisez déjà. Demandez à Claude, ChatGPT, Gemini ou Copilot des informations sur vos contrats, et ils lisent les données réelles : parties, dates, montants et les documents eux-mêmes. Donnez-leur un accès en écriture, et ils peuvent importer des contrats, créer des rappels et déposer de nouveaux accords pour vous.
Vous gardez le contrôle. La lecture et l'écriture sont des permissions distinctes, vous choisissez lesquelles accorder, et vous pouvez vous déconnecter à tout moment.
Se connecter en deux étapes
- Ajoutez les skills pour que l'assistant sache comment vous aider avec vos contrats. Les skills sont quatre courts guides publiés sur contracko/contracko-skills.
- Ajoutez la connexion pour qu'il puisse accéder à votre espace de travail. Collez cette adresse quand on vous la demande :
https://app.contracko.com/mcp
Une fenêtre de navigateur s'ouvre. Connectez-vous à Contracko, ou démarrez un essai gratuit sur cet écran si vous n'avez pas encore de compte.
Ajouter les skills ne connecte pas votre espace de travail en soi. Si Contracko apparaît déjà dans la liste de connecteurs de votre assistant, passez l'étape 2 plutôt que de l'ajouter deux fois. Vous utilisez Claude ou Claude Code ? Suivez plutôt les étapes Claude dans Connecter votre assistant : Contracko figure dans l'annuaire des connecteurs de Claude.
Lorsque vous vous connectez, cochez Lecture pour que l'assistant puisse répondre à vos questions. Cochez Écriture seulement s'il doit ajouter ou modifier des contrats. Laissez Écriture décoché sauf si vous le souhaitez.
Choisir un accès en lecture ou en écriture
| Permission | Ce qu'elle permet | Quand l'accorder |
|---|---|---|
| Lecture | Trouver des contrats, lire les dates, montants et parties extraits, effectuer des recherches dans les documents, consulter l'analyse IA et les commentaires | Toujours. Cela suffit pour poser des questions sur votre espace de travail. |
| Écriture | Importer des contrats, mettre à jour des champs, ajouter des documents et des commentaires, créer des types de contrats et des contreparties, créer, renommer et déplacer des dossiers, classer des contrats dans les dossiers que vous pouvez voir, définir et modifier des rappels | Uniquement lorsque vous voulez que l'assistant apporte des modifications. Commencez sans elle. |
Avec Lecture, l'assistant peut aussi vous indiquer qui peut accéder à un contrat ou un dossier. Vous pouvez aussi limiter les recherches de contrats à un dossier que vous pouvez voir. Modifier les accès et supprimer des dossiers se fait uniquement dans l'application Contracko. Demandez à l'assistant de confirmer les modifications proposées avant de les effectuer. Il agit en votre nom et ne peut donc accéder qu'aux contrats et dossiers auxquels vous avez accès dans les limites des permissions de votre espace de travail. Voir les permissions sur les contrats pour savoir comment l'accès est déterminé.
Ceci est différent de Clara AI, qui fonctionne à l'intérieur de Contracko. Utilisez Clara dans l'application, et connectez-vous via MCP quand vous voulez travailler depuis Claude, ChatGPT ou un autre assistant déjà ouvert.
Trouvez les contrats dont vous avez besoin
Demandez un fournisseur, un type de contrat, un statut, une période de dates de fin ou de dates de préavis. Votre assistant peut affiner la liste des contrats avant de lire les résultats. Par exemple : « Quels contrats Acme se terminent ou nécessitent un préavis au prochain trimestre ? » Si plusieurs fournisseurs ont le même nom, confirmez celui que vous souhaitez.
Votre assistant doit vérifier chaque page de contrats correspondants avant de signaler que le résultat est complet. Les recherches par date excluent les contrats sans date correspondante. Demandez donc séparément les dates manquantes. Une date de fin seule ne signifie pas qu'un contrat est reconduit automatiquement. Les questions sur les montants, devises, champs manquants ou clauses peuvent demander des vérifications supplémentaires.
Utilisez votre connexion existante
OAuth est la méthode par défaut pour connecter Contracko à votre assistant. Vous n'avez pas besoin d'une nouvelle connexion, d'une clé API de remplacement ou de permissions supplémentaires pour utiliser une recherche améliorée dans les outils que vous avez déjà. Si votre assistant affiche encore d'anciennes options, actualisez ses outils ou reconnectez le connecteur existant.
Si OAuth n'est pas disponible, vous pouvez utiliser une clé API MCP dédiée. Envoyez-la avec chaque requête dans l'en-tête Authorization: Bearer <votre-clé-API-MCP>. Conservez cette clé en lieu sûr et ne la partagez pas.
Les actions disponibles dépendent de votre connexion et des permissions de votre espace de travail. Gardez Lecture pour les questions. Accordez Écriture seulement si vous voulez que l'assistant effectue des modifications. Si une action manque, vérifiez l'espace de travail sélectionné et les permissions de la connexion, ou contactez le support.
Vérifiez les modifications incertaines avant de réessayer
Si votre assistant ne peut pas confirmer qu'une modification a réussi, vérifiez le contrat dans Contracko avant de réessayer. Une erreur ne signifie pas toujours que rien n'a changé.
Les agents et les développeurs trouveront les arguments des outils et des conseils pour traiter les réponses dans les instructions de configuration pour les agents.
Connecter votre assistant
Choisissez le produit que vous utilisez. Chaque parcours se termine de la même façon : connectez-vous via la fenêtre de navigateur qui s'ouvre.
Claude
Pour Claude sur le web, sur ordinateur, sur mobile et dans Cowork.
- Ouvrez Contracko dans l'annuaire des connecteurs de Claude.
- Choisissez Connect to Claude.
- Connectez-vous à Contracko dans la fenêtre qui s'ouvre.
Cela fonctionne avec tous les forfaits Claude, y compris Free. Sur Team et Enterprise, un Owner doit d'abord l'activer. Un connecteur ajouté sur le web ou sur ordinateur fonctionne aussi dans l'application mobile Claude.
À partir de Pro, vous pouvez aussi installer le plugin Contracko (Customize → Plugins) pour les quatre skills contractuels, puis vous connecter depuis son onglet Connectors.
Vous aviez ajouté Contracko comme connecteur personnalisé ? Supprimez-le, sinon chaque outil apparaîtra en double.
ChatGPT
- Allez dans Settings → Plugins → Import marketplace et saisissez
contracko/contracko-skills. - Activez le Developer mode.
- Allez dans Settings → Apps → Create et collez
https://app.contracko.com/mcp. - Connectez-vous dans la fenêtre qui s'ouvre.
Grok
- Ouvrez grok.com/connectors.
- Ajoutez
https://app.contracko.com/mcp. - Connectez-vous dans la fenêtre qui s'ouvre.
Claude Code
Connecté avec votre compte Claude ? Un connecteur ajouté dans Claude est déjà disponible ici, il n'y a rien à ajouter.
Pour les skills, installez le plugin. Il enregistre aussi la connexion :
/plugin marketplace add https://github.com/contracko/contracko-skills.git
/plugin install contracko@contracko
Utilisez l'adresse GitHub complète, pas un nom court owner/repo. Tapez ensuite /mcp dans la session et connectez-vous.
Vous utilisez une clé API sans le plugin ? Exécutez ceci uniquement si claude mcp list n'affiche aucune entrée Contracko :
claude mcp add --transport http contracko https://app.contracko.com/mcp
Tapez ensuite /mcp et connectez-vous.
Codex
npx skills@latest add contracko/contracko-skills
codex mcp add contracko --url https://app.contracko.com/mcp
codex mcp login contracko
Cursor
npx skills@latest add contracko/contracko-skills
Puis ajoutez ceci à .cursor/mcp.json dans votre projet, en créant le fichier s'il n'existe pas :
{ "mcpServers": { "contracko": { "url": "https://app.contracko.com/mcp" } } }
Redémarrez Cursor s'il ne détecte pas la connexion.
GitHub Copilot dans VS Code
npx skills@latest add contracko/contracko-skills
Puis ajoutez ceci à .vscode/mcp.json :
{ "servers": { "contracko": { "type": "http", "url": "https://app.contracko.com/mcp" } } }
Gemini CLI
npx skills@latest add contracko/contracko-skills
Puis ajoutez ceci à ~/.gemini/settings.json :
{ "mcpServers": { "contracko": { "httpUrl": "https://app.contracko.com/mcp" } } }
OpenClaw
npx skills@latest add contracko/contracko-skills
openclaw mcp set contracko '{"url":"https://app.contracko.com/mcp","transport":"streamable-http"}'
openclaw mcp configure contracko --auth oauth
openclaw mcp login contracko
Hermes
npx skills@latest add contracko/contracko-skills
Puis ajoutez ceci à ~/.hermes/config.yaml :
mcp_servers:
contracko:
url: "https://app.contracko.com/mcp"
auth: oauth
Exécutez hermes mcp login contracko et connectez-vous.
Tout autre assistant
Collez ceci dans l'assistant et laissez-le suivre les instructions :
Fetch and execute https://contracko.com/mcp/install/prompt.md
Si vous préférez ajouter la connexion vous-même, l'adresse reste https://app.contracko.com/mcp.
À essayer
Une fois connecté, parlez à l'assistant comme vous le feriez avec un collègue.
| À essayer | Ce que ça fait |
|---|---|
| On est en train d'onboarder ce client. Importe tous les PDF de ce dossier dans Contracko. | Trouve les fichiers, vérifie l'ensemble avec vous, les importe, et laisse Contracko extraire les dates, parties et types. |
| Je ne veux pas de renouvellement tacite. Qu'est-ce qui nécessite un préavis, se termine ou se renouvelle automatiquement au prochain trimestre ? Mets des rappels pour tout ça. | Liste les dates importantes, puis crée des rappels pour que vous soyez notifié à temps. |
| Compare le MSA d'Acme à celui de Beta. Qui a le meilleur plafond de responsabilité, les meilleures conditions de résiliation et de traitement des données ? | Met les deux contrats côte à côte, avec les clauses citées. |
| Audite nos contrats fournisseurs pour repérer une responsabilité illimitée, des indemnisations à sens unique et des préavis manquants. | Passe le portefeuille en revue et cite la phrase derrière chaque constat. |
| Notre classement est un vrai bazar. Aide-moi à définir une structure de dossiers pour les MSA, NDA, SOW et DPA, puis crée-la et classe nos contrats dedans. | Confirme la structure avec vous, puis crée les dossiers et classe les contrats auxquels vous avez accès. Il organise aussi les types, champs et contreparties que vous utilisez. |
| Sur quoi devrait-on se concentrer ce mois-ci ? Qu'est-ce qui est urgent, et qu'est-ce qu'on rate ? | Classe l'espace de travail par urgence et par lacunes. |
| Guide-moi pour un nouveau NDA, envoie-le pour signature, et dépose le PDF signé quand il revient. | Exécute le questionnaire, puis dépose la copie signée. |
Vous n'avez pas besoin de nommer un skill. Formuler la demande en langage courant suffit.
Ce que font les skills
| Skill | À utiliser pour |
|---|---|
contracko | Se connecter, puis organiser les types de contrats, les champs personnalisés, les contreparties et les dossiers |
contracko-import | Importer des PDF et des fichiers Word depuis le disque, Drive, SharePoint, Box ou un lien |
contracko-review | Les dates de préavis, les rappels, les comparaisons, le langage à risque, et ce qu'il faut regarder ensuite |
contracko-create | Un nouvel accord, des questions jusqu'au dépôt du PDF signé |
Se connecter avec un token à la place
Utilisez la connexion dans le navigateur (OAuth) pour la plupart des connexions. Si votre client ou votre automatisation ne peut pas l'utiliser, créez une clé API MCP dédiée dans Contracko : Settings → Integrations → API keys. Configurez votre client pour l'envoyer dans un en-tête Authorization: Bearer à https://app.contracko.com/mcp. Conservez la clé dans les réglages secrets du client, et non dans un chat ou des fichiers partagés. Les deux méthodes suivent l'accès que vous accordez et les permissions de votre espace de travail.
Gérer les connexions dans Contracko
Après votre approbation, l'assistant apparaît sous MCP Connections dans Settings → Integrations. Vous voyez qui a établi la connexion, quel accès elle a, et quand elle a été utilisée pour la dernière fois.
Vous pouvez déconnecter n'importe quelle connexion listée. Seule la personne qui l'a établie peut approuver un accès OAuth supplémentaire. Seuls les propriétaires et les admins peuvent créer, modifier ou révoquer des API keys.
Consulter une connexion
- Ouvrez Settings, puis Integrations.
- Trouvez l'assistant sous MCP Connections.
- Ouvrez le menu de la ligne et choisissez Manage connection.
La fenêtre affiche Connected by, Last used et Current access.
Déconnecter un assistant
- Choisissez Disconnect dans le menu de la ligne, ou ouvrez Manage connection et utilisez le bouton de déconnexion.
- Confirmez Disconnect.
Cet assistant perd l'accès à cet espace de travail. Les autres connexions restent en place. Retirez aussi le connecteur dans l'assistant, sinon il vous demandera de vous reconnecter.
Modifier l'accès ou renouveler l'autorisation
Vous ne pouvez pas changer les droits OAuth depuis cet écran. Pour modifier Read ou Write, reconnectez-vous depuis l'assistant et approuvez à nouveau les permissions.
- Dans Contracko, ouvrez Manage connection et choisissez Connection setup si vous avez besoin de l'adresse MCP ou des étapes du client.
- Dans l'assistant, reconnectez Contracko et connectez-vous.
- Sur l'écran d'approbation, cochez Read. Cochez Write seulement si l'assistant doit modifier des contrats.
- Choisissez Disconnect pour l'ancienne connexion dans Contracko, afin que le même assistant n'apparaisse pas deux fois.
Se reconnecter est aussi la façon de renouveler l'autorisation OAuth. Il n'y a pas de bouton distinct pour renouveler le token.
Renouveler ou révoquer une clé API
Les connexions par token se gèrent dans API keys sur la même page, pas dans MCP Connections.
- Créez une nouvelle clé MCP server si vous avez encore besoin d'un token. Copiez le secret une seule fois.
- Placez le nouveau secret dans l'en-tête
Authorization: Bearerdu client. - Ouvrez l'ancienne clé et choisissez Revoke key.
Manage key permet d'ajouter de l'accès sans changer le secret. Les clés expirent au bout de 12 mois.
Résoudre les problèmes courants
« Votre connexion Contracko doit être renouvelée. » La connexion a expiré. Reconnectez-vous depuis les paramètres de connecteurs de votre assistant et connectez-vous à nouveau.
L'assistant dit qu'il ne trouve pas d'outil. Vérifiez l'espace de travail sélectionné et les permissions de la connexion, puis actualisez les outils de l'assistant. Accordez Écriture seulement si vous voulez qu'il effectue des modifications. Contactez le support si l'action manque toujours.
L'assistant ne voit pas un contrat que vous pouvez voir. Vérifiez que vous êtes connecté au bon espace de travail, et que le contrat est partagé avec vous dans Contracko.
Contracko apparaît en double. Vous avez deux connexions au même serveur. Dans Claude, supprimez le connecteur personnalisé ajouté plus tôt et gardez celui de l'annuaire des connecteurs. Dans Claude Code, si vous avez installé le plugin et aussi exécuté claude mcp add, exécutez claude mcp remove contracko. Dans les autres assistants, supprimez le connecteur en double. Ajouter les skills et ajouter la connexion sont deux étapes distinctes, et ajouter la connexion deux fois crée deux entrées.
Avant de partager de vrais contrats
Contracko n'entraîne pas de modèles sur vos contrats, et notre analyse fonctionne sous des conditions d'API commerciales avec Zero Data Retention lorsque disponible.
Connecter un assistant est différent. Quand Claude, ChatGPT ou un autre produit appelle Contracko, le texte de votre contrat est envoyé à ce produit, et Contracko ne peut pas contrôler ce qui s'y passe ensuite. Désactivez l'entraînement de modèle dans ce produit avant de l'utiliser avec de vrais contrats. Voir Sécurité pour savoir comment nous traitons vos données de notre côté.
Obtenir de l'aide
Pour des questions sur Contracko lui-même, consultez la documentation ou contactez-nous.
Pour une question sur les skills, une suggestion ou une amélioration, ouvrez une issue sur le dépôt des skills.
Si vous voulez la version lisible par machine de cette documentation pour un agent ou un robot d'indexation, voir accès agent LLM.