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
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"
}
}
}
}Autres applications
N'importe quelle 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. ChatGPT est l'exception pour l'instant : elle se connecte aux serveurs MCP uniquement par connexion OAuth, elle ne peut donc pas utiliser de 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 | Fonctionnement | Édition |
|---|---|---|
| Répondre à un ticket | Répond au client par e-mail (texte) ou ajoute une note interne (note: true) ; le statut modifie éventuellement le statut du ticket. | Édition gratuite |
| Interroger l'assistant | Pose une question à l'assistant IA du site et renvoie sa réponse avec toutes les sources qu'il a trouvées. | Édition gratuite |
| Modifier plusieurs tickets à la fois (Pro) | Modifie le statut, la priorité ou le responsable de 100 tickets (identifiants) au maximum. Chaque ticket est soumis aux mêmes vérifications que s'il était modifié individuellement ; le résultat liste chacun d'eux. | Édition Pro |
| Transformer un chat en ticket | Ouvre un ticket à partir d'un chat pour qu'il puisse être répondu par e-mail (nécessite 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 (réservé aux gestionnaires). | Édition gratuite |
| Rédiger un article d'aide à partir d'un ticket (Pro) | Rédige un article de brouillon pour la base de connaissances à partir d'un ticket résolu ; il reste un brouillon jusqu'à ce qu'une personne le publie. | Édition Pro |
| Rédiger des articles d'aide pour les questions sans réponse (Pro) | Rédige des brouillons d'articles de la base de connaissances répondant aux questions choisies (ids) ; ils restent au statut 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 conversation | Renvoie les messages d'une discussion et les détails du visiteur (after : uniquement les messages plus récents que cet ID). | Édition gratuite |
| Consulter l'aperçu du support | Renvoie le nombre de tickets dans chaque statut, le nombre de chats en attente d'un agent (ainsi que leurs messages non lus), et indique si le chat, l'assistant et les tickets sont activés. | Édition gratuite |
| Lire les paramètres du chat | Renvoie l'ensemble des paramètres du chat : le widget, l'assistant, les personnes et les horaires d'ouverture, les tickets et l'e-mail, l'index du site, la confidentialité et le spam. | Édition gratuite |
| Consulter les statistiques d'assistance (Pro) | Renvoie les numéros de chat et de ticket, les temps de réponse et les notes pour les N derniers jours (days). | Édition Pro |
| Lire un ticket | Renvoie un ticket avec l'intégralité de sa conversation, son statut, sa priorité et son assigné. | Édition gratuite |
| Renvoyer une conversation à l'assistant | Retourne un chat à l'assistant IA, qui répond au visiteur à partir du contenu du site. | Édition gratuite |
| Afficher les réponses enregistrées (Pro) | Répertorie les réponses enregistrées que les agents peuvent insérer, avec leurs raccourcis. | Édition Pro |
| Afficher les chats en direct | Répertorie les chats en attente, en cours et récemment fermés, avec le nom de la personne qui gère chacun d'eux. | Édition gratuite |
| Lister ce que l'assistant sait | Liste le contenu à partir duquel l'assistant répond, avec son statut d'indexation, page par page. | Édition gratuite |
| Lister les questions sans réponse (Pro) | Affiche la liste des questions posées par les visiteurs auxquelles la base de connaissances n'a pas pu répondre. | Édition Pro |
| Liste des tickets | Répertorie les tickets de support, filtrés par statut ou par une 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 l'ensemble (all: true) (réservé aux gestionnaires). | Édition gratuite |
| Relire le contenu dans l'assistant | Relit un élément (item_id) ou l'ensemble (all: true) dans l'index de l'assistant (réservé aux gestionnaires). | É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, département ; 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 statut (brouillon, ou publier si vous pouvez publier). | Édition Pro |
| Rechercher dans la base de connaissances (Pro) | Trouve 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 département et les étiquettes d'un chat ou d'un ticket (type : chat 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 (identifiants, statut). | Édition Pro |
| Définissez vos disponibilités | Indique si l'agent connecté est disponible ou absent pour de nouvelles discussions (absent : true ou false). | Édition gratuite |
| Rédiger une réponse avec l'IA (Pro) | Rédige une réponse à un chat ou un ticket à partir du contenu du site ; rien n'est envoyé. | Édition Pro |
| Résumer une conversation avec l'IA (Pro) | Résume un chat ou un ticket en quelques lignes. | Édition Pro |
| Démarrer une discussion | Associe un chat en attente à l'agent connecté, afin que le visiteur parle à une personne. | Édition gratuite |
| Modifier les paramètres du chat | Modifie les paramètres que vous envoyez (paramètres : clé vers valeur) et conserve le reste. Chaque valeur est vérifiée exactement comme sur l'écran des paramètres ; get-settings liste les clés. | Édition gratuite |
| Modifier un ticket | Modifie le statut, 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.