API-Dokumentation

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://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

Tool Erforderlicher Scope Beschreibung
vps_get_pricing — VPS-Komponentenpreise und Konfigurationen berechnen
vps_list vps:read Alle VPS mit Status, Spezifikationen und Nutzungsmetriken auflisten
vps_get vps:read Detaillierte VPS-Informationen einschließlich Live-Konfiguration und Status
vps_get_monitoring vps:read CPU-/Arbeitsspeicher-/Ping-Verlauf und Ausfallstatistiken
vps_get_traffic vps:read Aktuelle Bandbreitennutzung und tägliches Traffic-Protokoll
vps_list_files vps:files Verzeichnisinhalte per SFTP auflisten
vps_read_file vps:files Dateiinhalt per SFTP lesen
vps_power vps:manage VPS starten, stoppen oder neustarten (Stoppen und Neustarten erfordern Bestätigung)
vps_mount_iso vps:manage ISO-Image einbinden oder aushängen
vps_set_label vps:manage Anzeigenamen eines VPS aktualisieren
vps_list_backups vps:manage Alle Sicherungen eines VPS auflisten
vps_create_backup vps:manage Neue Sicherung erstellen (Bestätigung erforderlich)
vps_restore_backup vps:manage VPS aus einer Sicherung wiederherstellen (destruktiv, Bestätigung erforderlich)
vps_delete_backup vps:manage Sicherung löschen (destruktiv, Bestätigung erforderlich)
vps_get_firewall vps:manage Firewall-Status und Regeln abrufen
vps_manage_firewall vps:manage Regeln hinzufügen/entfernen, Firewall aktivieren/deaktivieren
vps_mkdir vps:manage Verzeichnis anlegen
vps_delete_path vps:manage Datei oder Verzeichnis löschen (Bestätigung erforderlich)
vps_get_ssh_security vps:manage SSH-Sicherheitseinstellungen abrufen
vps_set_password_auth vps:manage Passwort-Anmeldung per SSH ein- oder ausschalten
vps_set_sha1_hmac vps:manage Veraltete hmac-sha1-Algorithmen ein- oder ausschalten
vps_set_ssh_banner vps:manage SSH-Banner vor der Anmeldung ein- oder ausblenden
vps_set_post_quantum_kex vps:manage Post-Quantum-Schlüsselaustausch ein- oder ausschalten
vps_set_legacy_ciphers vps:manage Veraltete Chiffren ein- oder ausschalten
vps_update_openssh vps:manage OpenSSH auf die neueste Version aktualisieren
vps_rescue_password_auth vps:manage Passwort-Anmeldung über den Hypervisor wiederherstellen, wenn SSH nicht erreichbar ist
vps_list_ssh_keys vps:manage Alle SSH-Schlüssel auf einem VPS auflisten
vps_delete_ssh_key vps:manage Einen SSH-Schlüssel von einem VPS entfernen (Bestätigung erforderlich)
vps_reset_password vps:exec Neues Root-Passwort generieren (destruktiv, Bestätigung erforderlich)
vps_write_file vps:exec Dateiinhalt per SFTP schreiben (max. 32 MB)
vps_rename vps:exec Datei oder Verzeichnis umbenennen oder verschieben
vps_chmod vps:exec Berechtigungen ändern
vps_generate_ssh_key vps:exec SSH-Schlüsselpaar generieren, optional für Web-Terminal speichern
vps_upload_ssh_key vps:exec Öffentlichen SSH-Schlüssel hochladen, optional für Web-Terminal speichern
vps_exec vps:exec Einmaligen SSH-Befehl als root ausführen
vps_upgrade vps:scale VPS-Ressourcen upgraden (CPU, RAM, Speicher usw., Bestätigung erforderlich)
vps_cancel vps:cancel VPS-Abo zum Ende der Abrechnungsperiode kündigen (Bestätigung erforderlich)
vps_uncancel vps:cancel Gekündigtes VPS-Abo reaktivieren
vps_create vps:provision Neuen VPS erstellen (erstellt Bestellung + belastet Mandat, Bestätigung erforderlich)
vps_reinstall_os vps:provision Betriebssystem neu installieren (destruktiv, Bestätigung erforderlich)

Domain-Tools

