Articles sur : Intégrations

Contrôler PlayAbility avec un assistant IA par MCP

Le serveur MCP de PlayAbility fournit à un assistant IA compatible un ensemble local d’outils pour interagir avec PlayAbility. Selon la demande, il peut examiner et changer de profil, lire des assignations, importer des assignations, naviguer dans l’application, lire ou modifier les réglages pris en charge, envoyer des commandes, gérer les fenêtres et prendre des captures d’écran.


Avant de commencer


  • Installez Node.js 18 ou une version ultérieure et vérifiez que la commande node est disponible.
  • Utilisez un client IA qui prend en charge les serveurs MCP locaux lancés par entrée et sortie standard.
  • Laissez PlayAbility ouvert sur le même ordinateur que le client IA.
  • Connectez uniquement un client IA de confiance. Les outils MCP peuvent envoyer des entrées clavier, souris et manette.


Le serveur MCP de PlayAbility se connecte localement à l’application de bureau par ws://127.0.0.1:13123.


Activer MCP dans PlayAbility


  1. Ouvrez Connecteurs.
  2. Sélectionnez WebSocket & MCP.
  3. Activez Activer le Serveur MCP.
  4. Attendez que la section Configuration MCP apparaisse.


L’activation de MCP active également le serveur WebSocket et Autoriser les entrées WebSocket. Elle laisse Autoriser les sorties WebSocket désactivé.


Sécuriser la connexion


  1. Dans la section Paramètres WebSocket de la même page, laissez Exiger une clé d’authentification activé.
  2. Vérifiez qu’une Clé d’authentification est présente.
  3. Si nécessaire, sélectionnez Générer une nouvelle clé.


Lorsque l’authentification est activée, la configuration générée par PlayAbility inclut la même clé sous le nom PLAYABILITY_WS_KEY.


Ajouter la configuration générée au client IA


  1. Dans PlayAbility, repérez Configuration MCP.
  2. Vérifiez si elle porte le libellé Production ou Développement.
  3. Sélectionnez Copier.
  4. Ouvrez la configuration des serveurs MCP dans votre client IA.
  5. Fusionnez l’entrée playability copiée dans l’objet mcpServers de votre client.
  6. Enregistrez la configuration.
  7. Redémarrez ou rechargez complètement le client IA afin qu’il lance le nouveau serveur.


Utilisez la configuration générée par PlayAbility plutôt que de saisir vous-même le chemin du serveur. Elle contient le bon chemin d’installation et, lorsque cela est requis, la clé d’authentification.


Vérifier la connexion MCP


  1. Ouvrez la page MCP ou des intégrations du client IA.
  2. Vérifiez qu’un serveur nommé playability apparaît comme connecté.
  3. Commencez par une demande en lecture seule, par exemple :
    • « Liste mes profils PlayAbility. »
    • « Affiche la page PlayAbility actuelle. »
    • « Lis les assignations de mon profil actif. »
  5. Vérifiez que le profil ou la page renvoyé correspond à l’application de bureau.


Demandez à l’assistant d’envoyer une entrée ou de modifier un réglage uniquement après le bon fonctionnement des outils en lecture seule.


Ce qu’un assistant peut faire


Le serveur MCP fourni inclut des outils permettant de :


  • Lister les profils et lire les assignations du profil actuel ou d’un profil nommé.
  • Changer de profil et importer ou ajouter des assignations.
  • Accéder aux pages de PlayAbility et indiquer la page actuelle.
  • Lire les réglages exposés et modifier le sous-ensemble accessible à distance.
  • Envoyer des entrées de manette, clavier, souris, curseur ou des lots d’entrées.
  • Lister les écrans et les fenêtres, placer une fenêtre au premier plan, la déplacer ou la redimensionner.
  • Prendre des captures d’écran.
  • Lire des informations de base sur la connexion à PlayAbility.


Certains réglages sensibles pour la sécurité ne peuvent pas être modifiés par MCP. La sortie série et HID, l’authentification WebSocket, l’analyse d’utilisation et la coupure des entrées Windows doivent être modifiées dans l’interface de PlayAbility.


Dépannage


Le serveur MCP n’apparaît pas dans le client IA


  • Vérifiez que le client prend en charge les serveurs MCP locaux.
  • Vérifiez que node --version indique Node.js 18 ou une version ultérieure.
  • Copiez de nouveau la configuration depuis PlayAbility et vérifiez qu’elle a été ajoutée au bon fichier de configuration du client.
  • Redémarrez complètement le client IA.
  • Consultez le journal MCP du client pour repérer une erreur JSON ou un fichier manquant.


Le serveur apparaît, mais ne peut pas se connecter à PlayAbility


  • Laissez PlayAbility ouvert.
  • Vérifiez que Activer le Serveur MCP est toujours activé.
  • Vérifiez que le port 13123 n’est pas utilisé par une autre application.
  • Si vous avez généré une nouvelle clé d’authentification, copiez la configuration MCP mise à jour dans le client et redémarrez-le.


Une configuration Développement ne peut pas démarrer


La configuration Développement est destinée à une copie de travail du code source. Compilez le dossier mcp-server du dépôt avant d’utiliser le chemin Développement généré. Les copies installées normalement doivent afficher une configuration Production.


Un outil manque ou son accès est refusé


  • Rechargez le client après avoir mis PlayAbility à jour.
  • Demandez au client d’actualiser sa liste d’outils MCP.
  • Modifiez les options sensibles pour la sécurité directement dans PlayAbility.


Sécurité


  • Traitez PLAYABILITY_WS_KEY comme un secret.
  • Vérifiez les demandes avant d’autoriser un assistant à saisir du texte, cliquer, déplacer un pointeur ou importer des assignations.
  • Commencez par des tâches en lecture seule.
  • Laissez Autoriser les sorties WebSocket désactivé, sauf si une autre intégration a spécifiquement besoin du flux de diffusion.
  • Désactivez Activer le Serveur MCP lorsque vous n’avez plus besoin de l’accès IA. La connexion MCP est alors immédiatement interrompue.
  • Dans les versions actuelles, la connexion est uniquement locale. N’exposez pas le port 13123 à Internet.


Articles connexes


Mis à jour le : 30/07/2026

Cet article a-t-il répondu à vos questions ?

Partagez vos commentaires

Annuler

Merci !