Verbinden Sie Ihren eigenen KI-Agenten oder Ihre Software mit Tolk2Go
Was Sie verbinden können
- Andere KI-Tools, wie Microsoft Copilot, Gemini oder Cursor.
- Agent-Builder, wie n8n oder Zapier.
- Ihren eigenen Chatbot oder Assistenten.
- Ihre eigene Software, wie ein Planungs- oder Fallverwaltungssystem, die Dolmetscher direkt über die Tolk2Go-API bucht, ohne KI.
KI-Tools verbinden sich mit dem Tolk2Go-MCP-Server (Model Context Protocol over Streamable HTTP). Ihre eigene Software nutzt die REST API, beschrieben in einem OpenAPI-Vertrag. Die Suche nach Sprachen, Fachbereichen und verfügbaren Dolmetschern ist öffentlich und erfordert keine Anmeldung. Buchungen erfolgen immer im Namen eines Tolk2Go-Kundenkontos.
Mit OAuth anmelden
Für MCP-Clients, die eine Anmeldung per OAuth unterstützen. Es wird kein Schlüssel benötigt.
- Fügen Sie den MCP-Server
https://api.tolk2go.com/api/v1/mcpzum Client hinzu. - Anmelden und freigeben. Der Client öffnet eine Tolk2Go-Seite. Der Nutzer meldet sich mit seinem Tolk2Go-Kundenkonto an und wählt Zugriff erlauben. Das Passwort verbleibt bei Tolk2Go.
- Jederzeit trennen unter KI-Agenten-Zugriff im Konto.
Tolk2Go unterstützt OAuth 2.1 mit PKCE und dynamischer Client-Registrierung. Die Autorisierungsserver-Metadaten befinden sich unter https://api.tolk2go.com/.well-known/oauth-authorization-server.
Mit einem Agenten-Schlüssel verbinden
Für Clients ohne Unterstützung von OAuth und für Ihre eigene Software über die REST API.
- Nutzen Sie das Tolk2Go-Konto, zu dem die Buchungen gehören. Neu hier? Erstellen Sie zuerst ein Konto.
- Erstellen Sie einen Agenten-Schlüssel. Melden Sie sich an und öffnen Sie KI-Agenten-Zugriff im Konto, wählen Sie Schlüssel erstellen und kopieren Sie den Schlüssel. Er wird nur einmal angezeigt: Speichern Sie ihn in den geheimen Einstellungen des Clients, niemals in einem Chat oder Prompt.
- Verbinden Sie den Client mit dem Schlüssel mit dem Tolk2Go-MCP-Server (Beispielkonfiguration unten) oder übergeben Sie ihm den OpenAPI-Vertrag. Ein Client kann nach einmaliger Anmeldung über die API auch selbst einen Schlüssel ausstellen.
- Ersetzen oder widerrufen Sie den Schlüssel jederzeit unter KI-Agenten-Zugriff. Ein widerrufener Schlüssel funktioniert sofort nicht mehr.
Adressen
| Was | Adresse |
|---|---|
| MCP-Server (Streamable HTTP) | https://api.tolk2go.com/api/v1/mcp |
| OpenAPI-Vertrag | https://api.tolk2go.com/api/v1/spec |
| Leitfaden für KI-Agenten | https://www.tolk2go.com/llms.txt |
| Agenten-Skill und Einrichtungsbeispiele | github.com/Tolk2Go-Organization/agent-skills |
Beispielhafte MCP-Client-Konfiguration mit einem Agenten-Schlüssel:
{
"mcpServers": {
"tolk2go": {
"type": "http",
"url": "https://api.tolk2go.com/api/v1/mcp",
"headers": { "Authorization": "Bearer t2g_agent_..." }
}
}
}
Möchten Sie den gesamten Buchungsablauf sofort in Ihrem Agenten nutzen? Installieren Sie den Tolk2Go-Agenten-Skill mit npx skills add Tolk2Go-Organization/agent-skills.
Sicherheit
- Nur ein Konto. Eine verknüpfte App oder ein Agent-Schlüssel kann nur die Buchungen des Kontos einsehen und verwalten, das sie bzw. ihn verknüpft hat.
- Einmalig angezeigt, sicher gespeichert. Ein Agent-Schlüssel wird nur bei der Erstellung angezeigt. Tolk2Go speichert nur einen sicheren Hash, niemals den Schlüssel selbst.
- Begrenzte Gültigkeitsdauer. Schlüssel sind standardmäßig 90 Tage gültig (7 bis 365 Tage wählbar), sodass ein Agent Wochen später ohne erneutes Anmelden zurückkehren kann.
- Jederzeit erneuern, widerrufen oder trennen. Unter KI-Agenten-Zugriff sieht der Kunde jeden Schlüssel mit seiner letzten Nutzung sowie jede verknüpfte App und kann einen Schlüssel mit einem Klick ersetzen oder widerrufen bzw. eine App trennen.
- Niemals ausgesperrt. Schlüssel verloren? Widerrufen Sie ihn im Konto und erstellen Sie einen neuen. Die normale Kontoanmeldung funktioniert immer weiterhin.
- Keine Zahlungen durch den Agenten. Wenn eine Vorauszahlung erforderlich ist, erhält der Agent einen sicheren Zahlungslink für den Kunden.
Häufig gestellte Fragen
Welche Clients werden unterstützt?
Jeder Assistent oder Agent, der das Model Context Protocol (MCP) über Streamable HTTP unterstützt, mit OAuth-Anmeldung oder einem Agent-Schlüssel, sowie jede Software, die eine in OpenAPI beschriebene REST API aufrufen kann.
Was passiert, wenn ein Agent-Schlüssel verloren geht oder durchsickert?
Melden Sie sich an, widerrufen Sie den Schlüssel unter KI-Agenten-Zugriff im Konto und erstellen Sie einen neuen. Der widerrufene Schlüssel funktioniert nicht mehr und konnte ohnehin nur auf die Buchungen dieses einen Kontos zugreifen.
Kann unsere eigene Software ohne einen KI-Assistenten buchen?
Ja. Die REST API bietet dieselbe Suche, Buchung und Nachverfolgung wie der MCP-Server. Siehe den OpenAPI-Vertrag oben.
Benötigen Sie Hilfe bei der Anbindung?
Wir helfen Ihrer IT-Abteilung oder Ihren Entwicklern gerne bei der Anbindung von Tolk2Go.