MCP
PlayerVox OverCrow a un serveur pour les assistants IA : @overcrow/mcp.
Ajoutez-le à Claude Code, Claude Desktop, Cursor, VS Code ou Codex, et votre
assistant peut créer un widget, le vérifier, le tester, l’auditer,
l’empaqueter et préparer sa soumission. Il vous faut Node.js 22.18 ou plus
récent, rien d’autre : le serveur installe lui-même les outils OverCrow dont
il a besoin.
claude mcp add overcrow -- npx -y @overcrow/mcpDemandez ensuite : « Crée un widget PlayerVox OverCrow qui affiche… ».
Ajouter le serveur
Ouvrez votre dossier de widgets dans l’assistant, puis ajoutez le serveur.
En une commande
Claude Code, depuis ce dossier :
claude mcp add overcrow -- npx -y @overcrow/mcpCodex :
codex mcp add overcrow -- npx -y @overcrow/mcpVS Code : installer dans VS Code, ou :
code --add-mcp '{"name":"overcrow","command":"npx","args":["-y","@overcrow/mcp"]}'Avec un fichier de configuration
Cursor : un fichier .cursor/mcp.json dans le dossier.
{
"mcpServers": {
"overcrow": {
"command": "npx",
"args": ["-y", "@overcrow/mcp"]
}
}
}VS Code : un fichier .vscode/mcp.json dans le dossier.
{
"servers": {
"overcrow": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@overcrow/mcp"]
}
}
}Claude Desktop lance ses serveurs hors de vos dossiers : indiquez votre
dossier de widgets avec --root dans claude_desktop_config.json
(Paramètres, Développeur, Modifier la configuration), puis redémarrez
Claude Desktop.
{
"mcpServers": {
"overcrow": {
"command": "npx",
"args": ["-y", "@overcrow/mcp", "--root", "C:\\Users\\you\\Documents\\widgets"]
}
}
}Ce que fait le serveur
- La première fois, il télécharge les outils créateurs
PlayerVox OverCrow de votre ordinateur (l’outil en ligne de
commande et le runtime qui joue les tests, environ
15 Mo) depuis la release GitHub d’OverCrow. Il vérifie chaque fichier avec
les empreintes inscrites dans le serveur, puis les garde dans son propre
dossier (
~/.cache/overcrow-mcp, ou%LOCALAPPDATA%\overcrow-mcpsous Windows). Rien ne s’ajoute à votrePATH, et aucun droit d’administrateur n’est nécessaire. - Ensuite, votre assistant travaille avec ses outils, dans cet ordre : créer le widget depuis un modèle, installer le SDK (il vous le demande d’abord), vérifier, tester (il voit les images qui diffèrent), auditer, empaqueter, préparer la soumission.
- L’identifiant du widget est définitif. Votre assistant vous le
demande : votre pseudo d’éditeur dans l’espace créateurs de
PlayerVox OverCrow et un nom (
nova.lol-timers), ou un domaine que vous pouvez vérifier (gg.nova.lol-timers). - La soumission : le serveur vérifie tout ce que demande l’espace
créateurs, puis écrit le zip des sources de votre widget dans
dist/, sansnode_modules,dist, fichiers cachés ni clés, et liste ce qu’il a laissé de côté. Il liste aussi les textes à écrire : pourquoi le widget a besoin de chaque permission, les notes de version et la description en français et en anglais. Votre assistant les rédige avec vous. - L’audit note le widget sur 100 pour la sécurité et pour la légèreté, avec pour chaque constat une correction et un exemple tiré d’un widget de référence : permissions inutilisées, règles réseau trop larges, secrets, écritures dans le presse-papiers sans action de l’utilisateur, minuteurs rapides, interrogation répétée du réseau, listes qui grandissent sans fin, grosses réponses lues en un seul tour, images lourdes.
- La documentation de ce site, en français et en anglais, et les sources des widgets de référence viennent avec le serveur : votre assistant les lit sans accès au réseau.
Ce qu’il ne fait pas
- Il n’envoie, ne signe et ne publie jamais rien. Vous envoyez le zip et les textes dans l’espace créateurs de PlayerVox OverCrow, à l’adresse creators.playervox.com.
- Il n’installe pas votre widget dans PlayerVox OverCrow : l’essayer en jeu passe par le canal de développement de l’outil en ligne de commande.
- Il n’envoie rien sur vous : ni télémétrie, ni compte.
Sécurité
- Vos dossiers seulement. Le serveur travaille dans le dossier ouvert
dans votre assistant (ou ceux donnés avec
--root). Il refuse un dossier système, votre dossier personnel entier, les dossiers cachés et les liens qui mènent ailleurs. - Aucune commande de son choix. Le serveur lance l’outil en ligne de commande de PlayerVox OverCrow et npm, rien d’autre, jamais à travers un shell.
- Téléchargements vérifiés. Il ne télécharge que les fichiers épinglés
depuis GitHub, et les vérifie avant de s’en servir. npm n’installe que
@overcrow/sdket TypeScript, sans scripts d’installation, et leur intégrité est comparée à celle des paquets publiés. - Vous confirmez. Installer des paquets et remplacer des images de référence demandent votre accord.
- Vos fichiers sont des données. Ce que les outils renvoient de vos fichiers est marqué comme donnée : un texte placé dans un widget ne peut pas donner d’ordres à votre assistant par le serveur. Relisez tout de même ce que votre assistant modifie, et validez ses actions comme d’habitude.
Hors ligne
Téléchargez une fois depuis la release GitHub de PlayerVox OverCrow le
fichier overcrow-creator-tools-VERSION-PLATFORME.zip de votre plateforme,
placez-le dans votre dossier de widgets, et demandez à votre assistant de
lancer setup avec ce fichier (zipPath). Ou lancez le serveur avec
--tools-zip et le chemin du fichier. Le fichier doit être exactement celui
que le serveur épingle.
Ordinateurs pris en charge
Vérifier, tester et empaqueter demandent Windows x64 ou Linux x86-64. Sous macOS et sur ARM, le serveur donne quand même la documentation, les explications et l’audit.
En cas de problème
- « not tied to a published OverCrow release » : mettez le serveur à
jour avec
npx -y @overcrow/mcp@latest. - Derrière un proxy : définissez
HTTPS_PROXYdans l’environnement du serveur. - « cannot work in / » (souvent Claude Desktop) : ajoutez
--rootet votre dossier de widgets.