Qu'est-ce que le MCP

Le MCP — Model Context Protocol — est une norme ouverte qui permet à un assistant d’IA d’utiliser des services externes. Sans lui, l’assistant ne sait que converser : il peut vous rédiger le texte d’un contrat, mais pas l’envoyer pour signature. Avec lui, il dispose d’outils.

AssinaJá expose un serveur MCP officiel. Une fois la connexion établie, vous pouvez demander à l’assistant, en langage courant, de préparer un document à partir de l’un de vos modèles, de vous dire qui n’a pas encore signé, ou de vous apporter le PDF signé.

Ce que cela change en pratique

Le travail de signature comporte une grande part de répétition : prendre un modèle, remplir les mêmes champs avec des données qui se trouvent ailleurs, choisir les signataires, envoyer, puis vérifier qui manque encore. C’est cet intervalle que le MCP comble.

Vous travaillez là où vous êtes déjà. Si vous préparez une proposition dans une conversation avec l’assistant, le document sort de cette même conversation. Pas d’export, pas de changement d’onglet, pas de fichier à importer à nouveau.

L’assistant lit vos modèles. Il consulte les modèles réels de votre organisation — avec les signataires et les champs à remplir qui y sont définis — au lieu d’inventer un format.

Il sert à poser des questions, pas seulement à agir. « Quels documents attendent une signature depuis plus d’une semaine ? » est une question à laquelle l’assistant répond en consultant la liste réelle.

C’est le même moteur. Les outils MCP appellent les mêmes services que l’API publique — il n’y a pas de seconde implémentation avec des règles différentes. Ce qui est interdit dans l’application reste interdit ici.

Deux façons de se connecter

Façon	Pour qui
OAuth	Assistants web : Claude.ai, ChatGPT, Copilot, Grok
En-tête X-Api-Key	Outils locaux et automatisations : Claude Code, Cursor, CI

Les assistants web ne permettent pas de définir des en-têtes personnalisés ; ils utilisent donc OAuth. Ce sont les connexions décrites dans Connecter Claude.ai et Connecter ChatGPT.

L’adresse du serveur est la même dans les deux cas :

https://app.assinaja.pt/mcp

Outils locaux, par l’en-tête

Pour Claude Code, par exemple, la connexion tient en une seule commande, la clé API étant transmise dans l’en-tête :

claude mcp add --transport http assinaja https://app.assinaja.pt/mcp \
  --header "X-Api-Key: ajk_live_..."

Le modèle de sécurité

C’est ce qui distingue cette intégration, et cela vaut la peine de le comprendre avant de connecter quoi que ce soit.

L’assistant n’accède jamais à votre compte

Même avec OAuth, ce qui est délivré n’est pas un accès à votre compte utilisateur. C’est un accès lié à une clé API précise. La page d’autorisation le dit elle-même :

Cet assistant IA demande l’accès à votre organisation. L’accès passe par une clé API : l’assistant ne pourra faire que ce que cette clé autorise et n’accède jamais à votre compte.

Si la clé ne peut que consulter des documents, c’est tout ce que l’assistant peut faire — il n’a aucun chemin pour atteindre le reste.

L’assistant ne voit que ce que la clé autorise

Le filtrage intervient avant toute décision de l’assistant. Lorsqu’il demande au serveur quels outils existent, la réponse est déjà restreinte par les accès de la clé : un outil hors périmètre n’apparaît pas dans la liste, il n’est pas seulement refusé au moment de l’appel.

En pratique, un assistant connecté avec une clé sans Documents — publier ne sait même pas que la publication est possible.

Autoriser et révoquer un assistant

Avec OAuth, l’assistant ouvre la page d’autorisation d’AssinaJá — Connecter {assistant} à AssinaJá — et l’autorisation se fait en deux étapes :

1. Étape 1 sur 2 — choisissez la clé API à utiliser. La liste n’affiche que les clés actives, en cours de validité, des organisations dont vous êtes le Créateur. S’il n’y en a aucune, la page indique :

   Vous n’avez aucune clé API active.

   Créez-en une dans le backoffice, sous Paramètres → Clés API, puis relancez la connexion.

2. Étape 2 sur 2 — confirmez les accès que vous accordez. La page affiche ce que la clé autorise. Un accès qui n’a pas de libellé propre sur cette page apparaît sous son code technique — par exemple analytics:read ou documents:signurls. Autoriser l’accès termine :

   En confirmant, vous enregistrez le fait d’avoir autorisé {assistant} à utiliser cette clé. Vous pouvez couper l’accès à tout moment en suspendant ou en supprimant la clé dans Paramètres → Clés API.

L’autorisation n’est pas mémorisée : chaque nouvelle connexion repasse par les deux étapes et est enregistrée séparément.

La révocation se fait du côté de la clé, pas de l’assistant : dans Paramètres → Développeurs → Clés API, Suspendre — « Une fois suspendue, la clé ne permet plus de s’authentifier jusqu’à sa réactivation. » — ou Supprimer, qui est définitif. L’effet est immédiat ; voir Couper l’accès est immédiat.

Le consentement est enregistré

