KI-Agenten (MCP)
Zinn® Chat für KI-Agenten
Ihre WordPress-Website ist ein eigener MCP-Server. Ein KI-Assistent meldet sich als WordPress-Benutzer mit einem Anwendungspasswort an und kann das tun, was dieser Benutzer mit Zinn® Chat tun darf – nicht mehr.
36 Aktionen: 21 kostenlos, 15 in Pro.
Entwicklerreferenz: Jede Aktion, ihre REST-Route und ihre Parameter
In drei Schritten einrichten
Schalter überprüfen
Sie benötigen WordPress 6.9 oder neuer und Zinn® Chat 2.9.0 oder neuer. In den Einstellungen des Plugins ist „Allow AI agents (MCP)“ aktiviert, es sei denn, Sie haben es deaktiviert.
Anwendungspasswort erstellen
Öffnen Sie in WordPress den Menüpunkt „Benutzer“ und anschließend „Profil“ und erstellen Sie ein Anwendunspasswort für Ihre KI-App. Kopieren Sie es: WordPress zeigt es nur einmal an.
Fügen Sie die Website zu Ihrer KI-App hinzu
Verwenden Sie Ihren WordPress-Benutzernamen, das Anwendungspasswort und die Verbindungsadresse Ihrer Website:
https://example.com/wp-json/zinn-chat/v1/mcp
Konfiguration für beliebte KI-Apps
Jede der folgenden Apps kommuniziert über den offiziellen WordPress-Proxy @automattic/mcp-wordpress-remote mit Ihrer Website. Ersetzen Sie die Adresse, den Benutzernamen und das Passwort durch Ihre eigenen.
Claude Desktop
// claude_desktop_config.json
{
"mcpServers": {
"zinn-chat": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Claude Code
claude mcp add zinn-chat \
-e WP_API_URL=https://example.com/wp-json/zinn-chat/v1/mcp \
-e WP_API_USERNAME=your-username \
-e WP_API_PASSWORD=your-application-password \
-- npx -y @automattic/mcp-wordpress-remote@latestCursor
// .cursor/mcp.json
{
"mcpServers": {
"zinn-chat": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}VS Code
// .vscode/mcp.json — VS Code's key is "servers"
{
"servers": {
"zinn-chat": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Andere Apps
Jede App, die MCP-Server über Standardeingabe und -ausgabe unterstützt, kann denselben Befehl und dieselbe Konfiguration verwenden. Apps, die nur eine Verbindung zu Remote-HTTP-Servern herstellen, können die Verbindungsadresse direkt mit demselben Benutzernamen und Anwendunspasswort erreichen. ChatGPT ist vorerst die Ausnahme: Es stellt nur über eine OAuth-Anmeldung eine Verbindung zu MCP-Servern her und kann daher kein Anwendungspasswort verwenden.
Was ein KI-Agent tun kann
Alles, was die Bildschirme des Plugins selbst tun können. Als Pro gekennzeichnete Aktionen erfordern eine Zinn® Chat Pro-Lizenz.
| Aktion | Funktionsweise | Ausgabe |
|---|---|---|
| Ticket beantworten | Antwortet dem Kunden per E-Mail (Text) oder fügt eine interne Notiz hinzu (note: true); der Status ändert optional den Status des Tickets. | Kostenlose Edition |
| Assistenten fragen | Stellt dem KI-Assistenten der Website eine Frage und gibt dessen Antwort samt aller gefundenen Quellen zurück. | Kostenlose Edition |
| Mehrere Tickets auf einmal bearbeiten (Pro) | Ändert den Status, die Priorität oder den Bearbeiter von bis zu 100 Tickets (IDs). Jedes Ticket durchläuft dieselben Prüfungen wie bei einer Einzeländerung; das Ergebnis listet jedes einzelne auf. | Pro-Edition |
| Einen Chat in ein Ticket umwandeln | Eröffnet ein Ticket aus einem Chat, damit es per E-Mail beantwortet werden kann (benötigt die E-Mail-Adresse des Besuchers). | Kostenlose Edition |
| Chat schließen | Beendet einen Chat; der Besucher kann weiterhin das Protokoll anfordern. | Kostenlose Edition |
| Ticket öffnen | Öffnet ein Ticket im Namen eines Kunden (dessen E-Mail, einen Betreff und die erste Nachricht). | Kostenlose Edition |
| Gespeicherte Antwort löschen (Pro) | Löscht eine gespeicherte Antwort. | Pro-Edition |
| Ticket löschen | Löscht ein Ticket samt Verlauf unwiderruflich (nur für Manager). | Kostenlose Edition |
| Hilfeartikel aus Ticket erstellen (Pro) | Schreibt einen Entwurf für einen Wissensdatenbank-Artikel aus einem gelösten Ticket; dieser bleibt so lange ein Entwurf, bis er von einer Person veröffentlicht wird. | Pro-Edition |
| Hilfsartikel für unbeantwortete Fragen entwerfen (Pro) | Schreibt Entwürfe von Wissensdatenbank-Artikeln, die die ausgewählten Fragen (IDs) beantworten; diese bleiben Entwürfe. | Pro-Edition |
| Gespeicherte Antwort einfügen (Pro) | Gibt den Text einer gespeicherten Antwort mit ausgefüllten Platzhaltern für einen Chat oder ein Ticket zurück. | Pro-Edition |
| Chat lesen | Gibt die Nachrichten und Besucherdetails eines Chats zurück (after: nur Nachrichten, die neuer als diese ID sind). | Kostenlose Edition |
| Support-Übersicht lesen | Gibt zurück, wie viele Tickets sich in den einzelnen Status befinden, wie viele Chats auf eine Person warten (sowie deren ungelesene Nachrichten) und ob der Chat, der Assistent und die Tickets aktiviert sind. | Kostenlose Edition |
| Chat-Einstellungen lesen | Gibt alle Chat-Einstellungen zurück: das Widget, den Assistenten, Personen und Öffnungszeiten, Tickets und E-Mail, den Seitenindex, Datenschutz und Spam. | Kostenlose Edition |
| Support-Statistiken lesen (Pro) | Gibt Chat- und Ticketnummern, Reaktionszeiten und Bewertungen für die letzten N Tage (days) zurück. | Pro-Edition |
| Ticket lesen | Gibt ein Ticket samt gesamtem Verlauf, Status, Priorität und zugewiesener Person zurück. | Kostenlose Edition |
| Chat an den Assistenten zurückgeben | Gibt einen Chat an den KI-Assistenten zurück, der den Besucher anhand der Website-Inhalte antwortet. | Kostenlose Edition |
| Gespeicherte Antworten auflisten (Pro) | Listet die gespeicherten Antworten auf, die Agenten einfügen können, einschließlich ihrer Kürzel. | Pro-Edition |
| Live-Chats auflisten | Listet wartende, laufende und kürzlich geschlossene Chats auf und zeigt an, wer sie bearbeitet. | Kostenlose Edition |
| Auflisten, was der Assistent weiß | Listet den Inhalt auf, aus dem der Assistent antwortet, einschließlich des Indexstatus, jeweils eine Seite. | Kostenlose Edition |
| Unbeantwortete Fragen anzeigen (Pro) | Listet die Fragen auf, die Besucher gestellt haben und auf die die Wissensdatenbank keine Antwort geben konnte. | Pro-Edition |
| Tickets auflisten | Listet Support-Tickets seitenweise auf, gefiltert nach Status oder einer Suche. | Kostenlose Edition |
| Suchindex des Assistenten neu erstellen | Erstellt die Suchvektoren für ein einzelnes Element (item_id) oder alles (all: true) neu (nur für Manager). | Kostenlose Edition |
| Inhalt erneut in den Assistenten einlesen | Liest ein einzelnes Element (item_id) oder alles (all: true) erneut in den Index des Assistenten ein (nur für Manager). | Kostenlose Edition |
| Im Chat antworten | Sendet eine Nachricht an den Besucher (text) oder fügt eine interne Notiz hinzu, die nur Agenten sehen (note: true). | Kostenlose Edition |
| Gespeicherte Antwort speichern (Pro) | Erstellt oder ändert eine gespeicherte Antwort (Titel, Kürzel, Text, Abteilung; ID zum Ändern). | Pro-Edition |
| Hilfeartikel schreiben (Pro) | Erstellt einen Wissensdatenbank-Artikel oder ändert einen (id): Titel, Inhalt, Auszug, Kategorien und Status (Entwurf oder Veröffentlichung, wenn Sie veröffentlichen dürfen). | Pro-Edition |
| Knowledge Base durchsuchen (Pro) | Findet Hilfe-Artikel zum Verlinken in einer Antwort (q: die Suche). | Pro-Edition |
| Weisen Sie der Abteilung und den Tags einer Unterhaltung einen Wert zu (Pro) | Legt die Abteilung und die Tags eines Chats oder Tickets fest (Art: chat oder ticket; ID). | Pro-Edition |
| Unbeantwortete Fragen markieren (Pro) | Markiert unbeantwortete Fragen als offen, geplant oder verworfen (IDs, Status). | Pro-Edition |
| Verfügbarkeit festlegen | Markiert den angemeldeten Agenten für neue Chats als verfügbar oder abwesend (abwesend: true oder false). | Kostenlose Edition |
| Antwort mit KI entwerfen (Pro) | Entwirft eine Antwort auf einen Chat oder ein Ticket aus dem Seiteninhalt; es wird nichts gesendet. | Pro-Edition |
| Gespräch mit KI (Pro) zusammenfassen | Fasst einen Chat oder ein Ticket in wenigen Zeilen zusammen. | Pro-Edition |
| Chat starten | Weist dem angemeldeten Agenten einen wartenden Chat zu, sodass der Besucher mit einer Person spricht. | Kostenlose Edition |
| Chat-Einstellungen ändern | Ändert die von Ihnen gesendeten Einstellungen (Einstellungen: Schlüssel zu Wert) und behält den Rest bei. Jeder Wert wird genau wie auf dem Einstellungsbildschirm überprüft; get-settings listet die Schlüssel auf. | Kostenlose Edition |
| Ticket bearbeiten | Ändert den Status, die Priorität oder den Bearbeiter eines Tickets. | Kostenlose Edition |
Sicher durch Design
Jede Aktion überprüft dieselbe WordPress-Berechtigung wie der eigene Bildschirm des Plugins für die genaue Seite oder den genauen Beitrag, die oder den sie betrifft. Ein Abonnent kann überhaupt keine Verbindung herstellen.
Anwendungspasswörter können jederzeit unter „Benutzer“ > „Profil“ widerrufen werden, ohne Ihr normales Passwort zu ändern.
Schalten Sie „KI-Agenten (MCP) erlauben“ aus, und die Aktionen sowie die Verbindungsadresse verschwinden von der Website.
Seiten, die von einem Agenten geändert werden, behalten ihre WordPress-Revisionen, sodass jede Änderung rückgängig gemacht werden kann.
Bei Zinn Digital® gehostet?
Wenn Zinn Digital® die Website hostet, kann unser eigener MCP-Server diese Aktionen ohne Anwendunspasswort für Sie ausführen: Verbinden Sie Ihre KI-App mit dem Zinn Digital® MCP-Server und verwenden Sie wordpress_abilities_list und wordpress_ability_run.