Model Context Protocol (MCP)

Der Sitequest MCP-Endpunkt ermöglicht es KI-Assistenten wie GitHub Copilot, Claude oder anderen MCP-kompatiblen Clients, direkt mit deiner Infrastruktur zu interagieren.

Übersicht

MCP (Model Context Protocol) ist ein offener Standard, der KI-Anwendungen eine sichere Verbindung zu externen Tools und Datenquellen ermöglicht. Sitequest implementiert einen zustandslosen Streamable-HTTP-MCP-Server.

• Endpunkt: POST https://hosting.site.quest/mcp
• Protokollversion: 2025-03-26
• Transport: Streamable HTTP (zustandslos, JSON-Antworten)
• Authentifizierung: Dieselben API-Schlüssel wie bei der REST-API

Verfügbare Tools

VPS-Tools

Domain-Tools

Bestell-Tools

Webspace-Tools

Shared Webhosting mit isolierten PHP/MariaDB-Sites. SFTP- und Exec-Tools laufen als unprivilegierter Site-Linux-User, eingesperrt im Home-Verzeichnis der Site.

Webspace-Preise sind noch nicht via MCP verfügbar. Verwende den REST-Endpunkt GET /api/v1/webspaces/pricing, bis ein get_webspace_pricing-Tool ergänzt wurde.

Einrichtung für VS Code / GitHub Copilot

Erstelle eine .vscode/mcp.json-Datei in deinem Workspace:

{
  "servers": {
    "sitequest": {
      "type": "http",
      "url": "https://hosting.site.quest/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_API_SCHLÜSSEL"
      }
    }
  }
}

Ersetze DEIN_API_SCHLÜSSEL durch einen API-Schlüssel mit den benötigten Berechtigungen (z.B. vps:read, domains:read).

Nach dem Speichern erkennt VS Code den MCP-Server automatisch. Du kannst Copilot dann Fragen stellen wie:

• "Liste meine VPS auf"
• "Welche Domains habe ich?"
• "Zeige mir die Details für Server X"

Einrichtung für andere MCP-Clients

Jeder MCP-Client, der den Streamable-HTTP-Transport unterstützt, kann sich verbinden. Konfiguriere:

• URL: https://hosting.site.quest/mcp
• Methode: Nur POST (GET gibt 405 zurück)
• Header:
  • Authorization: Bearer DEIN_API_SCHLÜSSEL
  • Content-Type: application/json
  • Accept: application/json, text/event-stream

Manuelles JSON-RPC-Beispiel

Initialisierung:

curl -X POST https://hosting.site.quest/mcp \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": { "name": "mein-client", "version": "1.0" }
    }
  }'

Verfügbare Tools auflisten:

curl -X POST https://hosting.site.quest/mcp \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'

Tool aufrufen:

curl -X POST https://hosting.site.quest/mcp \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "list_vms",
      "arguments": {}
    }
  }'

Authentifizierung

MCP verwendet dasselbe API-Schlüssel-System wie die REST-API. Weitere Details zum Erstellen von Schlüsseln und Verwalten von Berechtigungen findest du unter Autorisierung.

Rate Limiting

MCP-Anfragen teilen sich dasselbe Rate-Limit wie die REST-API: 60 Anfragen pro Minute pro API-Schlüssel. Rate-Limit-Header sind in jeder Antwort enthalten.

Unterschiede zur REST-API

Quellcode & Client-Beispiele

Das Sitequest-MCP-Server-Listing, Beispielkonfigurationen für Clients (VS Code, Claude Desktop, Cursor und weitere) sowie der Eintrag für MCP-Verzeichnisse werden im öffentlichen Repository gepflegt:

github.com/Sitequest-Software/sitequest-mcp