TypeHop
Herunterladen

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

  1. Öffnen Sie die TypeHop-Mac-App und gehen Sie zu Integrationen → API-Schlüssel.
  2. 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“.
  3. 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. GET und DELETE liefern 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 · -32001 Der Authorization-Header fehlt, oder der Schlüssel ist ungültig oder widerrufen.
  • 400 · -32700 Der Body ist kein gültiges JSON.
  • 413 · -32600 Der Body ist grösser als 256 KB.
  • 200 · -32600 Die Nachricht ist nicht JSON-RPC 2.0 ("jsonrpc": "2.0" oder "method" fehlt).
  • 200 · -32601 Unbekannte Methode.
  • 200 · -32602 tools/call hat ein Tool genannt, das nicht existiert.
  • 500 · -32603 Serverfehler. 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_dictations reicht 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.

Other products from us:SmashSend·TidySupport·SuperBuilder·Inbounter·Blossu·KnowledgeSDK