# GENESYS MCP

Connecteur local pour piloter **Vitech GENESYS** depuis Codex, Claude Code ou Claude Desktop. Il permet d’explorer le modèle, de cloner un projet modèle, de créer des entités, des relations et des diagrammes, puis d’exporter des vues en PNG.

## Installation sous Windows

Prérequis : Windows x64, Vitech GENESYS installé et licencié, .NET Framework 4.8, [Node.js 22 ou plus](https://nodejs.org/) et [Git](https://git-scm.com/). La passerelle a été développée avec GENESYS 2026 University Edition. Les autres éditions et versions restent à vérifier.

Dans PowerShell :

```powershell
git clone https://github.com/MVAUTL/genesys-mcp.git
cd genesys-mcp
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Client Codex
```

| Client | Dernier argument | Prérequis côté client |
| --- | --- | --- |
| Codex | `-Client Codex` | Commande `codex` accessible dans PowerShell |
| Claude Code | `-Client ClaudeCode` | Commande `claude` accessible dans PowerShell |
| Claude Desktop | `-Client ClaudeDesktop` | Application Windows installée |

L’installateur compile la passerelle à partir de ton installation GENESYS, puis te demande ton compte GENESYS. Entre le mot de passe dans la fenêtre Windows, pas dans la conversation. Ferme et rouvre le client après l’installation. Garde le dossier cloné au même emplacement : le client s’en sert pour démarrer le connecteur.

Tu peux ajouter `-InstallPath 'D:\Applications\GENESYS'` si GENESYS est installé hors du dossier standard, ou `-SkipCredentials` si ton compte est déjà enregistré par cet installateur. Pour configurer un autre client par la suite, relance l’installation avec le nouveau `-Client` et `-SkipCredentials`.

### Installation par catalogue

Pour Codex ou Claude Code, le dépôt contient aussi leurs manifestes de plugin. Prépare d’abord la passerelle et le compte avec `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install.ps1`, puis utilise **une seule** des méthodes de connexion par client :

- **Codex** : ajoute le catalogue avec `codex plugin marketplace add MVAUTL/genesys-mcp`, puis lance `codex plugin add genesys-control@genesys-tools`.
- **Claude Code** : dans Claude Code, lance `/plugin marketplace add MVAUTL/genesys-mcp` puis `/plugin install genesys-control@genesys-tools`.

## Premier essai

> Liste les projets GENESYS auxquels j’ai accès, sans rien modifier. Pour le projet de mon choix, montre les types d’entités, de relations et de diagrammes disponibles dans son schéma.

Ensuite, demande par exemple de cloner un projet modèle, de créer les fonctions d’une station de mesure et de produire un diagramme de contexte. Donne le nom du projet cible et les sources à suivre. Les types de diagrammes et les relations possibles dépendent du schéma GENESYS du projet.

## Dépannage et données

- **Serveur absent** : redémarre le client. Dans Codex, `codex mcp list` permet de vérifier la configuration ; dans Claude Code, utilise `/mcp`.
- **Compte refusé** : relance l’installateur sans `-Client` pour ressaisir tes identifiants.
- **Mise à jour** : dans le dépôt cloné, exécute `git pull` et redémarre le client. Si tu as installé via un catalogue, mets à jour le plugin depuis ce catalogue.
- **Désinstallation** : retire le plugin ou l’entrée MCP `genesys` dans ton client. Pour Claude Desktop, elle se trouve sous `mcpServers` dans `%APPDATA%\Claude\claude_desktop_config.json`.

Le mot de passe est chiffré pour ton compte Windows. La passerelle compilée, les identifiants, les exports PNG et le journal des modifications restent sous `%LOCALAPPDATA%\GenesysMcp`. Le serveur accède au dépôt GENESYS local avec les droits du compte fourni. Le connecteur n’envoie pas de données lui-même à un service externe, mais les résultats d’outils sont transmis au client IA et peuvent être traités par son service selon sa configuration.

Le dépôt contient le code source du connecteur uniquement. Une licence GENESYS valide est nécessaire ; les composants Vitech et les modèles utilisateur ne sont pas distribués ici.

[Documentation MCP de Codex](https://learn.chatgpt.com/docs/extend/mcp?surface=cli) · [Documentation MCP de Claude Code](https://code.claude.com/docs/en/mcp)