Entwickler · API-Schlüssel
Referenz zu TypeHop-API-Schlüsseln
Mit einem API-Schlüssel kann eine KI-App oder Ihr eigener Code die mit Ihrem TypeHop-Konto synchronisierten Diktate von jedem Gerät aus lesen. Schlüssel sind schreibgeschützt: Sie können Diktate und Ihre eigenen Wörter durchsuchen und lesen, aber nie etwas ändern oder löschen. Der Zugriff läuft über einen Remote-MCP-Endpunkt, sodass Apps wie Claude Code, Cursor und Codex mit einer einzigen Zeile Setup funktionieren.
Schlüssel erstellen
- Öffnen Sie die TypeHop-Mac-App und gehen Sie zu Integrationen → API-Schlüssel.
- Klicken Sie auf API-Schlüssel erstellen und benennen Sie ihn nach der App oder dem Rechner, der ihn verwenden wird, zum Beispiel „Cursor auf meinem Laptop“.
- Kopieren Sie den Schlüssel sofort. TypeHop speichert nur einen Hash, daher wird der vollständige Schlüssel nur einmal angezeigt. Verloren? Erstellen Sie einen neuen und widerrufen Sie den alten.
Schlüssel beginnen mit thp_mcp_. Die Liste in der App zeigt für jeden Schlüssel die ersten Zeichen, das Erstellungsdatum und die letzte Verwendung. Wenn Sie einen Schlüssel widerrufen, verlieren alle Apps, die ihn nutzen, sofort den Zugriff.
Authentifizierung
Senden Sie den Schlüssel bei jeder Anfrage als Bearer-Token. Es gibt keinen OAuth-Ablauf und keine Sitzung, die geöffnet werden muss.
- Endpunkt
https://api.typehop.com/v1/mcp- Methode
- Nur
POST.GETundDELETEliefern 405. - Header
Authorization: Bearer thp_mcp_YOUR_KEY- Body
- JSON-RPC 2.0,
Content-Type: application/json
Ein fehlender oder widerrufener Schlüssel
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="typehop-mcp"
{ "jsonrpc": "2.0", "id": null, "error": { "code": -32001, "message": "This token is invalid or was revoked." } }KI-App verbinden
Die meisten Nutzer rufen den Endpunkt nie von Hand auf. Die Mac-App zeigt unter App verbinden die genaue Einrichtung für Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Zed und Claude Desktop an, mit bereits eingetragenem neuem Schlüssel. Dieselben Snippets finden Sie auf der MCP-Seite. Zum Beispiel Claude Code:
claude mcp add --transport http typehop https://api.typehop.com/v1/mcp --header "Authorization: Bearer thp_mcp_YOUR_KEY"
Jeder andere Client, der Remote-MCP-Server über Streamable HTTP unterstützt, funktioniert mit der Endpunkt-URL und dem Header oben. Für benutzerdefinierte Connectors in Claude.ai und ChatGPT ist OAuth nötig, das TypeHop noch nicht unterstützt.
Aufruf aus Code
Der Endpunkt spricht das Model Context Protocol: JSON-RPC-2.0-Nachrichten in einem POST, eine JSON-Antwort zurück. Er ist zustandslos, es gibt also keine Sitzungs-Header und keine Server-Sent Events. Unterstützte Protokollversionen: 2025-06-18, 2025-03-26, 2024-11-05.
1. Initialisieren (optional, aber MCP-Clients tun es)
curl https://api.typehop.com/v1/mcp \
-H "Authorization: Bearer thp_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0.0"}}}'2. Tools auflisten
curl https://api.typehop.com/v1/mcp \
-H "Authorization: Bearer thp_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'3. Ein Tool aufrufen
curl https://api.typehop.com/v1/mcp \
-H "Authorization: Bearer thp_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_dictations","arguments":{"query":"launch plan","limit":5}}}'Antwort · 200
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"content": [
{
"type": "text",
"text": "[2026-11-03T09:14:22.000Z · Slack · id 3f6c1a2e-8b1d-4c55-9a0e-6b2f7d1e4c90]\nThe launch plan moves to next Tuesday..."
}
],
"isError": false
}
}Jedes Diktat in einem Ergebnis beginnt mit einer Kopfzeile: [created at · app · id <id>], danach folgt der bereinigte Text. Übergeben Sie diese ID an get_dictation, um das Roh-Transkript zu erhalten. Sie können auch ein Array mit bis zu 20 Nachrichten in einer Anfrage senden; Benachrichtigungen (Nachrichten ohne id) erhalten 202 ohne Body. ping wird unterstützt.
Tools
Jedes Tool ist schreibgeschützt und gibt reinen Text in result.content[0].text zurück.
search_dictations · Diktate durchsuchen
Volltextsuche über alles, was der Nutzer diktiert hat. Gibt die neuesten Treffer zuerst zurück.
query(string, erforderlich): Wörter oder eine Wendung, die gefunden werden sollen.limit(integer 1–50, Standard 20)
recent_dictations · Letzte Diktate
Die neuesten Diktate des Nutzers, optional nur aus den letzten Tagen.
limit(integer 1–50, Standard 20)days(integer 1–365): Nur Diktate der letzten N Tage.
get_dictation · Ein Diktat abrufen
Ein Diktat per ID: der bereinigte Text und das Roh-Transkript.
id(string, erforderlich): Die ID aus den Such- oder Letzte-Diktate-Ergebnissen.
list_dictionary · Eigene Wörter
Die eigenen Wörter und Schreibweisen des Nutzers (Namen, Fachjargon).
Keine Argumente.
Wenn ein Tool nicht antworten kann (leere Abfrage, unbekannte ID, vorübergehender Lesefehler), ist die Antwort trotzdem ein 200-Ergebnis, mit isError: true und einem Satz, den das Modell lesen kann.
Fehler
Protokollfehler kommen als JSON-RPC-error-Objekt zurück: { "code": <number>, "message": "<text>" }.
401 · -32001Der Authorization-Header fehlt, oder der Schlüssel ist ungültig oder widerrufen.400 · -32700Der Body ist kein gültiges JSON.413 · -32600Der Body ist grösser als 256 KB.200 · -32600Die Nachricht ist nicht JSON-RPC 2.0 ("jsonrpc": "2.0" oder "method" fehlt).200 · -32601Unbekannte Methode.200 · -32602tools/call hat ein Tool genannt, das nicht existiert.500 · -32603Serverfehler. Wiederholen Sie die Anfrage mit Backoff.
Limits und Sicherheit
- Aktive Schlüssel
- Bis zu 10 pro Konto. Widerrufen Sie einen, um einen weiteren zu erstellen.
- Anfragegrösse
- 256 KB pro Anfrage, bis zu 20 Nachrichten pro Batch.
- Ergebnisse
- Bis zu 50 Diktate pro Aufruf;
recent_dictationsreicht höchstens 365 Tage zurück. - Umfang
- Die mit Ihrem Konto synchronisierten Diktate sowie Ihre eigenen Wörter. Es wird nichts geschrieben.
- Verwenden Sie einen Schlüssel pro App oder Rechner, damit Sie einen widerrufen können, ohne die anderen zu beeinträchtigen.
- Bewahren Sie Schlüssel auf Ihrem Computer oder Backend auf. Legen Sie sie nie in Browser-Code, einem Mobile-App-Bundle oder einem öffentlichen Repo ab.
- Ein Schlüssel ist durchgesickert: Widerrufen Sie ihn unter Integrationen → API-Schlüssel. Er funktioniert ab der nächsten Anfrage nicht mehr.
Fragen: support@typehop.com. Suchen Sie stattdessen einen Überblick? Siehe die TypeHop-API.