MCP-Server: einen KI-Assistenten verbinden

Mit dem MCP-Server von WbizTool kann ein KI-Assistent mit Ihrem Arbeitsbereich arbeiten. Sie können ihn zum Beispiel fragen: „Welche Nachrichten sind heute fehlgeschlagen und warum?“, „Pausiere die Miet-Erinnerung“ oder „Sende unsere neuen Öffnungszeiten an diese fünf Kunden“ – und er erledigt das mit Ihrem WbizTool-Konto.

Er spricht das Model Context Protocol (MCP), das Claude Code, Cursor, VS Code und andere KI-Tools verstehen. Im Hintergrund ist jede Aktion ein Aufruf der API v2 mit Ihrem eigenen API-v2-Schlüssel, der Schlüssel bestimmt also, was der Assistent sehen und tun darf.

Was ein Assistent tun kann#

Der Assistent sieht nur die Tools, die der Schlüssel erlaubt (siehe Scopes):

Außerdem bietet er drei fertige Prompts: Daily summary (Tageszusammenfassung), Failed messages (fehlgeschlagene Nachrichten) und Draft an announcement (eine Ankündigung entwerfen).

Er kann keine neue Nummer verbinden (das bleibt in Ihrem Dashboard), keine Dateien hochladen, keine Webhooks verwalten und Ihren Unibox-Posteingang nicht lesen.

1. Einen Schlüssel für den Assistenten erstellen#

1. Die Karte API-v2-Schlüssel öffnen

   Rufen Sie in WbizTool Einstellungen → API-Schlüssel auf und suchen Sie die Karte API-v2-Schlüssel.

2. Die Vorlage für KI-Assistenten nutzen

   Klicken Sie auf v2-Schlüssel erstellen und dann auf Für einen KI-Assistenten. So entsteht ein Schlüssel mit Nur Lesen, der Nachrichten und Nummern lesen kann und in 90 Tagen abläuft – ein sicherer Start: Der Assistent kann nachsehen, aber nichts senden oder ändern.

3. Senden nur erlauben, wenn Sie es wollen

   Soll der Assistent Nachrichten senden oder Erinnerungen verwalten, entfernen Sie den Haken bei Nur Lesen und setzen Sie ihn bei Nachrichten senden (und bei Bedarf bei Erinnerungen). Sie können den Schlüssel auch auf einige Ihrer Nummern beschränken.

4. Den Schlüssel kopieren

   Der Schlüssel (wbz_live_…) wird nur einmal angezeigt. Bewahren Sie ihn in einer Umgebungsvariablen auf Ihrem Computer auf, etwa WBIZTOOL_API_KEY – fügen Sie ihn nie in eine Datei ein, die Sie teilen oder committen.

export WBIZTOOL_API_KEY=wbz_live_…

2. Den Server zu Ihrem KI-Tool hinzufügen#

claude mcp add --transport http wbiztool https://mcp.wbiztool.com/mcp \
  --header "Authorization: Bearer ${WBIZTOOL_API_KEY}"

{
  "mcpServers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "wbiztool": {
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${env:WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "wbiztool-key", "description": "WbizTool API v2 key (wbz_live_…)", "password": true }
  ],
  "servers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wbiztool-key}" }
    }
  }
}

• Claude Code: Führen Sie den Befehl einmal aus (mit --scope project teilen Sie ihn über .mcp.json mit einem Projekt; die Datei enthält ${WBIZTOOL_API_KEY}, nicht den Schlüssel).
• Cursor: Tragen Sie ihn in ~/.cursor/mcp.json ein oder in einem Projekt in .cursor/mcp.json.
• VS Code: Tragen Sie ihn in .vscode/mcp.json ein. VS Code fragt einmal nach dem Schlüssel und bewahrt ihn in seinem Secret-Speicher auf.

Fragen Sie den Assistenten dann etwa: „Wie sieht mein WbizTool-Konto aus?“ – er sollte mit dem Namen und dem Plan Ihres Arbeitsbereichs antworten.

3. Wie das Senden sicher bleibt#

• Jedes Senden wird zuerst als Vorschau gezeigt. Wenn Sie eine Nachricht anfordern, erhält der Assistent zuerst eine Vorschau von WbizTool – von welcher Nummer sie geht, an wen, der genaue Text, eine eventuelle Datei, wann – und noch ist nichts gesendet. Er ist angewiesen, Ihnen diese Vorschau zu zeigen und auf Ihr Ja zu warten. Erst dann sendet er, genau mit dem, was Sie gesehen haben.
• Eine Wiederholung sendet nie doppelt. Wiederholt der Assistent ein bestätigtes Senden (zum Beispiel nach einer Zeitüberschreitung), antwortet WbizTool mit der bereits gesendeten Nachricht.
• Der Schlüssel ist die feste Grenze. Ein Schlüssel mit Nur-Lesen-Zugriff kann überhaupt nicht senden. Ein Schlüssel ohne Nachrichten senden sieht die Sende-Tools gar nicht erst, und ein auf einige Nummern beschränkter Schlüssel kann die anderen nicht nutzen. Auch die Limits von WbizTool selbst gelten: 60 Requests pro Minute und Schlüssel und höchstens 1.000 Nachrichten pro Tag und Nummer.
• Text von anderen wird als Daten markiert. Nachrichten, Namen und Dateien, die von außen kommen, erreichen den Assistenten als nicht vertrauenswürdig markiert, und er ist angewiesen, Anweisungen darin nie zu befolgen.
• Keine Geheimnisse in Antworten. QR-Codes und Kopplungscodes werden nie angezeigt, und Listen enthalten keine Dateilinks.
• Jederzeit widerrufen. Wenn Sie den Schlüssel unter Einstellungen → API-Schlüssel widerrufen, ist der Assistent sofort gestoppt.

Datenschutz#

Wenn Sie einen Assistenten verbinden, wird das, was er aus WbizTool liest (Nachrichten, Namen und Nummern, die der Schlüssel sehen darf), an den Anbieter dieses Assistenten gesendet – zum Beispiel an Anthropic für Claude oder an OpenAI für ChatGPT – und nach dessen Bedingungen verarbeitet. Der MCP-Server von WbizTool selbst speichert nichts: Er reicht jeden Request an die API v2 weiter und protokolliert, welches Tool verwendet wurde, nie den Nachrichtentext oder Ihren Schlüssel. Geben Sie dem Schlüssel nur den Zugriff, den der Assistent braucht.

Fehlerbehebung#

Verwandte Themen#

• Überblick über API v2
• API-Schlüssel
• Nachrichten (API v2)
• Apps & Integrationen