Comment intégrer Mistral AI au serveur MCP de Matomo

Avant d’intégrer le serveur MCP à Mistral AI, consultez les sections sécurité ainsi que Confidentialité et conformité réglementaire.
Le MCP permet à des systèmes d’IA externes d’accéder aux données analytiques de votre instance Matomo. Vous devez vous assurer que des mécanismes d’authentification appropriés, des contrôles d’accès aux données et des mesures de protection de la confidentialité soient mises en place avant d’autoriser un outil d’IA à interroger vos données analytiques.

Avant de commencer

  1. Le serveur MCP est inclus avec Matomo Cloud. Pour Matomo On-Premise, vous devez d’abord installer et activer le plugin MCP Server.
  2. Dans les deux environnements Matomo, le MCP doit être activé manuellement dans Matomo avant utilisation. Consultez le guide de configuration du serveur MCP.
  3. Assurez-vous de disposer d’un compte Mistral AI.
  4. Générez un jeton d’authentification API dans Matomo. Conservez-le à portée de main, car vous en aurez besoin lors du processus de configuration pour authentifier le connecteur dans Mistral AI.

Ajouter le connecteur personnalisé Matomo MCP dans Mistral AI

  1. Dans Mistral AI, ouvrez Work.
  2. Développez le menu Intelligence et sélectionnez Connecteurs.

  3. Cliquez sur Ajouter un connecteur.
    Ajouter le connecteur

  4. Sélectionnez l’onglet Connecteur MCP personalisé.
    add mcp details

  5. Saisissez un nom unique dans le champ Titre du connecteur.

  6. Copiez l’URL du serveur MCP disponible dans Administration Matomo > Exporter > MCP Server. Lorsque le MCP est activé, le point de terminaison (endpoint) du MCP s’affiche.

  7. Dans Mistral AI, collez l’URL du serveur MCP dans le champ Serveur du connecteur.
    add endpoint in mistral

  8. Vous pouvez, si vous le souhaitez, ajouter une Description contenant un bref résumé de l’objectif du connecteur.

  9. Mistral AI détecte automatiquement la Méthode d’authentification du serveur.
  10. Pour la méthode Authentification par token API, utilisez les valeurs par défaut:
    Nom de l’en-tête : Authorization
    Type d’en-tête : Bearer
    11. Cliquez sur la flèche située à côté de Valeur de l’en-tête pour afficher les options.
    add api token in mistral
  11. Saisissez le jeton d’authentification API généré dans Matomo (conservez-le à portée de main, car il sera nécessaire lors du démarrage de la conversation).
    Choisissez l’option de Visibilité appropriée.
    Cliquez sur Créer.

Utiliser le connecteur Matomo MCP dans le chat Mistral AI

Une fois le connecteur Matomo MCP configuré avec succès, il apparaît dans le répertoire Mes connecteurs. L’indicateur vert Connecté confirme que le jeton et la connexion ont été vérifiés et sont prêts à être utilisés.

  1. Cliquez sur le connecteur Matomo MCP.
    select mcp in mistral

  2. Dans le champ Bearer token, saisissez le jeton d’authentification Matomo généré précédemment.
    add bearer token in mistral

  3. Cliquez sur Connecter.
    4. Cliquez sur Nouveau chat pour commencer à interroger vos données Matomo à l’aide du MCP.
  4. Vous pouvez également utiliser l’invite principale du chat. Cliquez sur l’icône +, puis sélectionnez Connecteurs > Matomo MCP.
    start mistral chat

Commencez avec ces exemples d’invites pour analyser vos données à l’aide du MCP Matomo.

Dépannage des connexions MCP dans Mistral AI

Si vous ouvrez l’URL du serveur MCP dans un navigateur et voyez un message similaire au suivant, cela signifie que le point de terminaison MCP est accessible et fonctionne correctement:

{"jsonrpc":"2.0","id":"","error":{"code":-32600,"message":"Authentication required."}}

Cette réponse indique que le serveur MCP est en ligne et attend une requête d’authentification valide.

Si vous obtenez des erreurs indiquant que la connexion a échoué, vérifiez les points suivants:

  • L’URL du serveur MCP a été copiée exactement comme elle apparaît dans les paramètres Matomo.
  • L’utilisateur Matomo associé au jeton API dispose d’un accès au site que vous souhaitez analyser.
  • Le jeton API a été généré à partir de la même instance Matomo et il s’agit d’un jeton valide et actif.
  • L’utilisateur ne dépasse aucune restriction configurée de [Maximum allowed MCP privilege level restrictions](L’utilisateur ne dépasse aucune restriction configurée de [Maximum allowed MCP privilege level restrictions].).
  • Dans les paramètres du connecteur Mistral AI, n’utilisez pas l’authentification Basic avec la méthode API Token.
  • Supprimez le connecteur, puis recréez-le.
  • Générez un nouveau jeton API et effectuez un nouvel essai.

Tester avec un utilisateur MCP dédié

Pour faciliter le dépannage et renforcer la sécurité, créez un compte utilisateur Matomo dédié à l’accès MCP. Pour faciliter le dépannage et renforcer la sécurité, créez un compte utilisateur Matomo dédié à l’accès MCP. Cet utilisateur doit disposer des autorisations nécessaires sur le site et générer un nouveau jeton pour le connecteur MCP. Cette approche permet d’isoler les problèmes liés aux autorisations et à l’authentification tout en limitant l’accès aux données analytiques.