PTC-MCP-Server: Verbinden Sie Ihren Coding-Agent mit PTC
Der PTC-MCP-Server verbindet Claude Code, Codex, Cursor und andere Coding-Agents mit PTC (Private Translation Cloud), dem KI-Lokalisierungsdienst für Software.
Diese Seite enthält den Endpunkt, das Token, was der Server bietet und seine Limits. Um zu erfahren, was PTC tut, sobald Ihr Agent verbunden ist, lesen Sie, wie der PTC-Agent-Guide funktioniert. Die Befehle zur Einrichtung finden Sie unter Erste Schritte.
| Element | Wert |
|---|---|
| Endpunkt | https://app.ptc.wpml.org/mcp |
| Transport | Streamfähiges HTTP: nur POST, reine JSON-Antworten, zustandslos |
| Authentifizierung | Authorization: Bearer <agent token> |
| Agent-Token | Eines pro Person. PTC erstellt es, wenn Sie zum ersten Mal die Seite „Connect your agent to PTC“ öffnen, oder wenn Sie die Anmeldung des Befehlszeilentools genehmigen. Auf der Seite wird es bereits in das Setup-Snippet für Ihren Client eingefügt angezeigt |
| Begleit-Tool | Das Befehlszeilentool der PTC, das vom Agent im Repository unter .ptc/bin/ptc-cli.sh installiert wird; erforderlich |
| Anmeldung | Sie führen ptc auth login einmal in Ihrem eigenen Terminal aus und genehmigen es im Browser. Der Agent verarbeitet das Token nie |
| Vorgefertigtes Setup für | Claude Code, Codex, Cursor, VS Code. Jeder andere MCP-Client, der Shell-Befehle ausführen kann, stellt die Verbindung über den Endpunkt und den Header her |
| Getestet mit | Claude Code, Codex |
| Servername | ptc-guide; seine Version ist die CLI-Version, die PTC aktuell empfiehlt |
Was der Server bietet
Der Server ist ein Leitfaden, keine Übersetzungs-API. Er übergibt Ihrem Agent eine Aufgabe nach der anderen und prüft jedes Ergebnis, bevor er die nächste ausgibt. Er bietet fünf Operationen:
| Operation | Was sie tut |
|---|---|
| Nächste Aufgabe | Gibt die nächste Aufgabe für dieses Repository mit ihren Anweisungen und ihrer Payload zurück, oder teilt dem Agent mit, dass PTC noch arbeitet und worauf er warten soll. Der erste Aufruf benennt das Repository (sein Git-Remote oder „local“ mit einem Projektnamen) und tritt der bestehenden Sitzung des Repositorys wieder bei, falls eine vorhanden ist. Er kann auch ein Projekt benennen, das Sie im Einrichtungsassistenten der PTC begonnen haben, und führt es fort. Wenn ein PTC-Projekt das Repository bereits nutzt, aber keine Agent-Sitzung es bedient, erstellt PTC nichts und fragt den Menschen: dieses Projekt fortsetzen oder ein neues einrichten. Wenn das Token in mehreren Organisationen aktiv ist, gibt der erste Aufruf deren Liste zurück und der Agent fragt den Menschen, welche gewählt werden soll. |
| Einreichen | Sendet das Ergebnis einer Aufgabe. PTC antwortet mit einem Urteil: akzeptiert, abgelehnt, benötigt mehr oder übersprungen, jeweils mit Gründen. Jede Antwort sagt, was als Nächstes kommt. |
| Status | Wo die Sitzung steht: die Phase, der Einrichtungsfortschritt, der Status jeder Aufgabe und die Fragen, die auf den Menschen warten. Wird nach einer Aufgabe gefragt, gibt es das Urteil und die Gründe für diese Aufgabe zurück. |
| Überspringen | Überspringt eine Aufgabe auf Anweisung des Menschen, mit dessen Begründung. Eine Aufgabe, die eine Entscheidung enthält, die nur der Mensch trifft, kann nicht übersprungen werden: die Bestandsaufnahme, die Konventionen, die Bereinigung der Inhaltsbereiche, der Bereitstellungskanal, die erste Synchronisierung, der Kostenvoranschlag für ein kostenpflichtiges Projekt, das Bereitschaftsaudit, während sein Gate offen ist, und das Schreiben der Konfiguration, während das Repository bereits vorhandene Übersetzungen zum Importieren hat. Die PTC-eigenen Hilfen können übersprungen werden. |
| Warten | Wartet, während PTC auf ihrer Seite etwas abschließt (eine Übersetzung, eine Prüfung), und gibt das Urteil und die nächste Aufgabe zurück, wenn sie bereit ist, oder bittet darum, erneut aufgerufen zu werden. |
Die meisten Aufgaben fordern den Agent auf, einen Befehl des PTC-Befehlszeilentools auszuführen und dessen Ausgabe einzureichen: das Scannen des Repositorys, das Überprüfen von Strings, das Validieren eines Glossars, das Schreiben von Übersetzernotizen, das Melden eines Durchlaufs, das Synchronisieren von Übersetzungen. Das Tool gibt bei jedem Beenden aus, was als Nächstes zu tun ist. Wenn PTC eine neuere Version erfordert, gibt es den Upgrade-Befehl aus und der Leitfaden lässt den Agent diese installieren.
Sitzungsmodell
- Ein Repository hat eine Sitzung. Sie wird durch die Remote-URL des Repositorys (unabhängig von der Schreibweise) oder, bei einem Checkout ohne Remote, durch einen Fingerabdruck des Arbeitsverzeichnisses und einen Projektnamen identifiziert. Ein zweiter Agent, eine andere Maschine oder ein späterer Tag tritt derselben Sitzung wieder bei, und PTC erstellt dafür kein zweites Projekt. Die einzige Ausnahme: Wenn nur ein Projekt aus dem Einrichtungsassistenten das Repository nutzt, kann der Mensch wählen, ein neues einzurichten.
- Ein Repository mit mehreren Produkten ist eine Suite: ein PTC-Projekt mit einer eigenen Sitzung pro Produkt; eine MCP-Verbindung und ein CI-Secret für alle zusammen.
- Entscheidungen werden einmal erfasst und nie wieder abgefragt: Sprachen, Konventionen, die Glossar-Antwort, der Kostenvoranschlag, der Bereitstellungskanal.
- Nach der Einrichtung bleibt die Sitzung für kontinuierliche Arbeit offen: Jeder verifizierte CI-Durchlauf öffnet nur die neuen oder geänderten Strings wieder, und ein Durchlauf ohne Neuerungen öffnet nichts. In einer Testphase stoppt dies, wenn ihre zwei kostenlosen automatischen Lieferungen aufgebraucht sind.
- Die Sitzung, das Projekt und das Token werden vom Befehlszeilentool in der PTC-Konfiguration des Repositorys und in einer Anmeldeinformationsdatei im Home-Verzeichnis des Benutzers aufbewahrt; der Agent verarbeitet das Token nie.
Was dem Agent mitgeteilt wird
Jede Aufgabe enthält Anweisungen, die für den Agent geschrieben wurden. Drei Regeln ziehen sich durch alle hindurch:
- Leiten Sie die Fragen der PTC in den Worten der PTC an den Menschen weiter und geben Sie die eigenen Worte des Menschen zurück. PTC liest die Antwort selbst und verlässt sich nie blind auf die Interpretation des Agents.
- Antworten Sie nie für den Menschen. Sprachen, Konventionen, Geld, Begriffe und Bereitstellung sind Sache des Menschen. Was der Mensch bereits im Prompt genannt hat, wie etwa die Zielsprachen, zählt als seine Antwort und wird nicht erneut gefragt.
- Warten Sie auf PTC, anstatt es erneut zu versuchen. Eine abgelehnte Einreichung kommt mit Gründen zurück; der Agent korrigiert sie und reicht sie erneut ein.
Verifizierung
PTC akzeptiert ein Ergebnis nur, wenn sie es prüfen kann: Ein Scan muss von PTCs eigenem Tool stammen; eine zitierte Codezeile muss in den Dateien existieren, die PTC für diesen Durchlauf hält; eine Konfiguration muss Byte für Byte zurückkommen; eine Quelltextbearbeitung zählt, wenn PTCs Kopie der Datei sie zeigt; ein CI-Durchlauf wird durch das eigene Identitäts-Token der CI-Plattform (GitHub Actions, GitLab CI oder Bitbucket Pipelines) nachgewiesen, und ein Durchlauf ohne ein solches wird als unverifiziert erfasst. Erfahren Sie, warum ein LLM allein nicht ausreicht.
Limits
- Der Agent muss Shell-Befehle ausführen. Es gibt keinen reinen MCP-Pfad.
- Die eigenen Berechtigungs-Prompts des Agents, wie die Genehmigung eines heruntergeladenen Skripts oder eines neuen MCP-Tools, gehören dem Agent, nicht der PTC; erwarten Sie ein oder zwei bei einer frischen Einrichtung. Das Befehlszeilentool benötigt bash, curl und Python 3.6 oder neuer.
- Die Überprüfung deckt die Übersetzungen ab, die PTC angefertigt hat. Aus dem Repository importierte oder manuell bearbeitete Übersetzungen werden so belassen, wie sie sind.
- Das Token ist in jeder Organisation aktiv, die die Person verwaltet; das Token eines Nicht-Admins kann keine Projekte erstellen.
- Geld: PTC zeigt den Preis an und wartet auf ein Ja vor jeder kostenpflichtigen Arbeit. Eine Testphase läuft innerhalb ihres kostenlosen Kontingents weiter und stoppt erst, wenn sie ein Limit erreicht. Der Agent ist angewiesen, die Upgrade-Nachricht der PTC weiterzuleiten und niemals selbstständig Käufe zu tätigen.
- Bei einem Serverfehler oder keiner Antwort unternimmt das Befehlszeilentool drei erneute Versuche, beginnend bei 5 Sekunden und sich verdoppelnd. Eine Ratenbegrenzung, die eine Verzögerung nennt, wartet diese Verzögerung ab, bis zu 300 Sekunden. Jeder andere Client-Fehler ist sofort endgültig.
- Die In-App-Guide-Seite der PTC ist für PTC-Mitarbeiter gedacht. Kunden sehen den Fortschritt im Chat des Agents und im PTC-Dashboard.
Verbinden
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_TOKENCursor und VS Code: Die Seite „Connect your agent to PTC“ stellt für jeden eine fertige Datei bereit (.cursor/mcp.json, .vscode/mcp.json), in die Ihr Token bereits eingefügt ist. Für jeden anderen Client fügen Sie den Endpunkt mit dem Authorization-Header in dessen MCP-Konfiguration hinzu.
Dann ein Prompt: Set up PTC translations.
Um ein Projekt fortzusetzen, das Sie im Einrichtungsassistenten der PTC begonnen haben, kopieren Sie dessen Prompt von derselben Seite unter Continue a project you began in the wizard.
Das Befehlszeilentool selbst ist Open Source (MIT): OnTheGoSystems/ptc-cli.