# Hilfe in Ihrer KI (MCP)

Die Watbot-Hilfe hat einen MCP-Server. Verbinden Sie ihn mit Ihrem KI-Assistenten — Claude, ChatGPT, Cursor oder einem anderen, der das MCP-Protokoll unterstützt —, dann beantwortet der Assistent Fragen zu Watbot anhand der aktuellen Hilfe und verlinkt ihre Seiten. Ein Entwickler kann zum Beispiel direkt im Code-Editor fragen, wie eine API-Methode aufgerufen wird, ohne im Browser zu suchen.

Adresse des Servers:

```
https://support.watbot.org/mcp
```

- Ein API-Schlüssel oder der Pro-Tarif ist nicht nötig: Der Server ist offen, genau wie die Hilfe selbst.
- Der Server kennt nur die Seiten der Hilfe. Ihr Konto, Ihre Bots und Kontakte sieht er nicht — dafür gibt es die [API](https://support.watbot.org/de/api).
- Transport — Streamable HTTP, ohne Autorisierung.

> [!TIP]
> Die KI zur Hilfe fragen können Sie auch ohne Einrichtung: Der Button „KI fragen“ in der Kopfzeile der Hilfe öffnet den [KI-Chat](https://support.watbot.org/de/ai/chat) in Ihrem Konto mit der Frage im Eingabefeld. Senden Sie sie ab — das Modell sucht die Antwort in derselben Hilfe.

## Was der Server kann

| Werkzeug | Was es tut |
|---|---|
| `search_docs` | Durchsucht die Hilfe nach dem Sinn der Anfrage und liefert passende Abschnitte mit Links |
| `get_page` | Liefert den vollständigen Text einer Seite anhand ihrer Adresse — mit Links zu ihren Abschnitten und Unterseiten |
| `list_pages` | Zeigt das Inhaltsverzeichnis der Hilfe oder eines ihrer Bereiche |

Die Hilfe gibt es in mehreren Sprachen. Der Assistent wählt die Sprache mit dem Parameter `locale`; tut er das nicht, antwortet der Server in der Hauptsprache seiner Adresse.

## Verbinden

Dienste benennen ihre Menüpunkte hin und wieder um. Finden Sie den passenden nicht, suchen Sie in der Hilfe des Dienstes nach „custom MCP connector“ oder „remote MCP server“.

### Claude

Öffnen Sie in Claude im Web oder in der Desktop-App **Settings → Connectors** und klicken Sie auf **Add custom connector**. Der Name ist beliebig, zum Beispiel „Hilfe“; die Adresse ist die Serveradresse oben. Schalten Sie den Connector dann im Werkzeugmenü unter dem Eingabefeld ein.

### Claude Code

```bash
claude mcp add --transport http help https://support.watbot.org/mcp
```

### ChatGPT

Eigene MCP-Server verbindet ChatGPT im Entwicklermodus: **Settings → Apps → Advanced settings → Developer mode**. Legen Sie danach eine App an: die Serveradresse oben, Authentifizierung — **No Auth**. Den Entwicklermodus gibt es nicht in jedem ChatGPT-Tarif.

### Cursor

Fügen Sie den Server in `.cursor/mcp.json` im Projektordner hinzu oder in `~/.cursor/mcp.json` — dann steht er in allen Projekten bereit:

```json
{
  "mcpServers": {
    "help": {
      "url": "https://support.watbot.org/mcp"
    }
  }
}
```

### VS Code

Für den Agentenmodus von GitHub Copilot — die Datei `.vscode/mcp.json` im Projektordner:

```json
{
  "servers": {
    "help": {
      "type": "http",
      "url": "https://support.watbot.org/mcp"
    }
  }
}
```

### Andere Assistenten

Jeder Client, der entfernte MCP-Server über HTTP verbindet, ist geeignet: Geben Sie die Serveradresse an, eine Autorisierung ist nicht nötig. Kann der Client nur lokale Server starten, verbinden Sie die Hilfe über den Vermittler `mcp-remote` (Node.js erforderlich):

```json
{
  "mcpServers": {
    "help": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://support.watbot.org/mcp"]
    }
  }
}
```

## Verbindung prüfen

Fragen Sie den Assistenten: „Wie versende ich einen Newsletter nach Wochentagen? Suche die Antwort in der Hilfe.“ Er sollte `search_docs` aufrufen und mit einem Link auf die Hilfeseite zu Newslettern antworten.

## Ohne Verbindung

- **Eine einzelne Seite.** Der Button „Kopieren“ neben dem Titel jeder Seite kopiert ihren Text als Markdown — Sie können ihn in jeden KI-Chat einfügen. Der Pfeil daneben öffnet direkt ChatGPT und Claude mit einer Frage zur Seite.
- **Text der Seite** — dieselbe Adresse mit `.md` am Ende, bei der Startseite `/index.md`. Ohne Formatierung, Menüs und Skripte: So lässt sich die Seite der KI leichter geben.
- **Inhaltsverzeichnis für KI** — `/llms.txt` im Stammverzeichnis der Hilfe: alle Seiten mit Links zu ihrem Text in Markdown.

## Einschränkungen

- **Häufigkeit** — 60 Anfragen pro Minute von einer IP-Adresse. Über dem Limit antwortet der Server mit dem Code `429`; der Assistent kann die Anfrage nach einer Minute wiederholen.
- **Die Suche nach Sinn** hat ein eigenes Limit. Bei vielen Anfragen sucht der Server nur nach Wörtern: Ergebnisse gibt es weiterhin, sie passen aber weniger genau.