Serveur MCP de Personyze : connecter Claude, ChatGPT et d’autres assistants

Cliquez n’importe où pour fermer

Connectez Claude, ChatGPT ou tout autre assistant IA à votre compte Personyze et travaillez avec lui en simple conversation — demandez comment se portent vos campagnes, trouvez où vous perdez du trafic, créez une campagne, mettez une action en pause, obtenez une réponse pratique.

De quoi s’agit-il

MCP (Model Context Protocol) est le standard ouvert qu’utilisent les assistants IA pour travailler avec des services extérieurs. Personyze fait tourner un serveur MCP : un assistant peut donc accéder directement à votre compte, sans code, sans copier de données d’un onglet à l’autre, sans fichiers d’export.

Il repose sur la même API externe que API complète, avec les mêmes autorisations.

URL du serveur : https://personyze.com/mcp/

Connecter un assistant

La plupart des assistants ne demandent que l’URL, puis vous guident pour la connexion :

Dans Personyze, ouvrez Intégrations → Assistants IA (MCP) et copiez l’URL du serveur.
Dans l’assistant, ajoutez un connecteur personnalisé et indiquez-la :
• **Claude** — Settings → Connectors → Add custom connector
• **ChatGPT** — Settings → Connectors
Approuvez la connexion sur l’écran Personyze qui s’ouvre. Rien à copier-coller : l’assistant reçoit ses propres identifiants.

Tiroir de l’intégration Assistants IA (MCP) — La carte Intégrations : indiquez l’URL du serveur à votre assistant ; les clés API ne servent qu’aux outils qui ne peuvent pas ouvrir de navigateur. Cliquez pour agrandir.

Les outils qui ne peuvent pas ouvrir de navigateur — un script ou un plugin d’IDE — peuvent à la place envoyer une clé API Personyze dans un en-tête :

Authorization: Bearer YOUR_API_KEY

Les clés se trouvent sur la même carte Intégrations.

Ce que vous pouvez lui demander

Tout ce qui suit fonctionne dès aujourd’hui. La formulation vous appartient — ce sont des exemples du type de question, pas des commandes à la syntaxe figée.

Comprendre les performances de vos campagnes

« Quelles campagnes ont le mieux fonctionné sur les 30 derniers jours ? »
« Quelle action a obtenu le plus de clics le mois dernier ? »
« Comment se porte la bannière de la page de tarifs par rapport à avril ? »
« Quelles campagnes n’ont eu aucune activité sur les 30 derniers jours ? »
« La popup du checkout a-t-elle vraiment été affichée, ou seulement exécutée ? »

Il lit le résumé quotidien des performances par action : impressions, diffusions, clics, fermetures, échecs, vos propres objectifs configurés et les totaux de type revenus. Il refuse de citer un taux de clics sur un échantillon trop petit pour signifier quoi que ce soit, et le dit au lieu de le citer quand même.

Trouver où vous perdez du trafic

« Quelles pages d’atterrissage perdent le plus de sessions ? »
« Quelles sont mes pages les plus visitées cette semaine ? »
« D’où vient mon trafic ? »
« Quelles sources de trafic convertissent le moins bien ? »
« Quels appareils et navigateurs utilisent mes visiteurs ? »
« De quels pays et de quelles villes viennent mes visiteurs ? »
« Quels termes de recherche organique amènent du monde ? »

Le trafic de tout le site sur n’importe quelle période, ventilé par page, page d’atterrissage, référent, terme de recherche, appareil, ville ou pays — avec les sessions, visites, utilisateurs, rebonds, objectifs, valeur des objectifs, temps passé sur la page, ainsi que les impressions et clics de personnalisation sur ces pages. Les taux (rebond, objectif, clics, nouveaux utilisateurs, mobile) sont calculés après regroupement, et les lignes à faible trafic sont exclues lors d’un classement par taux : un taux de rebond de 100 % sur trois sessions ne passe donc pas devant un vrai problème.

Examiner les produits

