omnium-mcp — Omnium als MCP-server
Een MCP-server (Model Context Protocol) waarmee een AI-client — Claude Code in VS Code, Claude Desktop, … — Omnium kan lezen en meldingen kan behandelen, met de rechten van één gebruiker. Eerste stap van AI-1 (BACKLOG, 14-10-2026); opzet zoals de MusicBrain-MCP (stdio, de officiële SDK).
Tools
| Tool | Wat |
|---|---|
omnium_wie_ben_ik |
met welke gebruiker, rol en instantie de server werkt |
meldingen_lijst |
meldingen (open of alle); een melder ziet de eigen, een beheerder alle |
melding_bekijken |
één melding: beschrijving, context (versie, browser, plek, pad), gesprek en de schermafbeeldingen |
melding_reageren |
een reactie plaatsen |
melding_behandelen |
status, toelichting, prioriteit, behandelaar (beheerder) |
projecten_lijst |
de Studio-projecten waar je bij mag, met je recht |
modeltalen |
de modelleertalen (M2): typen, relaties met hun regels, aanwijzingen |
project_bekijken |
de projectboom; of wat er in een map staat, met ids |
model_wijzigen |
een plan (JSON) laten controleren en, met toepassen: true, doorvoeren |
Alles gaat via de gewone Omnium-API (/api/meldingen, /api/studio/projecten), dus dezelfde
afscherming als in de Studio.
Modellen (stap 2, 14-10)
Sinds 06-11 kan het plan ook een bestaand diagram hernoemen: {sleutel, bestaand: <diagram-id>, naam: "<nieuwe naam>"} in diagrammen (de tekst toont ~ diagram hernoemd: oud → nieuw).
model_wijzigen gebruikt dezelfde regelset en toepasser als de ✨ assistent in de Studio
(web/vite/src/studio/assistent/assistentKern.js en wijziging.js): de AI-client levert het
plan, de server-kant van de MCP controleert het tegen de taal (onbekende typen en verboden
relaties eruit, omgekeerde associaties gedraaid) en maakt er projectsync-operaties van
(nieuweMap, patchElementen, patchDiagrammen, plaatsPerMap, patchLinks). Die gaan naar
POST /api/studio/projecten/:id/ops; een open Studio ziet ze live. Zonder toepassen krijg je
alleen het voorstel. De stand van een project = snapshot + operaties, nagespeeld in Node-stores
(zoals de EA-import uit git).
Het plan:
{"uitleg": "…",
"diagrammen": [{"sleutel": "d1", "taal": "usecase05", "naam": "…", "map": "Submap"}, {"sleutel": "d2", "bestaand": "<diagram-id>"}],
"elementen": [{"sleutel": "u1", "type": "usecase", "naam": "…", "diagram": "d1", "in": "<container>"}, {"bestaand": "<element-id>", "naam": "nieuwe naam"}],
"connectoren": [{"type": "associatie", "bron": "a1", "doel": "<bestaand id>"}],
"verbanden": [{"van": "x1", "naar": "u1", "soort": "realiseert"}],
"opstelling": [{"diagram": "<id>", "actie": "naast-elkaar", "elementen": ["…"]}, {"diagram": "<id>", "actie": "leesvolgorde-lr"}],
"posities": [{"diagram": "<id>", "element": "<id>", "x": 400, "y": 200}, {"diagram": "<id>", "element": "<id>", "naast": "<id>", "kant": "rechts", "afstand": 60}],
"verwijderen": ["<id van een bestaand element of een bestaande relatie>"],
"nietGedaan": ["Kleuren kan ik niet zetten."]}
Grenzen (18-10). De server-instructies en de beschrijving van model_wijzigen zeggen wat
níet kan: diagrammen of mappen weghalen, kleuren, knikpunten of eigen lijnroutes, elementmaten.
Lijnen (07-11) kunnen wél: lijnen met een relatie of een ouder (al zijn kinderen) zet de
lijnvorm (krom, hoekig, recht, boom), de boomstijl (ouder boven/onder/links/rechts; bij overerving
is het doel de ouder, via naarOuder in profielen.json) en vaste uiteinden — dezelfde lijndata
als het rechtsklikmenu (diagramcore/model/lijnvorm.js). Wat het plan vraagt
maar niet doorgaat, staat in het antwoord onder Weggelaten of NIET GEDAAN, zodat de
aanroepende AI het niet als gedaan meldt. project_bekijken met een map toont per element waar het
staat (op <diagram> @ x,y (b×h)). Layouts per taal staan in modeltalen (Layouts …); de
MCP laadt de strategie uit de profielmodule, of bouwt de algemene layout op de leesvolgorde uit
profielen.json.
Sequence (06-11). Een plan voor een sequence-diagram noemt alleen levenslijnen en berichten
van levenslijn naar levenslijn, in de volgorde van het gesprek. De gedeelde wijzigingscode zet de
levenslijnen op één rij en maakt bij elk bericht de twee punten op de lijn, onder elkaar in
planvolgorde, zoals het canvas dat doet (web/vite/src/diagramprofielen/sequence/plaatsUitPlan.js).
De Studio leidt daaruit de activaties af. Een AI-client maakt zelf geen punten of activaties; dat
staat ook in modeltalen voor sequence05. Diagrammen van vóór 06-11 hebben die punten niet.
Vereisten: de Studio-code in web/vite moet zijn afhankelijkheden hebben (npm install daar).
De talen staan in profielen.json; na een wijziging aan een profiel opnieuw genereren met
node scripts/profielen-voor-mcp.mjs (vanuit web/vite).
Welke code draait de server? Hij laadt de Studio-code en profielen.json één keer, bij het
starten. omnium_wie_ben_ik noemt de commit waarop hij startte en waarschuwt als de repo verder
is; model_wijzigen zet die waarschuwing boven zijn antwoord (codestand.mjs, AI-3 08-11). Dan
de server herstarten (in Claude Code: /mcp → herstarten, of een nieuwe sessie).
Instellen (eenmalig)
- Afhankelijkheden:
cd bitemp_register_v06/tools/omnium-mcp && npm install - Token: Studio → Gebruikers → Mijn API-tokens → Token maken. Kopieer het (je ziet het één keer).
- Omgevingsvariabelen (niet in de repo; de repo is openbaar):
- Windows:
setx OMNIUM_TOKEN "omt_…"(en eventueelsetx OMNIUM_URL "http://localhost:8082"voor een lokale API; standaardhttps://app.omnium-ide.nl), daarna VS Code opnieuw starten. - macOS/Linux:
export OMNIUM_TOKEN=omt_…in je shellprofiel.
- Windows:
- Claude Code: de repo heeft een
.mcp.jsonmet de serveromnium. Bij de eerste keer vraagt Claude Code of je die projectserver vertrouwt;/mcptoont de stand.
Daarna kun je in een chat bijvoorbeeld zeggen: "Welke meldingen staan er open? Pak #5 op." — de sessie leest de melding met schermafbeelding, past de code aan, en zet de status met een toelichting. Of: "Maak in project Zandbak, map Test, een activiteitendiagram onder use case test" — de sessie bekijkt de map, maakt een plan, laat het controleren en past het toe.
Testen
node --test tools.test.mjs— de tools tegen een nep-API (ook de modeltools: snapshot + ops naspelen, voorstel zonder POST, toepassen met de juiste operaties, leesrecht weigert).OMNIUM_URL=… OMNIUM_TOKEN=… node smoke.mjs— de server echt over stdio (initialize, tools/list, tools/call), tegen een draaiende API.
Veiligheid
- Een token werkt als de gebruiker zelf; rol en status komen per verzoek uit het register (een geblokkeerde gebruiker kan ook met een token niets meer).
- Alleen de sha256 van een token staat in de database; intrekken kan in hetzelfde scherm.
- Met een token maak je geen nieuw token (daarvoor log je in).