Serveur MCP PTC : connectez votre agent de codage à PTC

Le serveur MCP PTC connecte Claude Code, Codex, Cursor et d'autres agents de codage à PTC (Private Translation Cloud), le service de localisation par IA pour les logiciels.

Sur cette page

Ce que le serveur offre
Modèle de session
Ce qui est dit à l'agent
Vérification
Limites
Connexion

Cette page présente le point de terminaison, le jeton, ce que le serveur offre et ses limites. Pour savoir ce que fait PTC une fois votre agent connecté, lisez comment fonctionne le guide de l'agent PTC. Pour les commandes de configuration, consultez Premiers pas.

Élément	Valeur
Point de terminaison	`https://app.ptc.wpml.org/mcp`
Transport	HTTP en streaming : POST uniquement, réponses JSON en texte brut, sans état
Authentification	`Authorization: Bearer <agent token>`
Jeton d'agent	Un par personne. PTC le crée lorsque vous ouvrez pour la première fois la page Connecter votre agent à PTC, ou lorsque vous approuvez la connexion de l'outil en ligne de commande. La page l'affiche déjà prérempli dans l'extrait de configuration pour votre client
Outil d'accompagnement	L'outil en ligne de commande de PTC, installé par l'agent dans le dépôt sous `.ptc/bin/ptc-cli.sh` ; requis
Connexion	Vous exécutez `ptc auth login` une fois dans votre propre terminal et l'approuvez dans le navigateur. L'agent ne manipule jamais le jeton
Configuration prête à l'emploi pour	Claude Code, Codex, Cursor, VS Code. Tout autre client MCP capable d'exécuter des commandes shell se connecte avec le point de terminaison et l'en-tête
Testé avec	Claude Code, Codex
Nom du serveur	`ptc-guide` ; sa version correspond à la version de la CLI que PTC recommande actuellement

Ce que le serveur offre

Le serveur est un guide, pas une API de traduction. Il confie à votre agent une tâche à la fois et vérifie chaque résultat avant de distribuer la suivante. Il propose cinq opérations :

Opération	Ce qu'elle fait
Tâche suivante	Renvoie la tâche suivante pour ce dépôt avec ses instructions et sa charge utile, ou indique à l'agent que PTC travaille encore et ce qu'il doit attendre. Le premier appel nomme le dépôt (son dépôt distant Git, ou « local » avec un nom de projet) et rejoint la session existante du dépôt s'il y en a une. Il peut également nommer un projet que vous avez commencé dans l'assistant de configuration de PTC, et le poursuivre. Lorsqu'un projet PTC utilise déjà le dépôt mais qu'aucune session d'agent ne le sert, PTC ne crée rien et demande à l'humain : continuer ce projet ou en configurer un nouveau. Lorsque le jeton agit dans plusieurs organisations, le premier appel renvoie leur liste et l'agent demande à l'humain laquelle choisir.
Soumettre	Envoie le résultat d'une tâche. PTC répond par un verdict : accepté, rejeté, nécessite plus d'informations ou ignoré, chacun avec ses raisons. Chaque réponse indique la suite des opérations.
Statut	Où en est la session : l'étape, la progression de la configuration, l'état de chaque tâche et les questions en attente de l'humain. Interrogé sur une tâche précise, il renvoie le verdict et les raisons de cette tâche.
Ignorer	Ignore une tâche sur instruction de l'humain, avec son motif. Une tâche qui contient une décision que seul l'humain peut prendre ne peut pas être ignorée : le recensement, les conventions, le nettoyage du périmètre, le canal de livraison, la première synchronisation, l'estimation sur un projet payant, l'audit de préparation tant que son accès est ouvert, et l'écriture de la configuration lorsque le dépôt contient des traductions préexistantes à importer. Les propres aides de PTC le peuvent.
Attendre	Patiente pendant que PTC termine quelque chose de son côté (une traduction, une vérification) et renvoie le verdict et la tâche suivante une fois prêt, ou demande à être rappelé.

La plupart des tâches demandent à l'agent d'exécuter une commande de l'outil en ligne de commande de PTC et de soumettre sa sortie : analyser le dépôt, auditer les chaînes, valider un glossaire, rédiger des notes pour les traducteurs, signaler une exécution, synchroniser les traductions. L'outil affiche la marche à suivre une fois l'exécution terminée. Lorsque PTC nécessite une version plus récente, il affiche la commande de mise à niveau et le guide fait en sorte que l'agent l'installe.

Modèle de session

