MCP-server

DimensionKit beschikt over een externe MCP-server, waarmee een AI-assistent namens jou scorekaarten kan aanmaken, bewerken, publiceren en evalueren.

https://app.dimensionkit.com/mcp

Plak deze URL in elke client die externe MCP-servers ondersteunt. Zie Een client verbinden voor de configuratie en Verbindingen beheren om actieve sessies in te zien of in te trekken.

Wat de server kan

• Scorekaarten aanmaken, dimensies en vragen toevoegen, niveaus instellen en publiceren
• Vragen en dimensies op actieve scorekaarten aanpassen of verwijderen
• Inzendingen inzien, inclusief scores per dimensie en de gekozen antwoorden
• Controleren of een scorekaart klaar is voor publicatie en eventuele zwakke punten opsporen
• Een preview-link genereren voor een concept voordat deze live gaat

Hoe een scorekaart wordt opgebouwd

De tools zijn gestructureerd volgens de logische werkvolgorde:

1. scorecard_design_guide — De ontwerpgids, te raadplegen vóór het schrijven
2. create_scorecard — Een concept aanmaken met weergave- en merkinstellingen
3. add_dimension — De te meten dimensies definiëren
4. add_questions — Alle vragen voor een dimensie in één aanroep toevoegen
5. set_dimension_tiers — De resultaatniveaus en bijbehorende inzichten vastleggen
6. check_scorecard — Publicatie-eisen valideren en tekortkomingen signaleren
7. publish_scorecard — De scorekaart publiek beschikbaar maken

Een concept is niet openbaar toegankelijk. Tool-antwoorden bevatten de toekomstige URL gemarkeerd met urlIsLive: false, zodat de assistent weet dat deze nog niet gedeeld mag worden.

Inhoudelijke richtlijnen in plaats van louter schema’s

scorecard_design_guide bevat de kwalitatieve principes die een schema niet kan overbrengen: welke vragen hij jou vooraf moet stellen, hoe vragen te formuleren zonder voor de hand liggende antwoorden, hoe waardevolle niveau-inzichten te schrijven en welk thema past bij de doelgroep — zie ook Thema’s en branding. Een assistent die deze gids eerst leest, vraagt gericht naar jouw doelgroep en stijlvoorkeuren.

Clients met ondersteuning voor MCP-prompts kunnen bovendien gebruikmaken van drie prompts: build_scorecard, review_scorecard en choose_theme.

Een concept bekijken vóór publicatie

Elk tool-resultaat voor een concept bevat een previewUrl: een ondertekende link die 24 uur geldig is en de scorekaart precies weergeeft zoals respondenten hem zullen zien. Er staat een conceptbanner op en testinzendingen worden niet in de database opgeslagen.

Twee regels die de tools afdwingen

Niveaubereiken worden berekend en nooit handmatig ingevoerd. De score van een dimensie ligt tussen de som van de laagste antwoordwaarden en de som van de hoogste, en de niveaus verdelen dat bereik naadloos. Het toevoegen, wijzigen of verwijderen van vragen herberekent de bereiken automatisch. Jij levert de labels en inzichten; het systeem bepaalt de getallen.

Vraag-ID’s en dimensiesleutels zijn definitief. Ingezonden antwoorden worden opgeslagen onder het vraag-ID en scores onder de dimensiesleutel. Hernoemen zou bestaande data corrumperen. Daarom passen update_question en update_dimension alle eigenschappen aan behalve deze sleutels.

Een reeds gepubliceerde scorekaart bewerken

Dit is volkomen veilig. Elke inzending bewaart zijn eigen scores, niveau en de exacte formulering ten tijde van invullen, voorzien van een hash van de toenmalige configuratie. Bewerkingen hebben nooit invloed op historische data.

Wat bewust niet wordt ondersteund

• Geen directe wedervragen via het MCP-protocol. Elicitation vereist open bidirectionele verbindingen die deze server niet openhoudt. Eventuele verduidelijkingen vinden plaats in jouw reguliere chat met de assistent.
• Geen streaming. Het eindpunt handelt verzoeken per stuk af en houdt geen actieve SSE-verbindingen aan.
• Geen toegang tot account- of factuurgegevens. De scopes beperken zich strikt tot scorekaarten en hun inzendingen.
• Geen openbare schrijf-REST-API. De REST-interface blijft beperkt tot lezen en formulierinzendingen; wijzigingen verlopen via MCP of het beheerpaneel.