Documentation › Escouade
Les MCP d’Escouade
Escouade a trois serveurs MCP. Votre assistant (Claude, ChatGPT, ou tout client MCP) s’y branche par une adresse, avec votre connexion au compte Escouade, et agit avec vos droits : il lit ce que vous lisez, écrit ce que vous pouvez écrire, et chaque écriture porte votre signature.
Les trois serveurs
| Serveur | Adresse | Pour | Tailles |
|---|---|---|---|
| Lecture | https://app.escouade.io/mcp | Chercher, lire et résumer les fiches, les documents et les e-mails. | Toutes |
| Écriture | https://app.escouade.io/mcp/ecriture | Créer et modifier des fiches au nom du membre connecté ; chaque écriture est journalisée. | Toutes |
| Intégrateur | https://app.escouade.io/mcp/integration | Régler le modèle, les objets et l’espace, comme un administrateur à l’écran. | Pro et Max |
Les trois se branchent côte à côte : la lecture d’abord, l’écriture quand l’assistant doit agir, l’intégrateur pour paramétrer.
Brancher un serveur
Dans Claude (claude.ai, et l’application de bureau, qui reprend les connecteurs du compte) :
- Ouvrez les connecteurs de Claude, puis « Ajouter un connecteur personnalisé ».
- Donnez-lui un nom (« Escouade lecture », par exemple) et collez l’adresse.
- « Se connecter » : connectez-vous avec votre compte Escouade, choisissez l’organisation, autorisez.
Dans une organisation Claude Team ou Enterprise, c’est un propriétaire qui ajoute le connecteur ; chaque membre s’y connecte ensuite lui-même.
Dans ChatGPT : ses paramètres, puis les connecteurs, avec le mode développeur activé ; créez un connecteur avec l’adresse et l’authentification OAuth, puis connectez-vous avec votre compte Escouade. Les intitulés de ChatGPT changent souvent : seule l’adresse compte.
Dans Claude Code :
claude mcp add --transport http escouade https://app.escouade.io/mcp
puis /mcp dans une session pour vous connecter.
Les adresses de tous les serveurs de la famille sont aussi sur la page Connecteurs du compte, et sur Les MCP de la famille.
Les outils
Sur app.escouade.io, les outils portent le préfixe escouade_. Sur une instance Escouade hub, ils portent le nom de l’instance.
Lecture
| Outil | Ce qu’il fait |
|---|---|
escouade_trouver | Cherche partout à la fois (fiches, documents, e-mails, faits datés), par les mots et par le sens, avec des filtres, et rend une sélection. |
escouade_selection | Lit la suite d’une sélection, ou l’affine, sans relancer la recherche. |
escouade_consulter | Ouvre un élément par son identifiant : son résumé, sa fiche complète ; pour un document, son texte, une recherche dans le document, ses passages voisins ou un lien de téléchargement. |
escouade_relations | Ce qui entoure une fiche : fiches liées, chronologie, pièces, e-mails, et l’historique (qui a changé quoi). |
escouade_modele | Décrit les objets et leurs champs, relus à chaque appel : c’est lui qui fait foi quand le modèle a changé. |
Le serveur de lecture dit au nom de qui il répond (« Connecté en tant que … ») : un vrai appel montre si le connecteur a été branché sous le bon compte.
Écriture
| Outil | Ce qu’il fait |
|---|---|
escouade_ecrire | Crée, modifie, lie, délie, met à la corbeille et restaure des fiches. Une création pose ses liens dans le même appel. Chaque appel porte une clé unique : rejoué, il n’écrit pas deux fois. |
escouade_envoyer | Envoie un e-mail depuis votre boîte connectée, avec une copie cachée possible, puis le rattache aux fiches choisies et y laisse une note « Relance envoyée ». |
escouade_journal | Le journal des écritures faites par les assistants : qui a écrit quoi, quand, par où, avec quel résultat, le plus récent d’abord. Il se lit par un administrateur. |
escouade_modele | Les champs d’un objet, à lire avant d’écrire. |
escouade_artefact | Envoie dans Escouade une page créée dans Claude, ou une nouvelle version, puis la partage à un membre. |
Les identifiants viennent du serveur de lecture : celui d’écriture ne cherche pas par texte. Un refus nomme le problème : l’assistant corrige son appel plutôt que de deviner.
L’envoi d’e-mails est fermé par défaut. Un administrateur l’ouvre rôle par rôle, dans Réglages › MCP, onglet Écriture (« Envoyer des courriels »). Claude demande confirmation avant chaque envoi, et un envoi ne part jamais deux fois sous la même clé.
Intégrateur
| Outil | Ce qu’il fait |
|---|---|
escouade_superviser | L’ingestion : les traces, la file « À traiter », les scénarios, les seuils, les alertes, le banc du modèle décisionnel. |
escouade_parametrer | Le modèle de données et tous les réglages de l’espace, par les mêmes fonctions et sous les mêmes gardes qu’à l’écran. Il teste aussi les accès d’une personne, liste les connexions de Claude, partage une fiche ou une boîte. |
escouade_ecrire | Les données de tout objet. |
escouade_modele | Les objets et leurs champs. |
escouade_artefact | Les artefacts de l’espace. |
L’intégrateur est le serveur du paramétrage : un administrateur règle par lui ce qu’il réglerait à l’écran, sans toucher à la base. Il est compris à partir de Pro.
Sous quels droits
- Par Claude, chacun a exactement ses droits de l’application : ce que son rôle, ses groupes et ses exceptions lui ouvrent, et rien de ce qui lui est retiré (un champ masqué reste masqué).
- Le réglage des serveurs MCP s’ajoute par-dessus, dans Réglages › MCP : quels rôles ont quel serveur, à quel niveau, objet par objet.
- Chaque écriture porte la signature du membre connecté et laisse une ligne au journal.
- Une connexion de Claude inutilisée pendant 14 jours s’efface d’elle-même ; chaque usage la prolonge. Au retour, Claude redemande simplement votre accord.
Le journal des appels
Chaque appel aux serveurs MCP (lecture, écriture, intégrateur), refus et appels abandonnés compris, est gardé six mois : qui, depuis quel appareil, quel outil, quel résultat. Un administrateur le lit par l’intégrateur.
Le protocole
Les serveurs parlent MCP en Streamable HTTP. L’autorisation suit la partie OAuth de la spécification MCP : un client n’a besoin que de l’adresse ; il découvre le serveur d’autorisation par les métadonnées de la ressource protégée, et la personne se connecte par le compte Escouade.