Anleitung

Deine KI mit kaiserservice verbinden

Ob Claude, Codex, Gemini oder Cursor — hier findest du für jedes Programm eine einfache Schritt-für-Schritt-Anleitung. Kein Vorwissen nötig.

Worum geht es hier?

Du kannst deiner KI (z. B. Claude oder ChatGPT) beibringen, direkt auf deine Projekte bei kaiserservice zuzugreifen — sie auflisten, öffnen, anlegen oder ändern. Dafür brauchst du nur zwei Dinge: eine Adresse und einen Token (das ist wie ein Passwort). Beides fügst du einmal in dein KI-Programm ein — fertig.

Schritt 1 · Hol dir deinen Token

Der Token ist dein persönlicher Schlüssel. Klicke auf den Knopf, kopiere den Token und komm dann hierher zurück. Überall wo unten DEIN_TOKEN steht, fügst du ihn ein.

Token kopieren
Merke dir die Adresse: https://kaiserservice.consulting/mcp — die brauchst du bei jedem Programm.

Schritt 2 · Wähle dein Programm

1 · Claude Desktop (macOS & Windows)

Claude Desktop-App Die App zum Herunterladen — für Einsteiger Einfach

Du musst nichts programmieren. Du öffnest eine Einstellungs-Datei, fügst einen kleinen Textblock ein und startest Claude neu.

  1. Claude Desktop öffnen und in die Einstellungen gehen

    Klicke oben in der Menüleiste den Weg entlang:

    Claude Einstellungen… Entwickler

    [Bild: Fenster „Einstellungen", links in der Liste den Punkt „Entwickler" anklicken.]

    Tastenkürzel: ⌘ , (Mac) bzw. Strg , (Windows).

  2. Auf „Konfiguration bearbeiten" klicken

    Im Tab Entwickler gibt es einen Knopf „Edit Config" (deutsch: „Konfiguration bearbeiten"). Ein Klick öffnet eine Datei namens claude_desktop_config.json in deinem Texteditor.

    [Bild: Grauer Knopf „Edit Config" im Entwickler-Tab.]

  3. Diesen Block einfügen

    Kopiere den Block unten (grüner Kopier-Knopf oben rechts) und füge ihn in die geöffnete, leere Datei ein. Ersetze DEIN_TOKEN durch deinen Token aus Schritt 1.

    {
      "mcpServers": {
        "kaiserservice": {
          "command": "npx",
          "args": [
            "-y", "mcp-remote",
            "https://kaiserservice.consulting/mcp",
            "--header",
            "Authorization: Bearer DEIN_TOKEN"
          ]
        }
      }
    }

    Wichtig: Der Text muss genau so aussehen — mit allen geschweiften Klammern { }. Nur DEIN_TOKEN tauschst du aus.

  4. Speichern & Claude neu starten

    Datei speichern (⌘ S / Strg S), Claude komplett schließen und wieder öffnen. Beim ersten Start lädt Claude einmalig ein kleines Hilfsprogramm — das kann ein paar Sekunden dauern.

  5. Testen 🎉

    Frag Claude im Chat: „Zeig mir meine Projekte auf kaiserservice." Wenn eine Liste kommt, hat alles geklappt.

Wo liegt die Datei? Falls der Knopf mal fehlt, findest du sie hier:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

2 · Claude Code (Terminal)

Claude Code Für alle, die schon mal ein Terminal offen hatten Fortgeschritten

Hier reicht ein einziger Befehl. Kein Datei-Editieren nötig.

  1. Terminal öffnen

    Öffne das Terminal (Mac: Programm „Terminal"; Windows: „Eingabeaufforderung" oder „PowerShell") und starte darin Claude Code.

  2. Token bereitlegen

    Kopiere deinen Token aus Schritt 1 — du fügst ihn gleich in den Befehl ein.

  3. Diesen einen Befehl eintippen

    Kopiere die Zeile, ersetze DEIN_TOKEN und drücke Enter:

    claude mcp add kaiserservice https://kaiserservice.consulting/mcp \
      --header "Authorization: Bearer DEIN_TOKEN"
  4. Prüfen

    Tippe claude mcp list. Wenn kaiserservice in der Liste auftaucht (mit 13 Tools), bist du fertig. 🎉

3 · Codex CLI (Terminal)

OpenAI Codex CLI Fast identisch zu Claude Code Fortgeschritten

Gleiche Idee wie oben — nur heißt der Befehl codex statt claude.

  1. Terminal öffnen & Token bereitlegen

    Terminal starten, Token aus Schritt 1 kopieren.

  2. Befehl eintippen

    Ersetze DEIN_TOKEN und drücke Enter:

    codex mcp add kaiserservice https://kaiserservice.consulting/mcp \
      --header "Authorization: Bearer DEIN_TOKEN"
  3. Prüfen

    Mit codex mcp list siehst du, ob kaiserservice verbunden ist. 🎉

4 · Codex-Plugin in VS Code

Codex Desktop / VS Code-Erweiterung Wenn du Codex direkt im Editor nutzt Mittel

Das Codex-Plugin nutzt dieselbe Konfigurations-Datei wie das Terminal. Am schnellsten geht es über den Terminal-Befehl aus Abschnitt 3 — die Verbindung gilt dann automatisch auch im Editor. Alternativ von Hand:

  1. Einstellungen des Codex-Plugins öffnen

    In VS Code:

    Zahnrad Erweiterungen Codex MCP Servers

    [Bild: Codex-Seitenleiste, unten der Abschnitt „MCP Servers" mit einem Plus-Knopf.]

  2. Server hinzufügen

    Suche die Datei config.toml von Codex (das Plugin verlinkt sie in den Einstellungen). Füge dort diesen Abschnitt ein und ersetze DEIN_TOKEN:

    [mcp_servers.kaiserservice]
    url = "https://kaiserservice.consulting/mcp"
    http_headers = { Authorization = "Bearer DEIN_TOKEN" }
  3. Editor neu laden

    VS Code neu laden (Befehl „Reload Window") oder schließen und wieder öffnen. 🎉

Tipp: Der Terminal-Befehl aus Abschnitt 3 erledigt genau das automatisch — spart dir das Suchen der Datei.

5 · Gemini CLI (Google)

Gemini CLI Googles KI im Terminal Mittel

Die Gemini CLI unterstützt MCP über eine Einstellungs-Datei (~/.gemini/settings.json). Vorgehen wie bei Claude Desktop:

  1. Datei öffnen

    Öffne ~/.gemini/settings.json in einem Texteditor (falls sie noch nicht existiert, lege sie an).

  2. Server eintragen

    Füge diesen mcpServers-Block ein und ersetze DEIN_TOKEN:

    {
      "mcpServers": {
        "kaiserservice": {
          "httpUrl": "https://kaiserservice.consulting/mcp",
          "headers": {
            "Authorization": "Bearer DEIN_TOKEN"
          }
        }
      }
    }
  3. Gemini neu starten

    Beende die Gemini CLI und starte sie neu. Mit /mcp siehst du die Verbindung. 🎉

Gut zu wissen: Das klassische Google AI Studio (die Web-Seite) kann externe MCP-Server bisher nicht anbinden. Nutze dafür die Gemini CLI wie oben.

6 · Cursor / Windsurf (Code-Editoren)

Cursor, Windsurf & ähnliche Editoren Eine Konfig für viele Programme Mittel

Diese Editoren nutzen fast alle dieselbe Art von MCP-Datei. Prinzip: Datei finden → Block einfügen → neu laden.

  1. MCP-Einstellungen öffnen
    Einstellungen Features / MCP Add Server

    In Cursor heißt die Datei ~/.cursor/mcp.json, in Windsurf ähnlich unter ~/.codeium/windsurf/.

  2. Diesen Block einfügen

    Ersetze DEIN_TOKEN und speichere:

    {
      "mcpServers": {
        "kaiserservice": {
          "url": "https://kaiserservice.consulting/mcp",
          "headers": {
            "Authorization": "Bearer DEIN_TOKEN"
          }
        }
      }
    }
  3. Editor neu laden

    Speichern, Editor neu starten — die 13 Tools stehen bereit. 🎉

7 · Jedes andere MCP-Programm

Alle übrigen MCP-Clients Nur zwei Angaben nötig

Unterstützt dein Programm das „Model Context Protocol" (MCP) über HTTP, brauchst du immer nur diese beiden Angaben:

# Adresse (URL)
https://kaiserservice.consulting/mcp

# Kopfzeile (Header)
Authorization: Bearer DEIN_TOKEN

Trage die URL als MCP-Server-Adresse ein und den Authorization-Header mit deinem Token. Das war's — die 13 Tools erscheinen automatisch.

Häufige Fragen

Was ist überhaupt ein „Token"?
Ein Token ist eine lange Zeichenkette, die wie ein Passwort funktioniert. Damit weiß kaiserservice, dass wirklich du zugreifst. Gib ihn niemals weiter und poste ihn nirgends öffentlich.
Ich habe meinen Token verloren — was tun?
Kein Problem: Gehe in die Einstellungen → API & MCP und erzeuge einen neuen. Der alte wird dann ungültig — trage den neuen überall dort ein, wo du den alten benutzt hast.
Es funktioniert nicht — woran liegt's meistens?
Die drei häufigsten Ursachen: (1) DEIN_TOKEN wurde vergessen auszutauschen. (2) Eine Klammer { } oder ein Komma fehlt beim Einfügen. (3) Das Programm wurde nach dem Speichern nicht neu gestartet. Prüfe zusätzlich, dass der MCP-Zugriff in deinen Einstellungen aktiviert ist.
Ist das sicher?
Ja. Die Verbindung läuft verschlüsselt über HTTPS. Dein Token gilt nur für dein Konto und kann jederzeit in den Einstellungen zurückgesetzt werden.

Für Entwickler · REST-API & Tools

Brauchst du keine KI-Anbindung, sondern direkten Zugriff per Code? Hier die technischen Details.

REST-Endpunkte

GET/api/projects
Alle Projekte auflisten (paginiert)

Query-Parameter: page (Seite, Default 1), per_page (Einträge pro Seite, 1–100, Default 20), q (Volltextsuche über Titel/Beschreibung/HTML) und category (nach Kategorie filtern). Antwort: {"items": [...], "total": n, "page": n, "per_page": n, "pages": n}

GET/api/projects/{id}
Einzelnes Projekt inkl. HTML
POST/api/projects
Neues Projekt erstellen
curl -X POST https://kaiserservice.consulting/api/projects \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Test","description":"Demo","category":"Tool","html_content":"<html>...</html>"}'
PUT/api/projects/{id}
Projekt aktualisieren
DELETE/api/projects/{id}
Projekt löschen
curl -X DELETE https://kaiserservice.consulting/api/projects/12 \
  -H "Authorization: Bearer DEIN_TOKEN"

MCP-Tools (13 verfügbar)

ToolBeschreibung
list_projectsAlle HTML-Projekte auflisten
get_projectEinzelnes Projekt + HTML-Inhalt
create_projectNeues Projekt erstellen (Titel + HTML)
update_projectBestehendes Projekt bearbeiten
delete_projectProjekt löschen
optimize_projectMobile-Optimierung (regex, schnell)
adapt_projectKI-Adaption via Claude Code (~1 Min)
search_projectsVolltextsuche in Titel, Beschreibung & HTML
list_categoriesAlle Kategorien inkl. Sub-Kategorien
get_dashboard_statsStatistiken: Anzahl, Speicher, Verteilung, letzte Änderungen
clone_projectProjekt duplizieren — Kopie mit »(Kopie)« im Titel
download_projectHTML als Datei auf dem Server speichern (Pfad zurück)
open_projectDirekte URLs zum Öffnen des Projekts
Hinweis: get_project liefert das Projekt inklusive vollem HTML-Inhalt. Für reine Metadaten nutze list_projects oder search_projects.