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

Zinn®, notre Viking, exulte pendant qu'un assistant IA se connecte aux outils de la plateforme.

Configurez-le en trois étapes

  1. 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é.

  2. 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.

  3. 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@latest

Curseur

// .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.

ActionSon rôleÉdition
Répondre à un ticketRé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’assistantPose 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 ticketOuvre 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 discussionMet fin à une discussion ; le visiteur peut toujours demander la transcription.Édition gratuite
Ouvrir un ticketOuvre 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 ticketSupprime 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 discussionRenvoie 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 supportRenvoie 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 chatRenvoie 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 ticketRenvoie 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’assistantRenvoie 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 directAffiche 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 saitListe 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 ticketsAffiche les tickets de support, filtrés par état ou par recherche, page par page.Édition gratuite
Reconstruire l’index de recherche de l’assistantReconstruit les vecteurs de recherche pour un élément (item_id) ou pour tout (all : true) (gestionnaires uniquement).Édition gratuite
Relire le contenu dans l’assistantRelit un élément (item_id) ou tout (all : true) dans l’index de l’assistant (gestionnaires uniquement).Édition gratuite
Répondre dans un chatEnvoie 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 chatAttribue 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 discussionModifie 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 ticketModifie 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.

Le serveur MCP Zinn Digital®