Agenți IA (MCP)
Zinn® Chat pentru agenți AI
Site-ul tău WordPress este propriul său server MCP. Un asistent AI se conectează ca utilizator WordPress folosind o parolă de aplicație și poate face ceea ce are voie acel utilizator cu Zinn® Chat — nimic mai mult.
36 acțiuni: 21 gratuite, 15 în Pro.
Referință pentru dezvoltatori: fiecare acțiune, ruta sa REST și parametrii acesteia
Acest ghid din baza de cunoștințe, cu toate acțiunile gratuite listate
Configurați-l în trei pași
Verificați comutatorul
Aveți nevoie de WordPress 6.9 sau o versiune ulterioară și de Zinn® Chat 2.9.0 sau o versiune ulterioară. În setările modulului, „Allow AI agents (MCP)” este activat, cu excepția cazului în care l-ați dezactivat.
Creați o parolă pentru aplicație
În WordPress, deschideți Utilizatori, apoi Profil și adăugați o parolă de aplicație numită după aplicația dumneavoastră AI. Copiați-o: WordPress o afișează o singură dată.
Adăugați site-ul în aplicația dumneavoastră AI
Folosiți numele de utilizator WordPress, parola de aplicație și adresa de conectare a site-ului dvs.:
https://example.com/wp-json/zinn-chat/v1/mcp
Configurare pentru aplicații AI populare
Fiecare aplicație de mai jos comunică cu site-ul dvs. prin intermediul proxy-ului oficial WordPress, @automattic/mcp-wordpress-remote. Înlocuiți adresa, numele de utilizator și parola cu cele proprii.
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"
}
}
}
}Alte aplicații
Orice aplicație care acceptă servere MCP prin intrare și ieșire standard poate utiliza aceeași comandă și aceleași setări. Aplicațiile care se conectează doar la servere HTTP la distanță pot accesa direct adresa de conexiune folosind același nume de utilizator și aceeași parolă de aplicație. ChatGPT este excepția pentru moment: se conectează la servere MCP doar prin autentificare OAuth, așa că nu poate folosi o parolă de aplicație.
Ce poate face un agent AI
Tot ceea ce pot face ecranele proprii ale modulului. Acțiunile marcate cu Pro necesită o licență Zinn® Chat Pro.
| Acțiune | Ce face | Ediție |
|---|---|---|
| Răspundeți la un tichet | Răspunde clientului prin e-mail (text) sau adaugă o notă internă (note: true); starea modifică opțional starea tichetului. | Ediție gratuită |
| Întreabă asistentul | Pune o întrebare asistentului AI al site-ului și returnează răspunsul său împreună cu fiecare sursă găsită. | Ediție gratuită |
| Modificați mai multe tichete simultan (Pro) | Modifică starea, prioritatea sau persoana căreia îi este atribuit un număr de până la 100 de tichete (ids). Fiecare tichet trece prin aceleași verificări ca și cum ar fi modificat individual; rezultatul le listează pe fiecare în parte. | Ediția Pro |
| Transformați un chat într-un tichet | Deschide un tichet d dintr-un chat pentru a putea fi răspuns prin e-mail (necesită adresa de e-mail a vizitatorului). | Ediție gratuită |
| Închide un chat | Încheie un chat; vizitatorul poate solicita în continuare transcrierea. | Ediție gratuită |
| Deschide un tichet | Deschide un tichet în numele unui client (adresa sa de e-mail, un subiect și primul mesaj). | Ediție gratuită |
| Ștergeți un răspuns salvat (Pro) | Șterge un răspuns salvat. | Ediția Pro |
| Ștergeți un tichet | Șterge definitiv un tichet și conversația aferentă (doar pentru manageri). | Ediție gratuită |
| Redactați un articol de ajutor d dintr-un tichet (Pro) | Scrie o ciornă de articol pentru baza de cunoștințe pe baza unui tichet rezolvat; aceasta rămâne ciornă până când o persoană o publică. | Ediția Pro |
| Schițează articole de ajutor pentru întrebările fără răspuns (Pro) | Scrie ciorne de articole pentru baza de cunoștințe care răspund la întrebările alese (ids); acestea rămân în stadiul de ciornă. | Ediția Pro |
| Completați un răspuns salvat (Pro) | Returnează textul unui răspuns salvat, având substituentul completat pentru un chat sau un tichet. | Ediția Pro |
| Citește un chat | Returnează mesajele unui singur chat și detaliile vizitatorului (după: doar mesajele mai noi decât acest id). | Ediție gratuită |
| Citiți prezentarea generală a Asistenței | Returnează câte tichete există în fiecare stare și câte chaturi așteaptă o persoană (și mesajele lor necitite), precum și dacă chatul, asistentul și tichetele sunt activate. | Ediție gratuită |
| Citește setările de chat | Returnează toate setările de chat: widgetul, asistentul, persoanele și programul de lucru, tichetele și e-mailul, indexul site-ului, confidențialitatea și spamul. | Ediție gratuită |
| Citește statisticile de asistență (Pro) | Returnează numărul de chat-uri și tichete, timpii de răspuns și calificativele pentru ultimele N zile (zile). | Ediția Pro |
| Citiți un tichet | Returnază un tichet cu întreaga sa conversație, statut, prioritate și persoană atribuită. | Ediție gratuită |
| Predați un chat înapoi asistentului | Returnează un chat către asistentul AI, care răspunde vizitatorului pe baza conținutului site-ului. | Ediție gratuită |
| Listați răspunsurile salvate (Pro) | Afișează lista de răspunsuri salvate pe care agenții le pot introduce, împreună cu scurtăturile lor. | Ediția Pro |
| Listă chaturi live | Afișează listele cu chaturile în așteptare, în curs și recent închise, precizând cine se ocupă de fiecare în parte. | Ediție gratuită |
| Enumerați ce știe asistentul | Afișează conținutul din care răspunde asistentul, împreună cu starea de indexare, câte o pagină. | Ediție gratuită |
| Listați întrebările fără răspuns (Pro) | Afișează o listă cu întrebările adresate de vizitatori la care baza de cunoștințe nu a putut răspunde. | Ediția Pro |
| Listați tichetele | Listează tichetele de asistență, filtrate după stare sau o căutare, câte o pagină pe rând. | Ediție gratuită |
| Reconstruiește indexul de căutare al asistentului | Reconstruiește vectorii de căutare pentru un element (item_id) sau pentru tot (all: true) (doar pentru manageri). | Ediție gratuită |
| Re-citește conținutul în asistent | Re-citește un element (item_id) sau totul (all: true) în indexul asistentului (doar pentru manageri). | Ediție gratuită |
| Răspunde într-un chat | Trimite un mesaj vizitatorului (text) sau adaugă o notă internă pe care doar agenții o pot vedea (note: true). | Ediție gratuită |
| Salvează un răspuns salvat (Pro) | Creează sau modifică un răspuns salvat (titlu, comandă rapidă, conținut, departament; id pentru a modifica unul). | Ediția Pro |
| Scrie un articol de ajutor (Pro) | Creează un articol pentru baza de cunoștințe sau îl modifică (id): titlu, conținut, un fragment, categorii și stare (draft sau publică atunci când poți publica). | Ediția Pro |
| Căutați în baza de cunoștințe (Pro) | Găsește articole de ajutor pentru a le include într-un răspuns (q: căutarea). | Ediția Pro |
| Setați departamentul și etichetele unei conversații (Pro) | Setează departamentul și etichetele unui chat sau tichet (tip: chat sau tichet; id). | Ediția Pro |
| Marchează întrebările fără răspuns (Pro) | Marchează întrebările fără răspuns ca fiind deschise, planificate sau respinse (id-uri, status). | Ediția Pro |
| Setați-vă disponibilitatea | Marchează agentul conectat ca fiind disponibil sau absent pentru chaturi noi (absent: true sau false). | Ediție gratuită |
| Redactează un răspuns cu AI (Pro) | Elaborează o ciornă de răspuns la un chat sau la un tichet pe baza conținutului site-ului; nu se trimite nimic. | Ediția Pro |
| Rezumatul unei conversații cu AI (Pro) | Rezumă un chat sau un tichet în câteva rânduri. | Ediția Pro |
| Începeți o conversație | Atribuie un chat în așteptare agentului conectat, astfel încât vizitatorul să vorbească cu o persoană. | Ediție gratuită |
| Modificați setările pentru chat | Modifică setările pe care le trimiți (setări: cheie-valoare) și le păstrează pe celelalte. Fiecare valoare este verificată exact ca pe ecranul de setări; get-settings listează cheile. | Ediție gratuită |
| Modifică un tichet | Modifică starea, prioritatea sau persoana căreia i s-a atribuit un tichet. | Ediție gratuită |
Sigur din proiectare
Fiecare acțiune verifică aceeași permisiune WordPress ca și propriul ecran al pluginului, pentru pagina sau postarea exactă pe care o afectează. Un abonat nu se poate conecta deloc.
Parolele pentru aplicații pot fi revocate în orice moment din Utilizatori, Profil, fără a vă schimba parola normală.
Dezactivați „Permiteți agenții AI (MCP)” și acțiunile și adresa de conexiune vor dispărea de pe site.
Paginile modificate de un agent își păstrează reviziile WordPress, astfel încât orice modificare poate fi anulată.
Găzduit cu Zinn Digital®?
Dacă Zinn Digital® găzduiește site-ul, propriul nostru server MCP poate efectua aceste acțiuni în locul dumneavoastră fără o parolă de aplicație: conectați-vă aplicația de inteligență artificială la serverul MCP Zinn Digital® și utilizați wordpress_abilities_list și wordpress_ability_run.