Geben Sie Ihrem KI-Assistenten ein Transkriptions-Werkzeug

Am schnellsten geht es über die Kommandozeile, aus dem Ordner heraus, in dem Sie arbeiten:

claude mcp add --transport http dokitscript https://dokitscript.com/mcp \
  --header "Authorization: Bearer dks_live_IHR_SCHLUESSEL"

Legen Sie eine .mcp.json im Projektstamm an, dann teilt das ganze Team denselben Eintrag.

{
  "mcpServers": {
    "dokitscript": {
      "type": "http",
      "url": "https://dokitscript.com/mcp",
      "headers": {
        "Authorization": "Bearer dks_live_IHR_SCHLUESSEL"
      }
    }
  }
}

Prüfen Sie es mit /mcp in einer Sitzung: Der Server sollte als verbunden erscheinen, samt seiner fünf Werkzeuge.

Legen Sie .cursor/mcp.json im Projekt an, wenn es nur um dieses Projekt geht, oder ~/.cursor/mcp.json, damit der Server überall zur Verfügung steht.

{
  "mcpServers": {
    "dokitscript": {
      "url": "https://dokitscript.com/mcp",
      "headers": {
        "Authorization": "Bearer dks_live_IHR_SCHLUESSEL"
      }
    }
  }
}

Öffnen Sie Settings, dann MCP, um zu bestätigen, dass der Server auftaucht. Steht der Schalter auf aus, schalten Sie ihn dort ein.

VS Code nutzt den Schlüssel servers statt mcpServers. Es kann den Schlüssel außerdem beim Start abfragen, statt ihn in der Datei abzulegen, was in einem Repository, das eingecheckt wird, die bessere Wahl ist.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "dokitscript-key",
      "description": "Dokitscript API-Schlüssel",
      "password": true
    }
  ],
  "servers": {
    "dokitscript": {
      "type": "http",
      "url": "https://dokitscript.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:dokitscript-key}"
      }
    }
  }
}

VS Code fragt den Schlüssel beim ersten Start des Servers ab und merkt ihn sich danach. Die Werkzeuge erscheinen anschließend im Agent-Modus, in der Werkzeugauswahl.

Claude Desktop hat zwei Türen, und keine nimmt einen Bearer-Schlüssel unverändert an. Das Feld Connectors akzeptiert zwar die Adresse eines entfernten Servers, meldet sich dort aber per OAuth an und bietet kein Feld für einen festen Schlüssel. Die Konfigurationsdatei claude_desktop_config.json wiederum startet lokale Befehle, statt eine URL aufzurufen. Der Weg, der heute funktioniert, führt deshalb über eine kleine Zwischenstelle auf Ihrem Rechner: Claude Desktop startet sie als Befehl, und sie reicht jeden Austausch per HTTPS an https://dokitscript.com/mcp weiter, mit Ihrem Schlüssel im Header.

Node.js 18 oder neuer — von dort kommt npx. Im Terminal:

node -v

Unter Windows muss npm zusätzlich global installiert sein, sonst startet npx gar nicht erst. Ein Befehl genügt: npm install -g npm.

Am schnellsten: Settings, dann Developer, dann Edit Config. Das öffnet die Datei und legt sie an, falls es sie noch nicht gibt.

{
  "mcpServers": {
    "dokitscript": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dokitscript.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer dks_live_IHR_SCHLUESSEL"
      }
    }
  }
}

Enthält die Datei bereits ein mcpServers-Objekt, tragen Sie "dokitscript" dort hinein, statt die ganze Datei zu ersetzen.

Der Schlüssel läuft über env. Unter Windows übergibt Claude Desktop die args an npx, ohne die Leerzeichen zu schützen. Direkt ins Argument geschrieben, bricht "Authorization: Bearer dks_live_…" am Leerzeichen auseinander: die Zwischenstelle liest dann einen leeren Header, der Rest des Schlüssels bleibt als loses Argument liegen, und der Server antwortet mit 401, obwohl der Schlüssel einwandfrei ist. Bleibt das Leerzeichen in der Variablen, kommt niemand mehr daran. Das Argument nennt vor dem Doppelpunkt den Header, die Variable trägt Bearer, ein Leerzeichen und dann Ihren Schlüssel.

--transport http-only nimmt ein Raten heraus. Unser Server antwortet auf POST und schickt auf alles andere bewusst 405 zurück. Überlässt man ihr die Wahl des Transports, deutet die Zwischenstelle eine 405 als Aufforderung, auf einen vom Server gesendeten Ereignisstrom auszuweichen, den wir absichtlich nicht anbieten — eine Sackgasse, die mit Ihrem Schlüssel nichts zu tun hat. Wer den Transport benennt, schließt diesen Zweig aus.

1. Beenden Sie die App vollständig, nicht nur ihr Fenster: Cmd + Q unter macOS, unter Windows über das Infobereich-Symbol beenden. Die Konfiguration wird nur beim Start gelesen.
2. Wieder öffnen, dann die Liste Connectors über die Schaltfläche links unten am Eingabefeld aufrufen. dokitscript sollte dort mit seinen fünf Werkzeugen stehen.
3. Fragen Sie etwas Alltägliches, etwa zeig mir meine letzten drei Transkriptionen. Es sollte von selbst zu list_transcripts greifen, ohne dass Sie das Werkzeug nennen.

Die Zwischenstelle sitzt zwischen Ihnen und uns: Der Client meldet einen Server, der nicht startet, und zeigt unseren HTTP-Status nie an. Zwei Befehle sagen Ihnen, welche Hälfte klemmt. Dieser spricht ohne Zwischenstelle mit uns, und ein gültiger Schlüssel antwortet mit den fünf Werkzeugdefinitionen:

curl -X POST https://dokitscript.com/mcp \
  -H "Authorization: Bearer dks_live_IHR_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Und dieser startet die Zwischenstelle von Hand, wo ihr echter Fehler ausgegeben statt verschluckt wird. Leerzeichen stören hier nicht, denn das Terminal war nie das Problem:

npx -y mcp-remote https://dokitscript.com/mcp \
  --transport http-only --debug \
  --header "Authorization: Bearer dks_live_IHR_SCHLUESSEL"

Ihre eigenen Fehler schreibt die Zwischenstelle in das Client-Protokoll: ~/Library/Logs/Claude/mcp-server-dokitscript.log unter macOS, %APPDATA%\Claude\logs\mcp-server-dokitscript.log unter Windows. Die Codes, die der Server selbst zurückgibt, stehen in der Tabelle weiter unten.

Jeder Client taugt, der MCP über HTTP spricht und einen Header setzen lässt. Der Server nimmt POST-Anfragen mit JSON-RPC 2.0 entgegen und antwortet als application/json. Es gibt weder Sitzungen noch einen vom Server aufgebauten Stream: GET und DELETE liefern daher 405, und das ist so gewollt. Zum Prüfen des Schlüssels von Hand:

curl -X POST https://dokitscript.com/mcp \
  -H "Authorization: Bearer dks_live_IHR_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ein gültiger Schlüssel liefert die Definition der fünf Werkzeuge zurück. Ein Aufruf sieht so aus:

curl -X POST https://dokitscript.com/mcp \
  -H "Authorization: Bearer dks_live_IHR_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"list_transcripts","arguments":{"limit":5}}}'