« Quels sont mes produits les plus vendus ? »
« Quels produits sont beaucoup consultés mais rarement achetés ? »
« Qu’est-ce qui est recommandé le plus souvent ? »

Voir ce qui tourne, et pourquoi

« Liste mes campagnes. »
« Quelles campagnes tournent sur ma page d’accueil ? »
« Pourquoi la bannière de bienvenue ne s’affiche-t-elle pas ? »
« Quel est le ciblage de la campagne 1834 ? »
« Quelles campagnes ciblent les visiteurs mobiles ? »
« Montre-moi le HTML de la bannière de cette campagne. »
« Lesquelles de mes actions sont en ligne, et lesquelles sont encore en test ? »

Le ciblage revient sous forme de règles lisibles — « Include on current page: Contains /pricing and not Full URL contains login » — et non de configuration brute.

Créer et modifier des campagnes

« Crée une campagne ciblant les visiteurs mobiles récurrents. »
« Crée-moi une campagne pour les visiteurs de la page de tarifs qui n’ont pas acheté. »
« Renomme-la Summer Promo et change le ciblage pour les visiteurs venant de la recherche payante. »
« Active ce brouillon pour que je puisse le tester. »
« Mets en pause la popup de la page de checkout. »
« Relance la bannière d’intention de sortie. »

Deux choses à savoir sur son comportement :

Les nouvelles campagnes sont créées en mode staging. Elles ne s’affichent qu’aux visiteurs arrivant depuis une adresse IP de staging. Le trafic réel continue de voir ce qui est en ligne actuellement, et c’est vous qui publiez dans le panneau. L’assistant vous donne un lien direct vers la campagne pour que vous puissiez l’ouvrir. Décrivez le ciblage avec des mots simples : il est compilé en véritables règles — et l’assistant vous relit le résultat compilé, car une règle qui dit quelque chose de légèrement différent de ce que vous avez demandé paraît identique vue de l’extérieur.

Mettre en pause ou relancer une action a un effet immédiat. Cela s’applique aux vrais visiteurs dès que le JavaScript de votre compte est reconstruit. L’assistant demande confirmation avant de le faire, en termes concrets — il nomme l’action, la campagne dans laquelle elle se trouve, et ce que vos visiteurs cessent ou commencent de voir. C’est entièrement réversible. Une action à la fois : « mets la campagne en pause » n’est pas pris comme une autorisation de tout désactiver sans vous le dire.

Travailler avec les audiences et les profils visiteurs

« Combien d’audiences ai-je, et quelle est la taille de chacune ? »
« Crée une audience appelée Enterprise Prospects. »
« Ajoute-y toutes les personnes de cette liste. »
« Ajoute john@example.com à l’audience Enterprise Prospects. »
« Retire le visiteur 48213 de cette audience. »
« Trouve le profil correspondant à l’identifiant CRM crm-123. »
« Quels visiteurs sont venus plus de cinq fois ? »
« Mets à jour le profil d’Ann avec son nouveau numéro de téléphone. »

Les visiteurs peuvent être identifiés par l’identifiant numérique de profil Personyze, par votre propre identifiant CRM ou de site, ou par e-mail.

Gérer les emplacements

« Quels emplacements ai-je ? »
« Crée un emplacement pour l’élément avec l’id hero-banner. »

Demander comment fonctionne le produit

« Comment importer mon catalogue de produits ? »
« Comment configurer le suivi des conversions ? »
« Comment installer Personyze sur Shopify ? »
« Quelle est la différence entre une campagne et une action ? »
« Comment fonctionnent les notifications push web ? »

L’assistant cherche dans cette base de connaissances et répond à partir de ce qu’il trouve, en indiquant les articles utilisés pour que vous puissiez les vérifier. Si la documentation ne couvre pas votre question, il le dit et propose d’ouvrir un ticket de support plutôt que de deviner.

Obtenir l’aide d’un humain

« Ouvre un ticket de support — les recommandations ne s’affichent pas sur mobile. »

Il demande d’abord, rédige ce que vous faisiez et ce qu’il a déjà vérifié pour que le support ne parte pas de zéro, et vous donne le numéro du ticket. Les réponses arrivent dans le panneau, sous Tickets de support.