Tool Erforderlicher Scope Beschreibung
get_domain_pricing — Verfügbare TLDs und ihre Preise auflisten
check_domain — Verfügbarkeit, Premium-Status und Preis einer Domain prüfen
list_domains domains:read Alle Domains mit Registrierungsstatus und DNS-Eintragsanzahl auflisten
get_domain domains:read Detaillierte Domain-Informationen einschließlich DNS-Einträgen und Registrar-Daten
list_dns_records domains:read DNS-Einträge einer Domain auflisten
add_dns_record domains:manage DNS-Eintrag erstellen
edit_dns_record domains:manage Vorhandenen DNS-Eintrag aktualisieren
delete_dns_record domains:manage DNS-Eintrag entfernen (Bestätigung erforderlich)
set_nameservers domains:manage Domain-Nameserver aktualisieren
set_transfer_lock domains:manage Transfersperre aktivieren oder deaktivieren
set_whois_privacy domains:manage WHOIS-Datenschutz aktivieren oder deaktivieren
set_dnssec domains:manage DNSSEC aktivieren oder deaktivieren
get_authcode domains:manage Domain-Authcode (Transferschlüssel) abrufen, nur für den Domain-Inhaber
cancel_domain domains:cancel Domain zum Ende der Abrechnungsperiode kündigen (destruktiv, Bestätigung erforderlich)
uncancel_domain domains:cancel Gekündigte Domain reaktivieren
register_domain domains:provision Neue Domain registrieren (erstellt Bestellung + belastet Mandat, Bestätigung erforderlich)
transfer_domain domains:provision Domain zu Sitequest transferieren (erstellt Bestellung + belastet Mandat, Bestätigung erforderlich)

Bestell-Tools

Tool Erforderlicher Scope Beschreibung
get_order_status vps:scale, webspace:scale oder domains:provision Bestellstatus anhand von ID oder Token abrufen

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.

Tool Erforderlicher Scope Beschreibung
webspace_list webspace:read Alle Webspaces mit Status, Plan, CMS und Kontingentnutzung auflisten
webspace_get webspace:read Webspace inklusive verknüpfter Domains und Speicherplatznutzung abrufen
webspace_get_ssh_info webspace:read SSH-Verbindungsdaten (Host, Port, Benutzername, Host-Key-Fingerprint)
webspace_list_files webspace:files Verzeichnisinhalte per Jailed SFTP auflisten
webspace_read_file webspace:files Datei per Jailed SFTP lesen
webspace_set_label webspace:manage Anzeigenamen aktualisieren
webspace_set_php webspace:manage PHP-Version ändern (8.2 – 8.5, Bestätigung erforderlich)
webspace_install_cms webspace:manage WordPress, Joomla, TYPO3 oder Static installieren/neu installieren (löscht Docroot, Bestätigung erforderlich)
webspace_link_domain webspace:manage Benutzereigene Domain verknüpfen und Let's-Encrypt-Zertifikat ausstellen
webspace_unlink_domain webspace:manage Verknüpfte Domain lösen (Bestätigung erforderlich)
webspace_reset_db_password webspace:manage MariaDB-Passwort zurücksetzen (neues Passwort wird einmal zurückgegeben, Bestätigung erforderlich)
webspace_mkdir webspace:manage Neues Verzeichnis im Jail erstellen
webspace_delete_path webspace:manage Datei oder Verzeichnis löschen (Bestätigung erforderlich)
webspace_list_ssh_keys webspace:manage Autorisierte SSH-Schlüssel auflisten
webspace_delete_ssh_key webspace:manage Autorisierten SSH-Schlüssel anhand des Fingerprints entfernen (Bestätigung erforderlich)
webspace_write_file webspace:exec Datei per Jailed SFTP schreiben (max. 32 MB)
webspace_rename webspace:exec Innerhalb des Jails umbenennen / verschieben
webspace_chmod webspace:exec Berechtigungen einer Datei/eines Verzeichnisses ändern
webspace_add_ssh_key webspace:exec Autorisierten SSH-Public-Key hochladen
webspace_exec webspace:exec Einmaligen SSH-Befehl in der Jailed Shell ausführen
webspace_upgrade webspace:scale Speicherplatz und/oder Anzahl Datenbanken kostenpflichtig erhöhen, kein Downgrade (Bestätigung erforderlich)
webspace_cancel webspace:cancel Webspace-Abo zum Ende der Abrechnungsperiode kündigen (destruktiv, Bestätigung erforderlich)
webspace_uncancel webspace:cancel Gekündigtes Webspace-Abo reaktivieren
webspace_create webspace:provision Bezahlten Webspace bereitstellen (erstellt Bestellung + belastet Mandat)
webspace_claim_free webspace:provision Einmaligen Free-Tier-Webspace für das Konto beanspruchen
webspace_delete webspace:provision Kostenlosen Webspace dauerhaft löschen (destruktiv, Bestätigung erforderlich). Bezahlte Webspaces enden über webspace_cancel

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://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 JetBrains