Un dépôt possède une seule session. Elle est identifiée par l'URL distante du dépôt (quelle que soit la syntaxe) ou, pour une extraction sans dépôt distant, par une empreinte de l'arbre de travail et un nom de projet. Un deuxième agent, une autre machine ou un jour ultérieur rejoint la même session, et PTC ne crée pas de deuxième projet pour cela. La seule exception : lorsque seul un projet issu de l'assistant de configuration utilise le dépôt, l'humain peut choisir d'en configurer un nouveau.
Un dépôt contenant plusieurs produits constitue une suite : un projet PTC, avec sa propre session, par produit ; une seule connexion MCP et un seul secret CI pour l'ensemble.
Les décisions sont enregistrées une fois pour toutes et ne sont plus jamais demandées : les langues, les conventions, la réponse du glossaire, l'estimation, le canal de livraison.
Après la configuration, la session reste ouverte pour un travail continu : chaque exécution CI vérifiée ne rouvre que les chaînes nouvelles ou modifiées, et une exécution sans nouveauté n'ouvre rien. Lors d'un essai, cela s'arrête lorsque ses deux livraisons automatiques gratuites sont utilisées.
La session, le projet et le jeton sont conservés par l'outil en ligne de commande dans la configuration PTC du dépôt et dans un fichier d'identifiants situé dans le répertoire personnel de l'utilisateur ; l'agent ne manipule jamais le jeton.

Ce qui est dit à l'agent

Chaque tâche comporte des instructions rédigées pour l'agent. Trois règles s'appliquent à toutes :

Relayer les questions de PTC à l'humain avec les mots de PTC, et renvoyer les propres mots de l'humain. PTC lit la réponse lui-même et ne se fie jamais à l'interprétation de l'agent.
Ne jamais répondre à la place de l'humain. Les langues, les conventions, l'argent, les termes et la livraison sont du ressort de l'humain. Ce que l'humain a déjà nommé dans le prompt, comme les langues cibles, compte comme sa réponse et ne lui est pas redemandé.
Attendre PTC plutôt que de réessayer. Une soumission rejetée revient avec des raisons ; l'agent corrige et soumet à nouveau.

Vérification

PTC n'accepte un résultat que lorsqu'il peut le vérifier : une analyse doit provenir du propre outil de PTC ; une ligne de code citée doit exister dans les fichiers que PTC détient pour cette exécution ; une configuration doit revenir octet par octet ; une modification source compte lorsque la copie du fichier de PTC l'affiche ; une exécution CI est prouvée par le propre jeton d'identité de la plateforme CI (GitHub Actions, GitLab CI ou Bitbucket Pipelines), et une exécution sans celui-ci est enregistrée comme non vérifiée. Découvrez pourquoi un LLM seul ne suffit pas.

Limites

L'agent doit exécuter des commandes shell. Il n'y a pas de chemin exclusivement MCP.
Les propres demandes d'autorisation de l'agent, telles que l'approbation d'un script téléchargé ou d'un nouvel outil MCP, appartiennent à l'agent, pas à PTC ; attendez-vous à en voir une ou deux lors d'une nouvelle configuration. L'outil en ligne de commande nécessite bash, curl et Python 3.6 ou une version plus récente.
La révision couvre les traductions effectuées par PTC. Les traductions importées depuis le dépôt ou modifiées à la main sont laissées telles quelles.
Le jeton agit dans chaque organisation que la personne administre ; le jeton d'un non-administrateur ne peut pas créer de projets.
Argent : PTC affiche le prix et attend un oui avant tout travail payant. Un essai se poursuit dans la limite de son quota gratuit et ne s'arrête que lorsqu'il atteint une limite. L'agent a pour instruction de relayer le message de mise à niveau de PTC et de ne jamais acheter de lui-même.
Une erreur de serveur ou une absence de réponse fait l'objet de trois nouvelles tentatives par l'outil en ligne de commande, en commençant à 5 secondes et en doublant. Une limite de débit qui indique un délai attend ce délai, jusqu'à 300 secondes. Toute autre erreur client est immédiatement définitive.
La page du guide dans l'application de PTC est réservée au personnel de PTC. Les clients voient la progression dans le chat de l'agent et sur le tableau de bord de PTC.

Connexion

Claude Code

claude mcp add --transport http ptc https://app.ptc.wpml.org/mcp --header "Authorization: Bearer <your agent token>"

Codex

export PTC_API_TOKEN='<your agent token>'
codex mcp add ptc --url https://app.ptc.wpml.org/mcp --bearer-token-env-var PTC_API_TOKEN

Cursor et VS Code : la page Connecter votre agent à PTC fournit un fichier prêt à l'emploi pour chacun (.cursor/mcp.json, .vscode/mcp.json) avec votre jeton prérempli. Pour tout autre client, ajoutez le point de terminaison avec l'en-tête Authorization dans sa configuration MCP.

Ensuite, un seul prompt : Set up PTC translations.

Pour continuer un projet que vous avez commencé dans l'assistant de configuration de PTC, copiez son prompt depuis la même page, sous Continuer un projet que vous avez commencé dans l'assistant.

L'outil en ligne de commande lui-même est open source (MIT) : OnTheGoSystems/ptc-cli.