Tout le reste

Pour les demandes que les outils dédiés ne couvrent pas, l’assistant peut appeler directement l’API REST de Personyze — les mêmes objets que ceux accessibles à tout client de l’API.

Liste complète des outils

Outil	Ce qu’il fait
`list_campaigns`	Liste les campagnes du compte
`get_campaign_targeting`	Les règles qui décident à qui une campagne est affichée
`create_campaign_draft`	Crée une campagne en mode staging
`update_campaign_draft`	Renomme, recible ou active/désactive une campagne en staging
`list_actions`	Liste les actions de personnalisation
`get_action_content`	Une action avec son HTML modifiable et ses règles d’affichage
`set_action_active`	Met en pause ou relance une action en ligne
`list_placeholders`	Les emplacements nommés de la page dans lesquels les actions s’affichent
`create_placeholder`	En crée un
`get_campaign_performance`	Performances quotidiennes par action sur une période
`get_traffic_analytics`	Trafic de tout le site par page, source, appareil, zone géographique
`get_product_stats`	Vues, recommandations, achats par produit
`list_audiences`	Liste les audiences (segments de visiteurs)
`create_audience`	En crée une
`delete_audience`	En supprime une (les profils visiteurs ne sont pas supprimés)
`list_audience_members`	Qui fait partie d’une audience
`add_audience_member`	Ajoute un visiteur à une audience
`remove_audience_member`	En retire un
`get_visitors`	Recherche dans les profils visiteurs
`save_visitor`	Crée ou met à jour un profil visiteur
`search_docs`	Recherche dans cette base de connaissances
`open_support_ticket`	Ouvre un ticket auprès de l’équipe support
`personyze_api`	N’importe quel appel à l’API REST de Personyze, pour tout le reste

L’authentification en détail

Pour les développeurs qui créent un client plutôt que d’utiliser un assistant tout prêt :

OAuth 2.1, code d’autorisation avec PKCE (S256). Clients publics — pas de secret client.
Enregistrement dynamique des clients (RFC 7591) au registration_endpointannoncé, pour qu’un client puisse s’enregistrer lui-même.
Découverte selon la RFC 9728 (ressource protégée) et la RFC 8414 (serveur d’autorisation), servie à la racine de l’hôte : – https://personyze.com/.well-known/oauth-protected-resource – https://personyze.com/.well-known/oauth-authorization-server
Portée : personyze:full
Une requête non authentifiée vers /mcp/ répond 401 avec un en-tête WWW-Authenticate contenant resource_metadata, qui est le point d’entrée de la découverte.

Autorisations et révocation de l’accès

Chaque assistant connecté s’appuie sur une clé API appartenant à votre compte et agit avec les autorisations de ce compte — il ne peut voir et modifier que ce que ce compte peut voir et modifier.

Pour déconnecter un assistant, supprimez sa clé sous Intégrations → Assistants IA (MCP) (ou API complète — ils partagent le même jeu de clés). La révocation est immédiate.

Dépannage

L’assistant dit qu’il ne peut pas joindre le serveur. Vérifiez que vous avez saisi l’URL avec la barre oblique finale : https://personyze.com/mcp/.

L’écran de connexion n’apparaît jamais. Votre assistant bloque peut-être les connecteurs personnalisés avec votre formule — Claude comme ChatGPT les réservent à certains niveaux.

Un outil ne renvoie aucune donnée. Vérifiez que vous avez approuvé la connexion pour le bon compte Personyze ; le sélecteur de compte du panneau et la connexion de l’assistant sont indépendants.

Il indique qu’une campagne ne peut pas être modifiée. Seules les campagnes en mode staging peuvent être renommées ou reciblées par un assistant. Une campagne en ligne se modifie dans le panneau.

Installer sur Claude

Personyze figure dans l’annuaire des connecteurs de Claude — sur Claude, il s’installe en un clic au lieu de saisir l’URL du serveur : Ajouter Personyze à Claude.