Zum Inhalt springen
DOTWICK

MCP-Server

Was es ist

Das Model Context Protocol (MCP) ist ein offener Standard, mit dem ein KI-Assistent Tools in einem anderen Dienst aufrufen kann. Dotwick betreibt einen MCP-Server, damit ein Assistent Ihre Codes auflisten, erstellen, ändern und taggen sowie Ihre Scan-Zahlen lesen kann.

Der Server ist eine dünne Schicht über dieser API. Jedes seiner 11 Tools ruft eine API-Route mit deren Scope auf, unter denselben Rate-Limits. Ein Assistent kann also tun, was sein Schlüssel von Hand könnte, und nicht mehr. Nichts wird gelöscht: Codes, Ordner und Tags zu entfernen bleibt in der App und der REST-API, damit kein Prompt einen gedruckten Code kaputt machen kann.

Bevor Sie starten

MCP gehört zum API-Zugang (Pro, Business und Enterprise). Öffnen Sie in der App Settings → API und erstellen Sie einen Schlüssel mit den Scopes, die der Assistent braucht: Lese-Scopes genügen für Fragen zu Ihren Scans, mit codes:write, folders:write oder tags:write darf er auch etwas ändern.

Der Assistent sieht nur die Tools, die sein Schlüssel erlaubt; ein reiner Lese-Schlüssel listet create_code also nie. Jeder Tool-Aufruf zählt als eine API-Anfrage auf das Rate-Limit und das Monatsvolumen des Schlüssels; das Auflisten der Tools zählt nicht.

Verbinden

Der Server spricht Streamable HTTP unter https://api.dotwick.com/mcp. Senden Sie den Schlüssel als Bearer-Token im Authorization-Header.

BeispielDen Server hinzufügen
claude mcp add --transport http dotwick https://api.dotwick.com/mcp \  --header "Authorization: Bearer $DOTWICK_API_KEY"

Claude, ChatGPT und andere Clients

Claude Code fügt den Server mit dem Befehl oben hinzu. Clients, die eine MCP-Konfigurationsdatei lesen, etwa Cursor und VS Code, nehmen den JSON-Block: Halten Sie den Schlüssel in einer Umgebungsvariablen und verweisen Sie darauf, schreiben Sie ihn nie in die Datei.

ChatGPT und andere Apps, die einen entfernten MCP-Server per URL hinzufügen: Geben Sie die Server-URL ein und senden Sie den Schlüssel als Bearer-Token, wo die App nach einem API-Schlüssel oder Header fragt. Eine App, die sich nur per OAuth anmelden kann, kann sich noch nicht verbinden. OAuth ist geplant; heute erreicht man den Server mit API-Schlüsseln.

Tools

Jedes Tool entspricht einer API-Route und braucht den Scope dieser Route. Listen-Tools liefern bis zu 50 Einträge und einen Cursor für die nächste Seite.

list_codes
Listet die QR-Codes des Arbeitsbereichs, neueste zuerst. Filter nach Ordner, Tags, Typ, Status oder eine Suche über Name und Kurzlink.codes:read · GET /v1/codes
get_code
Ein QR-Code mit Ziel, Regeln, Tags und den Scans insgesamt.codes:read · GET /v1/codes/{id}
create_code
Erstellt einen QR-Code, der eine Webseite öffnet. Standardmäßig dynamisch (das Ziel lässt sich nach dem Druck ändern). Optional mit Ordner, Tags und UTM-Parametern.codes:write · POST /v1/codes
update_code
Ändert Name, Ziel-URL, Ordner, Tags oder Ablaufdatum eines Codes, oder pausiert und setzt ihn fort.codes:write · PATCH /v1/codes/{id}
list_folders
Die Ordner des Arbeitsbereichs.folders:read · GET /v1/folders
create_folder
Erstellt einen Ordner, optional in einem anderen.folders:write · POST /v1/folders
list_tags
Die Tags des Arbeitsbereichs und wie viele Codes jeden tragen.tags:read · GET /v1/tags
create_tag
Erstellt einen Tag mit Name und Farbe.tags:write · POST /v1/tags
tag_codes
Fügt Tags bei bis zu 500 Codes auf einmal hinzu oder entfernt sie.codes:write · POST /v1/codes/tags
analytics_summary
Scans insgesamt und eindeutige Scans für einen Zeitraum: Arbeitsbereich, ein Code, ein Ordner oder ein Tag.analytics:read · GET /v1/analytics/summary
analytics_breakdown
Top-Länder, -Städte, -Geräte, -Browser, -Codes oder A/B-Varianten für einen Zeitraum.analytics:read · GET /v1/analytics/breakdown

Grenzen und Sicherheit

  • Der Schlüssel behält seine Ordnerbeschränkung, seine IP-Bereiche und seine Rate-Limits: Über MCP sieht er nur, was er auch über die REST-API sieht.
  • Über MCP lässt sich nichts löschen.
  • Ein Assistent kann sich irren. Bitten Sie ihn, vor dem Schreiben zu sagen, was er ändern will, und prüfen Sie das Ergebnis in der App.