Skip to content

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 lassen sich Fragen zu smoxy-Funktionen, Konfiguration und API-Nutzung stellen, ohne die Entwicklungsumgebung zu verlassen.


Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Assistenten ermöglicht, sich mit externen Datenquellen zu verbinden. Mit dem smoxy MCP-Server kann der 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/mcp

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


Einrichtung

Claude Desktop

Claude Desktop verbindet sich über Custom Connectors mit entfernten HTTP-MCP-Servern:

  1. Einstellungen → Connectors öffnen.
  2. Ganz unten auf Add custom connector klicken.
  3. Einen Namen (zum Beispiel smoxy) und die URL https://docs.smoxy.eu/mcp eingeben.
  4. Auf Add klicken.

Alternativ lässt sich der entfernte Endpunkt beim direkten Bearbeiten der claude_desktop_config.json mit mcp-remote überbrücken:

json
{
  "mcpServers": {
    "smoxy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.smoxy.eu/mcp"]
    }
  }
}

Claude Code (CLI)

Den smoxy MCP-Server zu den Projekt- oder Benutzereinstellungen hinzufügen:

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

Cursor

Folgendes zur Cursor-MCP-Konfiguration hinzufügen - ~/.cursor/mcp.json für alle Projekte oder .cursor/mcp.json innerhalb eines bestimmten Projekts. Ein entfernter HTTP-Server benötigt nur das Feld url:

json
{
  "mcpServers": {
    "smoxy": {
      "url": "https://docs.smoxy.eu/mcp"
    }
  }
}

VS Code

Folgendes zur .vscode/mcp.json im Arbeitsbereich hinzufügen (oder über den Befehl MCP: Open User Configuration zur Benutzerkonfiguration). VS Code verwendet einen servers-Schlüssel auf oberster Ebene, entfernte Server verwenden "type": "http":

json
{
  "servers": {
    "smoxy": {
      "type": "http",
      "url": "https://docs.smoxy.eu/mcp"
    }
  }
}

Andere Tools

Jedes KI-Tool, das MCP mit HTTP-Transport unterstützt, kann sich mit der smoxy-Dokumentation verbinden. Die Endpunkt-URL https://docs.smoxy.eu/mcp in der MCP-Konfiguration des jeweiligen Tools verwenden.

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, lassen sich dem 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 Access-Rule-Bedingungen lassen sich 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 des smoxy-Kontos preis.
  • Immer aktuell: Der MCP-Server liefert die neueste veröffentlichte Version der Dokumentation. Wenn die Dokumentation aktualisiert wird, hat der KI-Assistent sofort Zugriff auf die neuen Inhalte.