Centre d’aide
Des guides clairs et pratiques pour rédiger, compiler et partager des projets LaTeX et Typst.
Connecter un Agent externe
Laissez un Agent MCP compatible n'intervenir que dans les projets et périmètres choisis.
Connecter une application en se connectant
Les applications qui ajoutent un serveur MCP à partir de sa seule URL, comme Claude, n'ont pas besoin de jeton : elles vous envoient vers JointTex pour vous connecter et donner votre accord.
Étapes
- Dans les paramètres du compte, ouvrez Jetons d'accès et copiez l'URL du serveur MCP.
- Collez-la là où l'application ajoute un serveur. Dans Claude : Personnaliser, Connecteurs, Ajouter un connecteur personnalisé.
- L'application ouvre JointTex dans votre navigateur. Connectez-vous si nécessaire, vérifiez l'adresse vers laquelle la page indique que vous retournerez, choisissez les autorisations et les projets, puis Autoriser.
- L'application apparaît sous Applications connectées dans Jetons d'accès, où vous pouvez restreindre son accès ou la déconnecter.
Créer un jeton MCP
JointTex Éducation, Plus et Pro peuvent connecter des Agents externes compatibles, dont Codex et Claude Code, via le serveur MCP indiqué dans les paramètres du compte.
Étapes
- Dans les paramètres du compte, ouvrez Jetons d’accès, dépliez « Utiliser un jeton MCP » et créez un jeton en sélectionnant uniquement les projets et permissions nécessaires.
- Copiez le jeton une seule fois et configurez votre Agent avec l'URL du serveur MCP affichée et ce jeton en en-tête Authorization Bearer.
- Ou choisissez Copier le prompt de configuration et collez-le dans votre Agent. Le prompt contient le point d'accès et le jeton complet : ne l'envoyez qu'à un Agent en qui vous avez confiance.
- Commencez avec des autorisations en lecture seule. Si l'Agent doit plus tard modifier la source, créez un nouveau jeton avec l'écriture de fichiers : on peut retirer des autorisations à un jeton, mais pas lui en ajouter.
Choisir les autorisations et les projets
Un jeton porte une liste d'autorisations et une liste de projets, et l'Agent ne peut rien faire en dehors de l'une ou de l'autre. Seuls les guides d'aide, publics, se lisent avec n'importe quel jeton.
Étapes
- Les autorisations sont projects:read, projects:create, members:invite, files:read, files:write, review:decide, compile:run, comments:read, comments:write, templates:publish et account:read. Un nouveau jeton commence avec les trois autorisations de lecture, et une autorisation d'écriture entraîne toujours l'autorisation de lecture correspondante.
- Avec projects:create, un Agent peut créer un projet dans votre compte, et avec members:invite inviter quelqu'un par e-mail dans un projet qui vous appartient ; les deux comptent dans les limites de projets et de collaborateurs de votre offre. Aucune n'est cochée sur un nouveau jeton ni ajoutée à un jeton existant : cochez-les seulement si vous voulez que l'Agent le fasse pour vous.
- Avec templates:publish, un Agent peut publier dans la bibliothèque de modèles un projet qui vous appartient, ou republier un modèle que vous avez publié, comme le fait Publier comme modèle ; le modèle est public aussitôt. Elle n'est pas cochée sur un nouveau jeton ni ajoutée à un jeton existant.
- Avec account:read, un Agent peut voir ce que votre compte a déjà configuré, pour vous aider à configurer le reste : votre offre, si Zotero, WebDAV et GitHub sont connectés, combien de jetons Git et MCP vous détenez, vos connecteurs de l’Agent et vos organisations. Il ne voit jamais de clé, de mot de passe ni de jeton. Elle n’est pas cochée sur un nouveau jeton.
- Avec comments:write, un Agent peut ouvrir un fil de révision sur un passage, y répondre, le résoudre ou le rouvrir ; il ne peut pas modifier de commentaires, et ne peut supprimer qu'un fil qu'il a ouvert lui-même.
- Ce qu'un Agent écrit arrive en modifications suivies que les membres du projet relisent, comme les modifications de l'Agent de l'application. Avec review:decide, il peut aussi accepter ou refuser des modifications suivies ; ne la cochez pas si la décision doit rester aux personnes.
- Avec files:write, un Agent peut aussi modifier les réglages de compilation du projet (fichier principal, moteur, version de TeX Live, mode de compilation), qui s'appliquent à tous les collaborateurs. Avec files:read, il peut obtenir un lien pour télécharger le PDF compilé ; le lien fonctionne dix minutes sans connexion et cesse de fonctionner dès que vous déconnectez l'Agent.
- Choisir Tous les projets inclut les projets auxquels vous pouvez accéder maintenant et à l'avenir : désignez donc les projets quand la mission de l'Agent est étroite.
- Un jeton ne dépasse jamais votre propre rôle : dans un projet où vous êtes lecteur, l'Agent ne peut pas écrire, même avec files:write.
Surveiller et révoquer la connexion
Un jeton invisible est un jeton ingouvernable : chaque connexion reste listée et réversible.
Étapes
- Examinez le jeton sous « Utiliser un jeton MCP », dans Jetons d’accès, pour voir les projets et autorisations qu'il peut atteindre.
- Utilisez Modifier l’accès pour changer ses projets ou retirer des autorisations quand le travail évolue, plutôt que d'émettre un jeton plus large. Ajouter une autorisation nécessite un nouveau jeton MCP.
- Révoquez-la dès qu'elle n'est plus utile ; la révocation prend effet immédiatement.
- Ce qu'écrit un Agent externe apparaît dans l'historique du projet comme toute autre modification : vous pouvez le relire ou le restaurer.
- Vous pouvez conserver jusqu'à 10 jetons MCP. Si votre offre descend en dessous d'Éducation, Plus ou Pro, les jetons existants restent enregistrés mais sont mis en pause.