# smoxy MCP-Server

Die smoxy-Dokumentation ist als **Model Context Protocol (MCP)**-Server verfügbar. Dies ermöglicht es KI-Assistenten wie Claude, Cursor und VS Code Copilot, die smoxy-Dokumentation direkt zu durchsuchen und abzurufen — so kannst du Fragen zu smoxy-Funktionen, Konfiguration und API-Nutzung stellen, ohne deine Entwicklungsumgebung zu verlassen.

***

### Was ist MCP?

Das [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) ist ein offener Standard, der es KI-Assistenten ermöglicht, sich mit externen Datenquellen zu verbinden. Mit dem smoxy MCP-Server kann dein KI-Assistent:

* Die gesamte smoxy-Dokumentation durchsuchen
* Bestimmte Dokumentationsseiten abrufen
* Fragen anhand aktueller smoxy-Inhalte beantworten

***

### MCP-Endpunkt

Der smoxy MCP-Server ist erreichbar unter:

```
https://docs.smoxy.eu/~gitbook/mcp
```

Dieser Endpunkt verwendet **HTTP-Transport** und bietet schreibgeschützten Zugriff auf die gesamte veröffentlichte smoxy-Dokumentation.

***

### Einrichtung

#### Claude Desktop

Füge Folgendes zu deiner Claude Desktop MCP-Konfigurationsdatei (`claude_desktop_config.json`) hinzu:

```json
{
  "mcpServers": {
    "smoxy": {
      "type": "url",
      "url": "https://docs.smoxy.eu/~gitbook/mcp"
    }
  }
}
```

#### Claude Code (CLI)

Füge den smoxy MCP-Server zu deinen Projekt- oder Benutzereinstellungen hinzu:

```bash
claude mcp add smoxy --transport http "https://docs.smoxy.eu/~gitbook/mcp"
```

#### Cursor

Füge den MCP-Server in deinen Cursor-Einstellungen unter **MCP Servers** hinzu:

* **Name:** `smoxy`
* **Type:** `URL`
* **URL:** `https://docs.smoxy.eu/~gitbook/mcp`

#### VS Code

Füge Folgendes zu deiner VS Code `settings.json` oder `.vscode/mcp.json` hinzu:

```json
{
  "mcpServers": {
    "smoxy": {
      "type": "url",
      "url": "https://docs.smoxy.eu/~gitbook/mcp"
    }
  }
}
```

#### Andere Tools

Jedes KI-Tool, das MCP mit HTTP-Transport unterstützt, kann sich mit der smoxy-Dokumentation verbinden. Verwende die Endpunkt-URL `https://docs.smoxy.eu/~gitbook/mcp` in der MCP-Konfiguration deines Tools.

> **Hinweis:** Tools, die nur stdio- oder SSE-Transport unterstützen, sind nicht kompatibel. Der smoxy MCP-Server verwendet ausschließlich HTTP-Transport.

***

### Anwendungsbeispiele

Sobald verbunden, kannst du deinem KI-Assistenten Fragen stellen wie:

* „Wie konfiguriere ich Cache-Tags in smoxy?"
* „Welche Protokolle stehen für Log Forwarding zur Verfügung?"
* „Wie funktioniert die SSL-Zertifikatserneuerung in smoxy?"
* „Welche Zugriffsregel-Bedingungen kann ich in smoxy verwenden?"
* „Wie lade ich eine benutzerdefinierte Fehlerseite über die smoxy-API hoch?"

Der Assistent durchsucht die smoxy-Dokumentation und liefert Antworten basierend auf den neuesten veröffentlichten Inhalten.

***

### Wichtige Hinweise

* **Nur veröffentlichte Inhalte:** Der MCP-Server bietet Zugriff auf veröffentlichte Dokumentation. Entwürfe oder unveröffentlichte Änderungen sind nicht verfügbar.
* **Schreibgeschützt:** Der MCP-Server bietet nur Dokumentationssuche und -abruf. Er gibt keine Benutzerdaten, Analysen oder Konfigurationen deines smoxy-Kontos preis.
* **Immer aktuell:** Der MCP-Server liefert die neueste veröffentlichte Version der Dokumentation. Wenn die Dokumentation aktualisiert wird, hat dein KI-Assistent sofort Zugriff auf die neuen Inhalte.
