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 einget_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ÜSSELContent-Type: application/jsonAccept: 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:execbzw.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.
confirmist 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_passwordundget_authcodegeben ihr Ergebnis an den Assistenten zurück, und damit an den Anbieter des Modells. - Tool-Annotations: Jedes Tool meldet
readOnlyHintund, wenn es etwas ändert,destructiveHint. Clients können damit entscheiden, wann sie nachfragen. Das sind Hinweise, keine Sicherheitsgrenze. - Ausgabegrenzen:
stdoutundstderrvon Exec-Tools sowie gelesener Text sind pro Ergebnis auf 256 KB begrenzt. Anfang und Ende bleiben erhalten, die Antwort enthält danntruncated: 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: