KI-Zugang für Ihre Website (MCP): Dokumentation

Auf einen Blick

Endpunkt

https://www.webentwickler.io/mcp

Transport

Streamable HTTP, JSON-RPC 2.0, zustandslos

Anmeldung

OAuth 2.1 (Konnektor) oder Schlüssel wio_mcp_…

Protokollversionen

2025-06-18, 2025-03-26, 2024-11-05

Werkzeuge

42: 28 lesen, 13 ändern, 1 veröffentlicht

Standort

Unser Server in Deutschland

Die eine Regel: Inhalte ja, Technik nie

Der KI-Zugang darf ändern, was auf Ihrer Seite steht: Texte, Seitentitel und Beschreibungen für Google. Er darf nie ändern, wie Ihre Seite funktioniert. Diese Grenze hängt nicht an einer Bitte an die KI, sondern steckt im Code des Servers:

Einrichten

Ohne Schlüssel: als Konnektor anmelden

claude.ai und Claude Desktop: Einstellungen → Konnektoren → „Benutzerdefinierten Konnektor hinzufügen“. Als Adresse https://www.webentwickler.io/mcp eintragen und „Verbinden“ wählen. Es öffnet sich die Anmeldung des webentwickler.io CRM (Login-Link per Mail, falls Sie nicht angemeldet sind). Dort wählen Sie Website, Recht und Dauer der Verbindung und bestätigen.

Claude Code: ohne Schlüssel hinzufügen, danach in Claude Code /mcp eingeben und „Authenticate“ wählen:

claude mcp add --transport http webseite https://www.webentwickler.io/mcp

Die Verbindung erscheint im Reiter „KI-Zugang für Ihre Website (MCP)“ als „Anmeldung (OAuth)“ und lässt sich dort jederzeit trennen. Wer die Verbindung nicht selbst gestartet hat, wählt auf der Freigabeseite „Ablehnen“.

Mit Schlüssel

Für Programme ohne OAuth oder für Skripte gibt es weiterhin Schlüssel.

1. Schlüssel anlegen

Im webentwickler.io CRM im Reiter „KI-Zugang für Ihre Website (MCP)“ auf „Neuer Schlüssel“. Name, Recht, Gültigkeit und Obergrenze wählen (siehe Schlüssel und Rechte). Der Schlüssel beginnt mit wio_mcp_ und wird genau einmal angezeigt.

2. Mit dem KI-Assistenten verbinden

Claude Code: ein Befehl im Terminal, Schlüssel einsetzen:

claude mcp add --transport http webseite https://www.webentwickler.io/mcp --header "Authorization: Bearer wio_mcp_…"

Claude Desktop: unter Einstellungen → Entwickler → „Konfiguration bearbeiten“ diesen Eintrag ergänzen (benötigt Node.js) und Claude Desktop neu starten:

{
  "mcpServers": {
    "webseite": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.webentwickler.io/mcp",
               "--header", "Authorization:${AUTH}"],
      "env": { "AUTH": "Bearer wio_mcp_…" }
    }
  }
}

Andere Programme: Jedes Programm, das MCP über „Streamable HTTP“ spricht (z. B. Cursor), funktioniert mit der Adresse oben, mit Anmeldung (OAuth) oder mit dem Kopf Authorization: Bearer wio_mcp_…. Wo eine Firewall diesen Kopf abschneidet, geht ersatzweise X-Api-Token: wio_mcp_….

3. Ausprobieren

Beispielaufträge zum Kopieren:

• „Welche Seiten hat meine Website, und welche davon haben keine Beschreibung für Google?“
• „Wo steht noch die alte Telefonnummer 04103 123456?“
• „Ändere auf der Startseite die Überschrift auf ‚Ihr Makler an der Elbe‘. Zeig mir vorher die Vorschau.“
• „Füge in der Aufzählung auf /leistungen nach dem zweiten Punkt ‚Beratung vor Ort‘ ein.“
• „Welche Suchbegriffe bringen Besucher auf /leistungen, und passt der Seitentitel dazu?“
• „Welche Bilder auf der Startseite haben keine gute Bildbeschreibung? Schlag bessere vor.“
• „Was liegt gerade im Entwurf und ist noch nicht live?“
• „Veröffentliche die Änderungen.“

Schlüssel und Rechte

Entwurf, Veröffentlichen, Zurücknehmen

1. Finden: mit seite_texte, text_suchen oder seite_gliederung das richtige Feld bestimmen.
2. Ändern: jedes ändernde Werkzeug legt einen Entwurf an. Die Website zeigt ihn noch nicht. Vorher sichert der Server automatisch.
3. Zeigen: vorschau stellt alt und neu nebeneinander, entwurf_stand listet alles Offene.
4. Veröffentlichen: veroeffentlichen stellt alle Entwürfe des KI-Zugangs auf einmal live. Wurde auf der Website inzwischen direkt etwas geändert, veröffentlicht der Server nicht, damit nichts überschrieben wird. Entwürfe, die jemand im webentwickler.io CRM angefangen hat, nimmt er nicht mit.
5. Zurücknehmen: rueckgaengig nimmt eine Änderung (Nummer aus aenderungen) oder alles seit einer Sicherung zurück; war der alte Stand schon live, danach erneut veröffentlichen. entwurf_verwerfen verwirft Entwürfe, ohne die Website zu berühren.

Blockseiten (z. B. Leistungsseiten aus Blöcken) sind ebenfalls Entwurf. Beim Veröffentlichen schreibt der Server zuerst die Blockseiten, jede vorher gesichert, dann die Texte, und prüft danach auch diese Seiten. Dieselben Entwürfe sehen Sie im Adminbalken und im Editor des webentwickler.io CRM.

Die 42 Werkzeuge

Werkzeugnamen und Parameternamen sind deutsch und fest; so ruft der Assistent sie auf. Die Liste entspricht dem, was der Server bei tools/list liefert.

Orientierung

Seiten und Texte lesen

SEO, Google, KI-Sichtbarkeit, Barrierefreiheit und Monatsbericht

Entwürfe, Verlauf und Wünsche

Inhalte ändern (Entwurf)

Zurücknehmen und Verwerfen

Online-Terminbuchung

Wünsche und Feedback an das Team

Freigabe und Veröffentlichen

Gliederung: Überschriften, Listen, Karten

• Aufzählungen lassen sich punktweise bearbeiten, höchstens 30 Punkte, keine Unterpunkte. Ob eine Liste bearbeitbar ist, zeigt seite_gliederung (bearbeitbar).
• Neue Liste unter einem Absatz: seite_gliederung zeigt unter steckplaetze die freien Plätze; liste_bearbeiten mit aktion: anlegen setzt dort eine Liste ein.
• Überschriften-Ebenen: Das Aussehen bleibt, nur die Ebene ändert sich, in allen Sprachen. H3 vor der ersten H2 oder Sprünge lehnt der Server mit Begründung ab.
• Karten und Einträge: beim Hinzufügen alle Felder in jeder Sprache angeben; mindestens ein Eintrag bleibt, höchstens so viele, wie seite_gliederung als hoechstens nennt.
• Mehrsprachige Seiten: Listen ändern nur die gewählte Sprache; Ebenen und Anzahl der Karten gelten in allen Sprachen.
• Noch nicht umgestellte Seiten: Zeigt seite_gliederung nichts Umschaltbares, stellt unser Team die Vorlage einmalig um, über anpassung_beauftragen.

Protokoll und Fehlercodes

Jede Anfrage ist ein POST mit JSON-RPC 2.0, die Antwort kommt als application/json. Keine Dauerverbindung, keine Sitzungs-ID, kein Server-Sent-Events-Strom. Stapel (JSON-Arrays) älterer Protokollfassungen werden angenommen.

Anmeldung (OAuth 2.1)

