Zum Inhalt springen
AffiliateAI
DE EN Zugang anfragenAnfragen Menü

Doku

MCP: KI-Assistenten anbinden

Die Steuerzentrale ist ein MCP-Server (Model Context Protocol). KI-Assistenten wie Claude Code, Claude.ai, ChatGPT oder eigene Agenten steuern damit deine Sites: Status lesen, Kategorien und Texte pflegen, Templates ändern, ausrollen und zurückrollen.

Endpunkt: https://affiliateai.evnxt.de/mcp (Streamable HTTP, JSON-Antworten, ohne Sitzung).

Zugang: Token oder OAuth

  • Personal Access Token: in der Steuerzentrale unter MCP und Tokens anlegen. Du wählst Name, Ablauf (1 bis 365 Tage), die Sites und die Rechte-Stufen. Der Token wird genau einmal angezeigt und bei uns nur als Hash gespeichert.
  • OAuth 2.1: Claude.ai, ChatGPT und Claude Code können sich auch ohne Token anmelden. Sie registrieren sich selbst (Dynamic Client Registration), du meldest dich an und bestätigst Sites, Rechte und Laufzeit auf einer Zustimmungsseite. PKCE ist Pflicht, Zugriffe widerrufst du jederzeit in der Steuerzentrale.

Einbinden

Claude Code

Mit Token:

claude mcp add --transport http affiliateai https://affiliateai.evnxt.de/mcp \
  --header "Authorization: Bearer DEIN_TOKEN"

Mit OAuth: denselben Befehl ohne --header ausführen, dann in Claude Code /mcp aufrufen und Authenticate wählen.

Claude.ai und Claude Desktop

Einstellungen, Connectors, Benutzerdefinierten Connector hinzufügen, URL https://affiliateai.evnxt.de/mcp. Die Anmeldung läuft über OAuth, eine Client-ID brauchst du nicht.

ChatGPT

Einstellungen, Apps und Connectors, Erweitert, Entwicklermodus einschalten, Connector erstellen, URL wie oben, Authentifizierung OAuth.

OpenAI Responses-API 

{
  "type": "mcp",
  "server_label": "affiliateai",
  "server_url": "https://affiliateai.evnxt.de/mcp",
  "headers": {"Authorization": "Bearer DEIN_TOKEN"},
  "require_approval": "always"
}

Rechte-Stufen

Stufe Erlaubt
lesen Status, Inhalte, Produkte, Code und Deploy-Verlauf lesen
inhalte Kategorien, Marken, Filter, Seitentexte, Suchaufträge, Ausschlüsse ändern, Jobs anstoßen
code Dateien deiner Überlagerung ändern, Vorschau prüfen
deploy ausrollen und zurückrollen

Wirksam ist immer die Schnittmenge aus Token-Stufen, deiner Rolle im Konto (Mitglieder dürfen nur lesen) und den freigegebenen Sites.

Werkzeuge (42)

Bereich Werkzeuge
Überblick sites_auflisten, site_status
Inhalte profil_lesen, kategorien_auflisten, kategorie_lesen, kategorie_anlegen, kategorie_aendern, kategorie_loeschen, marken_auflisten, marken_pflegen, filter_setzen, seitentext_lesen, seitentext_setzen, seitentext_erzeugen, suchauftraege_auflisten, suchauftrag_anlegen, suchauftrag_pausieren, suchauftrag_loeschen, ausschluesse_auflisten, ausschluss_setzen, ausschluss_entfernen
Daten produkte_suchen, produkt_lesen, preisalter, statistik, job_starten, job_status
Code dateien_auflisten, datei_lesen, kern_template_lesen, datei_schreiben, datei_ersetzen, datei_patchen, datei_loeschen, aenderungen_verlauf, aenderungen_diff, aenderung_zuruecknehmen
Deploy vorschau_pruefen, deploy_starten, deploy_status, deploy_verlauf, zurueckrollen

Werkzeuge, die etwas löschen oder live schalten, sind für den Assistenten als riskant markiert, damit er vorher nachfragt.

Sicherheitsmodell

  • Nur deine Schicht: Code-Werkzeuge ändern ausschließlich Dateien deiner Überlagerung (Templates, Assets, Module, Migrationen). Der Kern ist tabu, ebenso Punktdateien, Symlinks und Pfade mit ... Dateien sind auf UTF-8-Text bis 200 KB begrenzt.
  • Jede Änderung ist ein Commit mit dem Zusatz „via MCP“ und lässt sich mit aenderung_zuruecknehmen rückgängig machen.
  • Vorschau-Prüfung: Jeder Deploy über MCP wird vorher gebaut, auf Syntax geprüft und mit echten Daten gerendert. Schlägt das fehl, geht nichts live. Siehe Deploy.
  • Rate-Limit: 120 Aufrufe pro Minute je Token.
  • Audit-Log: Jeder Werkzeug-Aufruf wird mit Zugang, Stufe, zusammengefassten Parametern, Ergebnis und Dauer protokolliert. Inhalte selbst landen nicht im Log, nur ihre Länge und Prüfsumme.

Ein Beispiel

„Lege auf der Site zelte eine Kategorie Kuppelzelte für 3 bis 4 Personen an, schreib einen Seitentext und roll sie aus.“

Der Assistent ruft dann nacheinander etwa sites_auflisten, profil_lesen, kategorie_anlegen, job_starten (katalog, zuordnung), seitentext_erzeugen, deploy_starten und deploy_status auf. Gefällt dir das Ergebnis nicht: „Roll auf den vorherigen Deploy zurück.“

Frage offen geblieben? Schreib uns über das Anfrageformular, wir ergänzen die Doku.