KI-Assistenten verbinden (MCP)
Transept bietet einen MCP-Endpunkt, mit dem sich KI-Assistenten direkt verbinden können. Einmal verknüpft, kann ein Assistent den gesamten Prozess steuern (Dokumente importieren, Workflows in verschiedenen Sprachen ausführen, Glossare und Styleguides verwalten, Ergebnisse abrufen), während Sie stets die volle Kontrolle über Berechtigungen und Ihr Wort-Guthaben behalten.
Auf dieser Seite
Was ist der MCP-Endpunkt?
MCP (Model Context Protocol) ist der Standard, den KI-Assistenten nutzen, um externe Tools aufzurufen. Transept stellt dafür einen Endpunkt bereit, https://app.transept.ai/api/public/v1/mcp, und ein damit verbundener Assistent erhält dieselben Möglichkeiten wie ein Skript über die API – verpackt als Tools, die er eigenständig aufrufen kann: Dokumente erstellen, Kosten kalkulieren, den Prozess starten, den Status abfragen und die Übersetzungen abrufen.
Der praktische Unterschied zum Kopieren und Einfügen von Texten in einen Chatbot: Der Assistent arbeitet mit Ihren echten Dokumenten unter Anwendung Ihrer Glossare, Styleguides und Ihres Translation Memorys. Die Ergebnisse landen direkt in Transept, wo Sie sie wie jede andere Arbeit prüfen und exportieren können.
Wie verbinde ich Claude Code, Claude Desktop oder Cursor?
Die Verbindung erfolgt über Standard-OAuth: Fügen Sie die URL in Ihren Client ein. Beim ersten Verbindungsaufbau öffnet sich ein Browserfenster, in dem Sie den Zugriff autorisieren. Sobald Sie zustimmen, ist der Client verknüpft – das Kopieren eines Keys entfällt. Vorgefertigte Snippets für die verschiedenen Clients finden Sie in der App auf der Seite Integrationen.
| Client | Einrichtung |
|---|---|
| Claude Code | Führen Sie claude mcp add --transport http transept https://app.transept.ai/api/public/v1/mcp im Terminal aus |
| Claude Desktop | Einstellungen → Connectors → Add custom connector, Endpunkt-URL einfügen |
| Cursor | Fügen Sie der mcp.json einen Server mit "url": "https://app.transept.ai/api/public/v1/mcp" hinzu |
| Alle anderen Clients | Jeder MCP-Client, der streamfähiges HTTP unterstützt: Verweisen Sie ihn auf dieselbe URL |
Brauche ich einen API-Key?
Nicht für interaktive Clients: Diese nutzen OAuth. Keys sind für Systeme gedacht, die keinen Browser öffnen können. In jedem Fall erscheint die Verbindung unter Einstellungen → Entwickler als widerrufbarer Eintrag. So lässt sie sich mit einem Klick trennen – egal, wie sie eingerichtet wurde.
| Sie verbinden | Authentifizierung |
|---|---|
| Ein Assistent, den Sie direkt bedienen (Claude, Cursor) | OAuth: Browser-Zustimmung beim ersten Verbinden, kein Key zum Einfügen |
| CI, ein Server, ein Headless-Agent | Ein API-Key aus Einstellungen → Entwickler, gesendet als Authorization: Bearer-Header |
Was kann der Assistent eigentlich tun?
Die Tools decken den gesamten Prozess ab, sodass ein Dokument in einer einzigen Konversation vom Import bis hin zu den geprüften Übersetzungen geführt werden kann:
- Inhalte importieren: Dokumente per Copy-and-paste oder ein String-Katalog mit Keys, Kontexten und Platzhaltern.
- Kosten für jeden Durchlauf kostenlos kalkulieren, dann einen Workflow für alle Zielsprachen gleichzeitig starten und den Fortschritt pro Sprache abfragen.
- Glossare erstellen und erweitern, Styleguides lesen und das Translation Memory abfragen, bevor die Übersetzung erfolgt.
- Ergebnisse abrufen: blockweise für Fließtext oder nach String-ID für Kataloge.
- Webhooks registrieren, damit Ihre Systeme bei Abschluss eines Durchlaufs ein signiertes Ereignis per Push erhalten.
- Was konzeptbedingt außen vor bleibt: Datei-Uploads und binäre Exporte (DOCX, XLIFF, TMX) laufen über die REST-API, und die Key-Verwaltung bleibt eine manuelle Aufgabe in der App; ein Assistent kann sich niemals selbst einen Key generieren.
Wie sind meine Ausgaben geschützt?
Drei Schutzmechanismen, die alle serverseitig bei Transept greifen, statt sich auf den Assistenten zu verlassen:
- Berechtigungen. Jeder Tool-Aufruf wird gegen Ihre erteilten Freigaben geprüft: die Scopes des Keys oder der OAuth-Zustimmung. Ein Aufruf außerhalb dieser Grenzen wird unter Angabe der fehlenden Berechtigung abgelehnt.
- Schätzung, dann Bestätigung. Jede Aktion, die Wörter verbrauchen würde, gibt zunächst eine Wortschätzung aus und hält inne. Der Durchlauf startet erst nach expliziter Bestätigung durch den Assistenten – so sehen Sie den Preis im Chatverlauf, noch bevor Kosten entstehen. Review-Schranken in Ihren Workflows pausieren den Durchlauf weiterhin; für die Fortsetzung ist eine ausdrückliche Freigabe erforderlich, entweder durch Sie selbst oder durch den Assistenten auf Ihre Anweisung.
- Widerruf. Die Verbindung kann jederzeit von Ihrer Seite aus gekappt werden: Der nächste Aufruf eines widerrufenen Assistenten wird abgelehnt – auch mitten im Gespräch.
Können Inhalte ein- und ausgehen, ohne dass ich die App öffnen muss?
Ja: Koppeln Sie die Verbindung mit einem Webhook-Trigger, und der Kreislauf schließt sich. Ihre E-Mail-Plattform, Ihr CMS oder ein Skript sendet Inhalte per POST an die Trigger-URL (der Request-Body wird zum Dokument), der Workflow übersetzt sie, und ein Webhook oder der Assistent liest die fertigen Übersetzungen zurück: zehn Sprachen raus für ein Template rein, ohne dass jemand den Editor öffnen muss.
Dies ist das Prinzip hinter der Lokalisierung von E-Mail-Templates und der kontinuierlichen Arbeit mit String-Katalogen: Die Plattform überträgt die Änderungen per Push, Transept übersetzt nur diese neu, und Ihre Pipeline ruft die Ergebnisse ab. Ihre Aufgabe ist die Prüfung – alles Mechanische wird delegiert.
Kann der Assistent ohne Rückfrage meine Wörter verbrauchen?
Nein. Jedes Tool, das einen kostenpflichtigen Durchlauf starten würde, antwortet zunächst nur mit der Wortschätzung und unternimmt sonst nichts. Der Assistent muss den Start explizit bestätigen, und diese Bestätigung ist in Ihrem Chat sichtbar. Kostenlose Aktionen (Importieren, Schätzen, Ergebnisse lesen) erfordern keine Bestätigung, da sie niemals Kosten verursachen.
Wie trenne ich die Verbindung zu einem Assistenten?
Unter Einstellungen → Entwickler. Jede Verbindung (OAuth-Zustimmung oder eingefügter Key) wird dort als widerrufbarer Eintrag aufgeführt. Widerrufen Sie den Zugriff, und der nächste Aufruf des Assistenten wird abgelehnt; aufseiten des Assistenten ist keine weitere Bereinigung erforderlich.
Welche MCP-Clients werden unterstützt?
Jeder Client, der MCP über streambares HTTP beherrscht, ist geeignet – dazu zählen Claude Code, Claude Desktop, Cursor sowie neuere Agent-Frameworks. Interaktive Clients verbinden sich via OAuth, Headless-Clients senden einen API-Key als Bearer-Header. Der Endpunkt ist in beiden Fällen dieselbe URL.
Kommen Sie nicht weiter? Fragen Sie Literess in der App oder schreiben Sie an [email protected].