Umgesetzt nach der MCP-Spezifikation „Authorization“ (2025-06-18). Ohne Anmeldung antwortet /mcp mit 401 und WWW-Authenticate: Bearer resource_metadata=…; daran erkennt der Assistent den Anmeldeserver.

• Rückleitungen nur an https://claude.ai/api/mcp/auth_callback, https://claude.com/api/mcp/auth_callback und an das eigene Gerät (http://localhost, 127.0.0.1, [::1]). Andere Programme schalten wir auf Anfrage frei.
• Der Parameter resource muss https://www.webentwickler.io/mcp sein. Scope ist mcp; Website und Recht wählt der Mensch auf der Freigabeseite.
• Wird ein Code oder Erneuerungstoken ein zweites Mal benutzt, trennt der Server die ganze Verbindung.

Beispiel

curl https://www.webentwickler.io/mcp \
  -H "Authorization: Bearer wio_mcp_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"test","version":"1.0"}}}'

curl https://www.webentwickler.io/mcp \
  -H "Authorization: Bearer wio_mcp_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"text_suchen","arguments":{"begriff":"04103 123456"}}}'

Antwort auf tools/call:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{ "type": "text", "text": "{ … }" }],
    "structuredContent": { … },
    "isError": false
  }
}

HTTP-Status und JSON-RPC-Fehler

Was der KI-Zugang nie tut

• Code: PHP, JavaScript, CSS, Vorlagen, .htaccess, auch nicht „nur eine Zeile“.
• Formulare: Felder, Pflichtfelder, Empfänger, Spamschutz, Bestätigungstexte.
• Tracking und Einwilligung: Zähler, Tag Manager, Cookie-Banner, eingebettete Dienste.
• Adressen und Indexierung: Weiterleitungen, robots.txt, Sitemap, noindex, Canonical, Sprachpfade.
• Seitenstruktur: Seiten anlegen oder löschen, Abschnitte umbauen, Menü umsortieren. Erlaubt ist nur, was die Vorlage vorsieht: Punkte in Aufzählungen, Listen in freien Plätzen, Überschriften-Ebenen, Karten in Kartenreihen, Blöcke auf Blockseiten.
• Zugänge: Serverzugang, Datenbank, Dateien, andere Websites als die des Schlüssels.

In Stufe 1 zusätzlich noch gesperrt: Rechtstexte (Impressum, Datenschutz), Stammdaten (Telefon, Anschrift, Links), FAQ-Einträge, Menü-Beschriftungen und Bilder selbst. Bildbeschreibungen (alt-Texte) sind über alt_text_setzen erlaubt. Für alles andere legt die KI über anpassung_beauftragen einen Wunsch an; unser Team prüft und setzt um, den Stand zeigt anpassungen_liste.

Meldungen

Datenschutz

• Der KI-Zugang läuft auf unserem Server in Deutschland.
• Protokolliert werden je Aufruf: Zeit, Schlüssel, Werkzeug, betroffenes Feld, alter und neuer Text sowie die IP-Adresse des Aufrufs. Das Protokoll sehen Sie im Reiter.
• Was Sie dem KI-Assistenten schreiben, verarbeitet dessen Anbieter (z. B. Anthropic) nach seinen eigenen Bedingungen. Wir erhalten nur die Werkzeug-Aufrufe.
• Wie unsere Server, Verbindungen und Sicherungen zusammenspielen, beschreibt das Werkzeug datenwege bzw. der Reiter „Datenwege“ im webentwickler.io CRM.

Trennen und widerrufen

Geht ein Gerät verloren oder verlässt jemand das Team: im Reiter beim Schlüssel bzw. bei der Verbindung auf „Widerrufen“. Das wirkt sofort, auch für bereits ausgegebene Anmeldungen. Ein Schlüssel oder eine Verbindung verliert seine Wirkung außerdem automatisch, wenn er abläuft oder die Person, die ihn angelegt hat, keinen Zugang mehr zu Ihrer Website hat.