Comment utiliser PigeonCast MCP
Ce guide présente la procédure de configuration détaillée de PigeonCast MCP, qui permet à votre IA de contrôler la recopie de l’écran.
Guide étape par étape
Guide de configuration générale
- Notez le chemin de MCP. Pour les installations effectuées depuis le site officiel, le chemin par défaut est C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe ; pour la version du Microsoft Store, il s’agit du fichier Tools\pigeoncast-mcp.exe inclus dans le paquet de l’application. Vous pouvez rechercher ce nom de fichier dans le répertoire d’installation. a. Si vous avez coché Add to PATH lors de l’installation depuis le site officiel, vous pouvez exécuter pigeoncast-cli ping directement dans le terminal. Pour la configuration MCP, il est toutefois recommandé d’utiliser le chemin complet de pigeoncast-mcp.exe afin que le client d’IA puisse toujours trouver le programme.
- Remplacez la valeur command du JSON ci-dessous par le chemin réel de pigeoncast-mcp.exe sur votre ordinateur. Notez que, dans JSON, les barres obliques inverses doivent être écrites sous la forme \. Copiez le JSON avec le chemin corrigé dans la fenêtre de conversation de l’IA et indiquez-lui : Appliquer globalement.
- Après avoir enregistré la configuration, rechargez MCP dans le client concerné ou redémarrez l’application. Vous devriez alors voir dans la liste des outils des noms commençant par host_, tels que host_ping, host_discovery_list_devices et host_mirror_start.
- Vérification rapide : demandez à l’IA « Utilise la fonction host_ping de PigeonCast pour vérifier si l’application est en cours d’exécution. » Si le programme principal est déjà lancé, la vérification doit réussir ; sinon, un échec de connexion au canal sera signalé.
Cursor
Option A : projet actuel uniquement (recommandé pour le partage en équipe)
- Créez .cursor/mcp.json à la racine du projet.
- Collez la configuration mcpServers de la section précédente et définissez command sur le chemin absolu de pigeoncast-mcp.exe sur l’ordinateur local.
- Ouvrez Cursor → Paramètres → MCP, vérifiez que le serveur pigeoncast apparaît, puis cliquez sur Reload ou actualisez la liste.
Option B : tous les projets
- Accédez à Cursor → Paramètres → MCP → Ajouter un nouveau serveur MCP global.
- Sélectionnez stdio comme type, saisissez le chemin complet de pigeoncast-mcp.exe comme commande et laissez les arguments vides. Vous pouvez également modifier manuellement le fichier de configuration utilisateur, dont l’emplacement varie selon la version et correspond généralement à %USERPROFILE%.cursor\mcp.json, en reprenant le format de la section précédente.
Conseils
- Vérifiez que l’application principale PigeonCast est en cours d’exécution avant de demander à l’agent de rechercher des appareils ou de démarrer la diffusion de l’écran.
- Si Cursor utilise encore un ancien processus MCP, rechargez-le après avoir modifié la configuration. Si le problème persiste, quittez complètement Cursor, puis rouvrez-le.
- Pour obtenir une description détaillée des outils et des scénarios de test, consultez mcp-usage-for-testers.md dans le dépôt.
Claude Code (CLI)
Option A : ajout depuis la ligne de commande (recommandé)
Exécutez la commande suivante dans PowerShell en remplaçant le chemin par celui de votre installation :claude mcp add --scope user pigeoncast -- "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe" Pour rendre le serveur disponible uniquement dans le projet actuel :
claude mcp add --scope project pigeoncast -- "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe"
Pour vérifier qu’il a bien été ajouté :
claude mcp list
Option B : modification du fichier de configuration
| Portée | Fichier de configuration |
|---|---|
| Projet actuel | .mcp.json à la racine du projet |
| Tous les projets sur cet ordinateur | mcpServers dans %USERPROFILE%\.claude.json |
Exemple de fichier .mcp.json :
{
"mcpServers": {
"pigeoncast": {
"type": "stdio",
"command": "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe",
"args": []
}
}
}
Après l’enregistrement, redémarrez la session Claude Code ou exécutez la commande de rechargement MCP dans la session, selon la version utilisée.
Claude Desktop (Windows)
- Quittez complètement Claude Desktop, y compris le processus de la zone de notification.
- Modifiez le fichier de configuration. Si vous utilisez l’installation MSIX, utilisez le chemin réellement lu par l’application indiqué ci-dessous au lieu de modifier uniquement le fichier ouvert par le bouton Edit Config, faute de quoi la modification pourrait ne pas prendre effet.
- À la racine du fichier JSON, ajoutez ou fusionnez mcpServers en reprenant la structure de la section 2 et en définissant command sur le chemin absolu de pigeoncast-mcp.exe.
- Enregistrez le fichier, puis redémarrez Claude Desktop.
- Dans Paramètres → Développeur, vérifiez que pigeoncast apparaît dans la liste des serveurs MCP.
OpenAI Codex (CLI)
Codex utilise TOML pour configurer MCP. Le fichier par défaut est %USERPROFILE%.codex\config.toml. Au niveau du projet, vous pouvez utiliser .codex/config.toml à la racine d’un dépôt approuvé.
Option A : ajout depuis la ligne de commande
codex mcp add pigeoncast -- "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe"
Pour afficher la configuration actuelle :
codex mcp list
Option B : modification de config.toml
Ajoutez le contenu suivant à ~/.codex/config.toml :
[mcp_servers.pigeoncast]
command = "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe"
args = []
enabled = true
Si vous utilisez un fichier .codex/config.toml au niveau du projet, vous devez marquer ce projet comme approuvé, sinon le serveur MCP local risque de ne pas se charger. Documentation : serveurs MCP de Codex (en cas de doute, consultez la documentation OpenAI actuelle)
Autres clients compatibles avec MCP
Tout client prenant en charge MCP via stdio et permettant de spécifier le chemin d’un exécutable ainsi que des arguments peut utiliser la même configuration de base :
- command : chemin absolu de pigeoncast-mcp.exe
- args : [] (laisser vide)
- env : aucune variable d’environnement supplémentaire n’est généralement requise Reprenez le bloc mcpServers de la section 2 et adaptez le nom du fichier et ceux des champs au client cible. Certains clients utilisent des champs tels que type: "stdio".