Connectez votre assistant IA (MCP)
Transept propose un point de terminaison MCP auquel les assistants IA se connectent directement. Une fois connecté, un assistant peut piloter l'intégralité du cycle (importer des documents, exécuter des workflows multilingues, gérer les glossaires et les guides de style, lire les résultats) tandis que vos autorisations et votre solde de mots restent sous votre contrôle.
Sur cette page
Qu'est-ce que le point de terminaison MCP ?
Le MCP (Model Context Protocol) est le standard utilisé par les assistants IA pour solliciter des outils externes. Transept publie un point de terminaison unique pour ce protocole, https://app.transept.ai/api/public/v1/mcp ; un assistant qui y est connecté dispose des mêmes capacités qu'un script utilisant l'API, sous forme d'outils qu'il peut appeler de manière autonome : créer un document, estimer le coût d'un traitement, le lancer, en suivre l'état et récupérer les traductions.
La différence concrète par rapport au copier-coller de texte dans un chatbot : l'assistant travaille sur vos documents réels, en appliquant vos glossaires, vos guides de style et votre mémoire de traduction. Les résultats arrivent directement dans Transept, où vous pouvez les réviser et les exporter comme n'importe quel autre travail.
Comment connecter Claude Code, Claude Desktop ou Cursor ?
La connexion utilise le protocole standard OAuth : ajoutez l'URL à votre client, et la première connexion ouvrira une fenêtre de navigateur vous demandant d'autoriser l'accès. Approuvez la demande et le client est lié ; il n'y a aucune clé à coller. Des extraits de code prêts à l'emploi pour chaque client sont disponibles sur la page Intégrations de l'application.
| Client | Configuration |
|---|---|
| Claude Code | Exécutez claude mcp add --transport http transept https://app.transept.ai/api/public/v1/mcp dans un terminal |
| Claude Desktop | Settings → Connectors → Add custom connector, collez l'URL du point de terminaison |
| Cursor | Ajoutez un serveur avec "url": "https://app.transept.ai/api/public/v1/mcp" à son fichier mcp.json |
| Tout autre client | Tout client MCP communiquant via HTTP en streaming : dirigez-le vers la même URL |
Ai-je besoin d'une clé API ?
Pas pour les clients interactifs : OAuth s'en charge. Les clés sont destinées aux machines qui ne peuvent pas ouvrir de navigateur. Dans tous les cas, la connexion apparaît sous Settings → Developer comme une entrée révocable ; la déconnexion se fait donc en un clic, peu importe la méthode utilisée.
| Ce que vous connectez | Authentification à utiliser |
|---|---|
| Un assistant avec lequel vous interagissez (Claude, Cursor) | OAuth : consentement via le navigateur à la première connexion, rien à copier-coller |
| CI, un serveur, un agent headless | Une clé API provenant de Settings → Developer, envoyée dans un en-tête Authorization: Bearer |
Que peut faire l'assistant concrètement ?
Les outils couvrent l'intégralité du cycle : une seule conversation peut ainsi mener un document de l'importation jusqu'aux traductions révisées :
- Importez du contenu : documents par copier-coller ou catalogue de chaînes avec clés, contextes et espaces réservés.
- Estimer gratuitement le coût de n'importe quel traitement, puis lancer un workflow simultanément pour toutes les langues cibles et suivre l'avancement langue par langue.
- Créer et enrichir des glossaires, consulter les guides de style et interroger la mémoire de traduction avant de traduire.
- Récupérer les résultats : par bloc pour la prose, ou indexés par identifiant de chaîne pour les catalogues.
- Enregistrer des webhooks pour que vos propres systèmes reçoivent un événement signé à la fin d'un traitement.
- Ce qui reste exclu, par conception : les imports de fichiers et les exports binaires (DOCX, XLIFF, TMX) s'effectuent via l'API REST, et la gestion des clés demeure une action humaine dans l'application ; un assistant ne peut jamais générer sa propre clé.
Comment mes dépenses sont-elles protégées ?
Trois garde-fous, tous appliqués côté Transept plutôt que de s'en remettre à l'assistant :
- Permissions. Chaque appel d'outil est vérifié au regard des autorisations accordées : les périmètres (scopes) de la clé ou du consentement OAuth. Tout appel sortant de ce cadre est refusé, en précisant la permission manquante.
- Estimation, puis confirmation. Toute opération susceptible de consommer des mots renvoie d'abord une estimation du nombre de mots et s'arrête là. Le traitement ne démarre que si l'assistant confirme explicitement, ce qui vous permet de voir le prix dans la conversation avant qu'il ne soit engagé. Les étapes de révision de vos workflows mettent toujours le traitement en pause ; pour continuer, une approbation explicite est requise, de votre part ou de celle de l'assistant sur votre instruction.
- Révocation. La connexion peut être coupée de votre côté à tout moment : le prochain appel d'un assistant révoqué est refusé, qu'une conversation soit en cours ou non.
Le contenu peut-il circuler sans que j'aie à ouvrir l'application ?
Oui : associez la connexion à un déclencheur de webhook et la boucle est bouclée. Votre plateforme d'e-mailing, votre CMS ou un script envoie (POST) le contenu à l'URL de déclenchement (le corps de la requête devient le document), le workflow le traduit, puis un webhook ou l'assistant récupère les traductions terminées : dix langues en sortie pour un seul modèle en entrée, sans que personne n'ait à ouvrir l'éditeur.
C'est le mécanisme qui sous-tend la localisation de modèles d'e-mails et la gestion continue des catalogues de chaînes : la plateforme transmet les modifications, Transept retraduit uniquement ces éléments, et votre pipeline récupère les résultats. Votre rôle se limite à la révision — tout l'aspect mécanique est délégué.
L'assistant peut-il consommer mes mots sans me le demander ?
Non. Tout outil susceptible de lancer un traitement facturé répond d'abord par une estimation du nombre de mots et ne fait rien d'autre ; l'assistant doit confirmer explicitement avant que le traitement ne démarre, et la confirmation est visible dans votre chat. Les actions gratuites (importation, estimation, lecture des résultats) n'ont pas besoin de confirmation car elles ne sont jamais facturées.
Comment déconnecter un assistant ?
Sous Settings → Developer. Chaque connexion (consentement OAuth ou clé collée) y figure comme une entrée révocable. Révoquez-la et le prochain appel de l'assistant sera refusé ; il n'y a rien à nettoyer du côté de l'assistant.
Quels clients MCP sont pris en charge ?
Tout client communiquant via MCP sur HTTP en streaming est compatible : Claude Code, Claude Desktop, Cursor et les frameworks d'agents les plus récents sont tous pris en charge. Les clients interactifs se connectent via OAuth ; les clients sans interface envoient une clé API dans un en-tête Bearer. L'URL du point de terminaison est la même dans les deux cas.
Un problème persiste ? Demandez à Literess dans l'application, ou écrivez à [email protected].