Autoriser n’est pas un clic qui se perd. Sont enregistrés : qui a autorisé, quelle clé, quel assistant, quels accès, quand, et depuis quelle adresse. Vous consultez ce registre dans Paramètres → Développeurs → Clés API, section Autorisée pour des assistants IA :

Registre des consentements (preuve). Pour couper l’accès d’un assistant, suspendez ou supprimez la clé.

Couper l’accès est immédiat

La clé est revalidée à chaque requête. Suspendre, laisser expirer ou supprimer la clé coupe l’accès de l’assistant sur-le-champ — inutile d’attendre la fin d’une session.

C’est la réponse au cas le plus inconfortable : si vous avez un doute sur une connexion, suspendez la clé et voyez ce qui cesse de fonctionner. La suspension est réversible.

Les règles que le serveur impose à l’assistant

Le serveur envoie des consignes de sécurité que l’assistant reçoit avant d’agir : les codes de signataire appartiennent au modèle et ne peuvent jamais être inventés ; publier envoie des e-mails immédiatement et ne peut pas être annulé, ce qui exige une confirmation explicite dans la conversation ; et une création échouée n’est jamais relancée à l’aveugle, car un second appel crée un second document et une seconde vague d’e-mails.

Limite d’utilisation

60 requêtes par minute par identifiant, pour tous les outils — y compris ceux qui ne font que consulter. C’est le même compteur que celui des routes de création de documents de l’API publique : un système qui utilise la même clé par l’en-tête X-Api-Key, dans l’API et dans le MCP, partage ces 60. Les autres routes de l’API publique ont leur propre limite, de 300 requêtes par minute, qui ne s’applique pas au MCP.

Ce que l’assistant peut faire

Les outils disponibles dépendent des accès cochés sur la clé. Les noms à droite sont ceux que vous voyez dans l’assistant ; dans un compte en français, ils s’affichent en anglais.

Accès de la clé	L’assistant peut alors
Modèles — consulter	List templates · Get template details
Documents — consulter	List documents · Get document details · Get document overview · Download document file
Documents — liens de signature	Get signing links
Documents — créer	Create document · Create document from template · Create document from Word template · Create upload link · Get upload link status
Documents — publier	Publish draft and notify signers
Documents — archiver/supprimer	Archive document · Delete document
Organisation — consulter	Get organization · Get subscriptions and plan features
Statistiques — consulter	Analytics overview · Usage metrics · Metric over time · Metric breakdown · Signing funnel · Adoption and seats · Metric catalog

L’assistant peut demander une signature simultanée — et ne pas être suivi

Lors de la création d’un document, un assistant peut demander que tous les signataires soient invités en même temps. Cette demande n’est respectée que si l’organisation l’autorise dans Paramètres → Organisation → Politiques → Signatures.

Dans le cas contraire, la demande ne produit pas d’erreur : le document part quand même en mode séquentiel, et c’est la réponse qui indique la valeur effective. C’est pourquoi les outils demandent à l’assistant de lire cette valeur avant de vous dire qui reçoit l’e-mail et quand — s’il vous assure que « tout le monde l’a reçu » sans l’avoir lue, il peut se tromper. Voir Configurer les politiques de l’organisation.

Publier est l’accès qui demande réflexion

Publish draft and notify signers envoie des e-mails et est irréversible. Créer et publier sont des accès distincts à dessein : une clé avec créer mais sans publier laisse l’assistant tout préparer et oblige une personne à appuyer sur le bouton. La combinaison recommandée pour une première connexion se trouve dans Créer une clé API.

Les fichiers qui se trouvent sur votre ordinateur

L’assistant ne peut pas aller chercher des fichiers sur votre disque. Lorsqu’il en a besoin, il crée un lien de dépôt — vous l’ouvrez, vous importez le fichier, et il poursuit. Voir Remettre un fichier à un assistant.

Les limites

Les statistiques sont désactivées par défaut. Qu’un assistant puisse lire les chiffres de l’organisation est une décision distincte, prise dans Paramètres → Organisation → Politiques → Automatisation, section Accès de l’IA aux statistiques :

Indique si les assistants connectés via MCP peuvent consulter les chiffres de cette organisation. Désactivé par défaut. Ne donne jamais accès aux documents, aux contenus ni aux clés — uniquement aux indicateurs agrégés, et chaque consultation est enregistrée dans l’audit.

Les deux sont nécessaires

La politique active la lecture pour l’organisation ; l’accès Statistiques — consulter l’active pour une clé précise. Si l’un des deux manque, les sept outils n’apparaissent même pas dans la liste que voit l’assistant — ils n’échouent pas à l’appel, ils sont invisibles.

C’est délibéré : un assistant ne peut pas demander ce dont il ignore l’existence.

Un assistant peut se tromper. Lire les bons documents et mal les résumer est une erreur possible, et le MCP ne la résout pas. Pour ce qui compte, vérifiez dans l’application avant d’envoyer.

Ce qu’il fait l’est en votre nom. Les documents sont créés dans votre organisation et consomment vos quotas.

Voir aussi

• Connecter Claude.ai à AssinaJá
• Connecter ChatGPT à AssinaJá
• Créer une clé API
• Configurer les politiques de l’organisation — le paramètre qui fait démarrer en brouillon les documents créés par l’IA