# Dokumentation per MCP (https://webmetic.de/docs/ki-assistent/dokumentation)

Diese Dokumentation hat einen eigenen MCP-Server. Ein verbundener KI-Client durchsucht sie, liest einzelne Seiten und beantwortet Fragen zu Webmetic mit den aktuellen Inhalten. Am Ende haben Sie:

- einen KI-Client, der Fragen zu Webmetic aus dieser Dokumentation beantwortet, zum Beispiel „Wie binde ich den Tracking-Code im Google Tag Manager ein?“
- in Claude Code oder Codex einen Agenten, der die API-Referenz liest, bevor er Code für die Webmetic-API schreibt

## Bevor Sie beginnen [#bevor-sie-beginnen]

- **Dauer**: Sie tragen eine Server-Adresse ein. Eine Anmeldung ist nicht nötig.
- **Konto**: Sie brauchen kein Webmetic-Konto, denn die Dokumentation ist öffentlich.
- **Zugang**: Ihr KI-Client muss MCP-Server über HTTP unterstützen. Das tun ChatGPT, Claude, Claude Code, Cursor, VS Code und Codex.
- **Plan**: Der Server kostet nichts und verbraucht keine Credits.

Der Server liegt unter dieser Adresse:

```text
https://webmetic.de/docs/~/mcp
```

Er bietet drei Tools: `list_pages` listet alle Seiten mit ihren Adressen, `get_page` liefert eine Seite als Markdown, und `search` durchsucht die Dokumentation auf Deutsch oder Englisch. Der Server liest nur diese Dokumentation und greift nicht auf Ihre Besucherdaten zu. Dafür verbinden Sie den [KI-Assistenten](https://webmetic.de/docs/ki-assistent/einrichten).

Clients ohne MCP lesen die Dokumentation als Text: Das Inhaltsverzeichnis liegt unter `https://webmetic.de/docs/llms.txt` und die ganze Dokumentation unter `https://webmetic.de/docs/llms-full/de.txt`. Sie lesen jede Seite auch als Markdown, wenn Sie `.md` an ihre Adresse anhängen.

## Claude Code [#claude-code]

1. Führen Sie im Terminal diesen Befehl aus:

   ```bash
   claude mcp add --transport http --scope user webmetic-docs https://webmetic.de/docs/~/mcp
   ```

   Claude Code ist jetzt mit der Dokumentation verbunden. Eine Anmeldung ist nicht nötig.

## Claude [#claude]

Claude auf claude.ai und Claude Desktop nutzen denselben Connector, sodass Sie ihn nur einmal einrichten. Der kostenlose Claude-Plan erlaubt genau einen eigenen Connector.

1. Öffnen Sie in Claude **Customize** > **Connectors**.
2. Klicken Sie auf **+ Add** und dann auf **Add custom connector**.
3. Geben Sie als Namen „Webmetic Docs“ ein und diese Adresse als Server-URL:

   ```text
   https://webmetic.de/docs/~/mcp
   ```

4. Klicken Sie auf **Continue**. Claude zeigt die erkannten Einstellungen für die Anmeldung.
5. Klicken Sie noch einmal auf **Continue**.
6. Wählen Sie unter **Authentication** die Option **No sign in** aus.
7. Klicken Sie auf **Add**. Claude ist jetzt mit der Dokumentation verbunden.

Im Chat schalten Sie den Connector über **+** > **Connectors** ein oder aus.

## ChatGPT [#chatgpt]

1. Öffnen Sie [ChatGPT Plugins](https://chatgpt.com/plugins).
2. Klicken Sie auf das Plus und dann auf **Add custom MCP server**.
3. Geben Sie als Namen „Webmetic Docs“ ein.
4. Geben Sie unter **Connection** im Feld **Server URL** diese Adresse ein:

   ```text
   https://webmetic.de/docs/~/mcp
   ```

5. Wählen Sie bei der Authentifizierung die Option ohne Anmeldung.
6. Lesen Sie den Warnhinweis und klicken Sie auf **I understand and want to continue**.
7. Klicken Sie auf **Create as a plugin**.
8. Installieren Sie das Plugin aus Ihren persönlichen Plugins. ChatGPT ist jetzt mit der Dokumentation verbunden.

Damit ChatGPT die Dokumentation nutzt, geben Sie im Chat `@` ein und wählen Webmetic Docs aus.

## Cursor [#cursor]

1. Öffnen Sie die Datei `~/.cursor/mcp.json`. Für ein einzelnes Projekt verwenden Sie `.cursor/mcp.json` im Projektordner.
2. Tragen Sie den Server unter `mcpServers` ein:

   ```json
   {
     "mcpServers": {
       "webmetic-docs": {
         "url": "https://webmetic.de/docs/~/mcp"
       }
     }
   }
   ```

3. Speichern Sie die Datei. Cursor zeigt den Server auf der Seite **Customize**, und eine Anmeldung ist nicht nötig.

## VS Code [#vs-code]

1. Öffnen Sie die Befehlspalette und führen Sie **MCP: Add Server** aus.
2. Wählen Sie **HTTP (HTTP or Server-Sent Events)** aus.
3. Geben Sie diese Adresse ein:

   ```text
   https://webmetic.de/docs/~/mcp
   ```

4. Geben Sie als Server-ID `webmetic-docs` ein.
5. Wählen Sie **Global** und danach **Copilot Global** aus, damit der Server in allen Projekten gilt. VS Code ist jetzt mit der Dokumentation verbunden.

## Codex [#codex]

1. Führen Sie im Terminal diesen Befehl aus:

   ```bash
   codex mcp add webmetic-docs --url https://webmetic.de/docs/~/mcp
   ```

   Codex verbindet sich ohne Anmeldung mit der Dokumentation.

## Verbindung prüfen [#verbindung-prüfen]

Stellen Sie Ihrem KI-Client eine Frage zu Webmetic, zum Beispiel „Wie binde ich den Tracking-Code im Google Tag Manager ein?“. Der Client durchsucht die Dokumentation und antwortet mit den Schritten von der Seite [Google Tag Manager](https://webmetic.de/docs/installation/google-tag-manager).

### Falls die Verbindung nicht funktioniert [#falls-die-verbindung-nicht-funktioniert]

- Der Client antwortet ohne die Dokumentation: Prüfen Sie, ob der Server im Client eingeschaltet ist. In Claude schalten Sie ihn über **+** > **Connectors** ein, und in ChatGPT wählen Sie ihn mit `@` aus.
- Der Client meldet, dass er den Server nicht erreicht: Die Adresse endet auf `/docs/~/mcp`. Prüfen Sie die Tilde und die Schrägstriche.

## Nächste Schritte [#nächste-schritte]

- [KI-Assistent verbinden](https://webmetic.de/docs/ki-assistent/einrichten): Denselben Client mit Ihrem Webmetic-Login verbinden, damit er Ihre Besucherdaten liest.
- [Claude-Plugin](https://webmetic.de/docs/ki-assistent/claude-plugin): Das Webmetic-Plugin für Claude Code mit vier Skills installieren.
- [API-Schnellstart](https://webmetic.de/docs/api/schnellstart): Die erste Anfrage an die Webmetic-API senden, mit oder ohne Konto.