Agents IA (MCP)
Zinn® Chat pour les agents IA
Votre site WordPress est son propre serveur MCP. Un assistant IA se connecte en tant qu’utilisateur WordPress avec un mot de passe d’application et peut faire ce que cet utilisateur est autorisé à faire avec Zinn® Chat — rien de plus.
36 actions : 21 gratuites, 15 dans Pro.
Référence pour les développeurs : chaque action, sa route REST et ses paramètres
Le même guide dans notre base de connaissances, avec chaque action gratuite répertoriée
Configurez-le en trois étapes
Vérifier le commutateur
Vous avez besoin de WordPress 6.9 ou version ultérieure et de Zinn® Chat 2.9.0 ou version ultérieure. Dans les paramètres du plugin, « Allow AI agents (MCP) » est activé sauf si vous l’avez désactivé.
Créer un mot de passe d’application
Sous WordPress, ouvrez Utilisateurs, puis Profil, et ajoutez un mot de passe d’application portant le nom de votre application IA. Copiez-le : WordPress ne l’affiche qu’une seule fois.
Ajoutez le site à votre application d’IA
Utilisez votre nom d’utilisateur WordPress, le mot de passe d’application et l’adresse de connexion de votre site :
https://example.com/wp-json/zinn-chat/v1/mcp
Configuration pour les applications d’IA populaires
Chaque application ci-dessous communique avec votre site via le proxy officiel WordPress, @automattic/mcp-wordpress-remote. Remplacez l’adresse, le nom d’utilisateur et le mot de passe par les vôtres.
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@latestCurseur
// .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"
}
}
}
}Claude et ChatGPT (se connecter)
Ajoutez l'adresse de connexion en tant que connecteur personnalisé dans Claude, ou en tant que serveur MCP personnalisé dans ChatGPT. Ils ouvrent votre site afin que vous puissiez les approuver en tant qu'utilisateur WordPress, sans avoir à copier de mot de passe d'application. Votre site a besoin de permaliens personnalisés.
Autres applications
Toute application prenant en charge les serveurs MCP via l’entrée et la sortie standard peut utiliser la même commande et les mêmes paramètres. Les applications qui se connectent uniquement à des serveurs HTTP distants peuvent accéder directement à l’adresse de connexion avec le même nom d’utilisateur et le même mot de passe d’application.
Ce qu’un agent IA peut faire
Tout ce que les écrans du module externe peuvent faire. Les actions marquées Pro nécessitent une licence Zinn® Chat Pro.
| Action | Son rôle | Édition |
|---|---|---|
| Répondre à un ticket | Répond au client par e-mail (text) ou ajoute une note interne (note : true) ; status modifie éventuellement l’état du ticket. | Édition gratuite |
| Demandez à l’assistant | Pose une question à l’assistant IA du site et renvoie sa réponse accompagnée de chaque source trouvée. | Édition gratuite |
| Modifier plusieurs tickets à la fois (Pro) | Modifie l’état, la priorité ou le responsable de 100 tickets (ids) maximum. Chaque ticket subit les mêmes vérifications qu’en cas de modification individuelle ; le résultat liste chacun d’entre eux. | Édition Pro |
| Convertir une discussion en ticket | Ouvre un ticket à partir d’une discussion afin qu’il soit possible d’y répondre par e-mail (requiert l’adresse e-mail du visiteur). | Édition gratuite |
| Fermer une discussion | Met fin à une discussion ; le visiteur peut toujours demander la transcription. | Édition gratuite |
| Ouvrir un ticket | Ouvre un ticket au nom d’un client (son e-mail, un objet et le premier message). | Édition gratuite |
| Supprimer une réponse enregistrée (Pro) | Supprime une réponse enregistrée. | Édition Pro |
| Supprimer un ticket | Supprime définitivement un ticket et sa conversation (gestionnaires uniquement). | Édition gratuite |
| Rédiger un brouillon d’article d’aide à partir d’un ticket (Pro) | Rédige un brouillon d’article de base de connaissances à partir d’un ticket résolu ; il reste à l’état de brouillon jusqu’à ce qu’une personne le publie. | Édition Pro |
| Rédiger des ébauches d’articles d’aide pour les questions sans réponse (Pro) | Rédige des brouillons d’articles de base de connaissances répondant aux questions sélectionnées (identifiants) ; ils restent à l’état de brouillon. | Édition Pro |
| Insérer une réponse enregistrée (Pro) | Renvoie le texte d’une réponse enregistrée avec ses espaces réservés remplis pour un chat ou un ticket. | Édition Pro |
| Lire une discussion | Renvoie les messages d’un chat et les détails du visiteur (after : uniquement les messages plus récents que cet identifiant). | Édition gratuite |
| Consultez la vue d’ensemble du support | Renvoie le nombre de tickets dans chaque statut, le nombre de discussions en attente d’un agent (ainsi que leurs messages non lus), et indique si la discussion, l’assistant et les tickets sont activés. | Édition gratuite |
| Lire les réglages du chat | Renvoie tous les paramètres de discussion : le widget, l’assistant, les personnes et les heures d’ouverture, les tickets et les e-mails, l’index du site, la confidentialité et les indésirables. | Édition gratuite |
| Consulter les statistiques d’assistance (Pro) | Renvoie le nombre de discussions et de tickets, les temps de réponse et les évaluations pour les N derniers jours (jours). | Édition Pro |
| Lire un ticket | Renvoie un ticket avec l’intégralité de sa conversation, son état, sa priorité et la personne assignée. | Édition gratuite |
| Transférer à nouveau la discussion à l’assistant | Renvoie une discussion à l’assistant IA, qui répond au visiteur à partir du contenu du site. | Édition gratuite |
| Lister les réponses enregistrées (Pro) | Affiche les réponses enregistrées que les agents peuvent insérer, avec leurs raccourcis. | Édition Pro |
| Lister les discussions en direct | Affiche la liste des discussions en attente, en cours et récemment fermées, ainsi que la personne qui gère chacune d’elles. | Édition gratuite |
| Lister ce que l’assistant sait | Liste le contenu à partir duquel l’assistant répond, avec son état d’indexation, page par page. | Édition gratuite |
| Lister les questions sans réponse (Pro) | Affiche les questions posées par les visiteurs auxquelles la base de connaissances n’a pas pu répondre. | Édition Pro |
| Lister les tickets | Affiche les tickets de support, filtrés par état ou par recherche, page par page. | Édition gratuite |
| Reconstruire l’index de recherche de l’assistant | Reconstruit les vecteurs de recherche pour un élément (item_id) ou pour tout (all : true) (gestionnaires uniquement). | Édition gratuite |
| Relire le contenu dans l’assistant | Relit un élément (item_id) ou tout (all : true) dans l’index de l’assistant (gestionnaires uniquement). | Édition gratuite |
| Répondre dans un chat | Envoie un message au visiteur (text) ou ajoute une note interne visible uniquement par les agents (note : true). | Édition gratuite |
| Enregistrer une réponse enregistrée (Pro) | Crée ou modifie une réponse enregistrée (titre, raccourci, corps, service ; id pour en modifier une). | Édition Pro |
| Rédiger un article d’aide (Pro) | Crée un article de base de connaissances ou en modifie un (id) : titre, contenu, extrait, catégories et état (brouillon, ou publier lorsque vous pouvez publier). | Édition Pro |
| Rechercher dans la base de connaissances (Pro) | Recherche des articles d’aide à lier dans une réponse (q : la recherche). | Édition Pro |
| Définir le service et les étiquettes d’une conversation (Pro) | Définit le service et les étiquettes d’une discussion ou d’un ticket (kind : discussion ou ticket ; id). | Édition Pro |
| Marquer les questions sans réponse (Pro) | Marque les questions sans réponse comme ouvertes, planifiées ou rejetées (ids, status). | Édition Pro |
| Définissez votre disponibilité | Marque l’agent connecté comme disponible ou absent pour les nouvelles discussions (away : true ou false). | Édition gratuite |
| Rédiger un brouillon de réponse avec l’IA (Pro) | Rédige un brouillon de réponse à une discussion ou à un ticket à partir du contenu du site ; rien n’est envoyé. | Édition Pro |
| Résumer une conversation avec l’IA (Pro) | Résume une discussion ou un ticket en quelques lignes. | Édition Pro |
| Prendre un chat | Attribue une discussion en attente à l’agent connecté, afin que le visiteur puisse échanger avec une personne réelle. | Édition gratuite |
| Modifier les paramètres de discussion | Modifie les réglages que vous envoyez (réglages : clé vers valeur) et conserve le reste. Chaque valeur est vérifiée exactement comme sur l’écran des réglages ; get-settings liste les clés. | Édition gratuite |
| Modifier un ticket | Modifie l’état, la priorité ou le responsable d’un ticket. | Édition gratuite |
Conçu pour la sécurité
Chaque action vérifie la même autorisation WordPress que l’écran propre du plugin, pour la page ou l’article exact qu’elle modifie. Un abonné ne peut pas se connecter du tout.
Les mots de passe d’application peuvent être révoqués à tout moment sous Utilisateurs, Profil, sans modifier votre mot de passe habituel.
Désactivez « Autoriser les agents IA (MCP) » et les actions ainsi que l’adresse de connexion disparaîtront du site.
Les pages modifiées par un agent conservent leurs révisions WordPress, de sorte que toute modification peut être annulée.
Hébergé chez Zinn Digital® ?
Si Zinn Digital® héberge le site, notre propre serveur MCP peut exécuter ces actions pour vous sans mot de passe d’application : connectez votre application d’IA au serveur MCP de Zinn Digital® et utilisez wordpress_abilities_list et wordpress_ability_run.