Öffne in deiner JetBrains-IDE Einstellungen → Tools → AI Assistant → Model Context Protocol (MCP), klicke auf Hinzufügen und füge diese Konfiguration ein:

{
  "mcpServers": {
    "sitequest": {
      "url": "https://site.quest/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_API_SCHLÜSSEL"
      }
    }
  }
}

Einrichtung für Claude Code

Füge den Server im Terminal mit einem Befehl hinzu:

claude mcp add --transport http sitequest https://site.quest/mcp \
  --header "Authorization: Bearer DEIN_API_SCHLÜSSEL"

Mit --scope project landet die Konfiguration in der .mcp.json deines Projekts und gilt für alle, die im Repository arbeiten. Lege den Schlüssel dann nicht in die Datei, sondern in eine Umgebungsvariable. In einer Claude-Code-Sitzung zeigt /mcp, ob der Server verbunden ist.

Einrichtung für Cursor

Lege eine .cursor/mcp.json in deinem Projekt an (oder ~/.cursor/mcp.json für alle Projekte):

{
  "mcpServers": {
    "sitequest": {
      "url": "https://site.quest/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_API_SCHLÜSSEL"
      }
    }
  }
}

Unter Settings → MCP siehst du danach den Server und seine Tools.

Einrichtung für andere MCP-Clients

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

  • URL: https://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://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://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://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": "vps_list",
      "arguments": {}
    }
  }'

Sicherheit und Limits

Ein verbundener KI-Assistent handelt mit den Rechten des Schlüssels. Dateien, Logs und Befehlsausgaben können Anweisungen enthalten, die der Assistent für deine hält.

  • Codeausführung ist ein eigener Scope. Befehle, Schreibzugriffe und neue SSH-Schlüssel gibt es nur mit vps:exec bzw. webspace:exec.
  • Für reine Diagnose reicht files. Damit kann ein Assistent Logs und Konfiguration lesen, aber nichts ändern. Geheimnisse in diesen Dateien sieht er trotzdem.
  • Schränke den Schlüssel ein. Gib ihm nur die nötigen Scopes und Ressourcen, siehe Autorisierung.
  • confirm ist keine menschliche Freigabe. Der Parameter schützt vor Versehen, aber das Modell setzt ihn selbst.
  • Rückfragen regelst du in deinem KI-Tool. Dort legst du fest, ob es vor Tool-Aufrufen fragt oder automatisch läuft. Automatische Modi solltest du nur mit eng eingeschränkten Schlüsseln nutzen, und möglichst mit einem Ausgabenlimit.
  • Geheimnisse landen im Kontext. vps_reset_password, webspace_reset_db_password und get_authcode geben ihr Ergebnis an den Assistenten zurück, und damit an den Anbieter des Modells.
  • Tool-Annotations: Jedes Tool meldet readOnlyHint und, wenn es etwas ändert, destructiveHint. Clients können damit entscheiden, wann sie nachfragen. Das sind Hinweise, keine Sicherheitsgrenze.
  • Ausgabegrenzen: stdout und stderr von Exec-Tools sowie gelesener Text sind pro Ergebnis auf 256 KB begrenzt. Anfang und Ende bleiben erhalten, die Antwort enthält dann truncated: true. Base64-Lesevorgänge über dieser Grenze schlagen fehl; nutze dafür die REST-API.
  • Audit: Aktionen erscheinen im Aktivitätsprotokoll mit dem Kanal mcp, und der verwendete API-Schlüssel wird mitgespeichert. Alle Aktionen einer Client-Sitzung tragen dieselbe Lauf-ID und lassen sich dort gemeinsam anzeigen.

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

Merkmal REST-API MCP
Protokoll HTTP REST JSON-RPC 2.0 über HTTP
Methoden Standard-HTTP-Verben Nur POST
Antwortformat { "data": ... } JSON-RPC Result/Error
Sitzungen Zustandslos Zustandslos (kein SSE-Streaming). Mcp-Session-Id dient nur als Lauf-ID.
Anwendungsfall Direkte Integration KI-Assistenten-Integration

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