Gebruikershandleiding MCP-server — Koppel je AI-assistent aan de WIDE-huisstijl

Wat is het

Eén verbinding, en je assistent kent de hele huisstijl

MCP — het Model Context Protocol — is de open standaard waarmee AI-assistenten externe kennis en tools gebruiken. WIDE Solutions stelt via dit protocol de wide-presentatie skill beschikbaar: de complete ontwerpinstructies, design-tokens en voorbeelden achter onze documenten.

Wat je nodig hebt

Een AI-omgeving die remote MCP-servers ondersteunt (Streamable HTTP) — Claude Code, de Claude API, Cursor en de meeste moderne clients.
Een persoonlijk toegangstoken van WIDE Solutions. Dat ontvang je van Dennis Verhaert (dennis.verhaert@widesolutions.eu) en het begint met wide_.

Servergegevens

Endpoint	`https://mcp.widesolutions.eu/wide-presentatie/mcp`
Transport	Streamable HTTP
Authenticatie	`Authorization: Bearer <token>`
Statuscheck	`/wide-presentatie/health` — vrij toegankelijk

Zo loopt de verbinding

Zonder geldig token komt geen enkel verzoek voorbij de server — elke gebruiker heeft een eigen, intrekbaar token.

Aankoppelen

Kies je omgeving en plak je token

Vervang in de voorbeelden wide_JOUW_TOKEN door het token dat je van WIDE hebt ontvangen.

Claude Code

Terminal

claude mcp add --transport http wide-skills \
  https://mcp.widesolutions.eu/wide-presentatie/mcp \
  --header "Authorization: Bearer wide_JOUW_TOKEN"

Controleer daarna met claude mcp list — de server wide-skills hoort „connected" te tonen.

Claude API — voor ontwikkelaars

Request-body

"mcp_servers": [{
  "type": "url",
  "url": "https://mcp.widesolutions.eu/wide-presentatie/mcp",
  "name": "wide-skills",
  "authorization_token": "wide_JOUW_TOKEN"
}]

Cursor, VS Code en andere clients met headers

mcp.json

{
  "mcpServers": {
    "wide-skills": {
      "url": "https://mcp.widesolutions.eu/wide-presentatie/mcp",
      "headers": { "Authorization": "Bearer wide_JOUW_TOKEN" }
    }
  }
}

Voeg in de MCP-configuratie een server toe van het type http (streamable) met de URL en de Authorization-header.

De server accepteert het token uitsluitend via de Authorization-header. Clients die geen headers kunnen meesturen, kunnen niet koppelen — tokens in een URL zijn niet veilig genoeg.

Gebruik

Vier tools — maar meestal vraag je het gewoon

Na het koppelen kan je assistent deze tools aanroepen. Je hoeft ze niet zelf te kennen: een gewone vraag in je eigen woorden volstaat.

Tool	Wat hij doet
list_skills	Toont de beschikbare WIDE-skills
get_skill	Haalt de volledige instructies van een skill op — het startpunt
list_skill_files	Toont de bijbehorende referentie- en voorbeeldbestanden
read_skill_file	Leest zo'n bestand, bijvoorbeeld de design-tokens of een voorbeeldpagina

„Haal de wide-presentatie skill op via de wide-skills server en maak daarmee een presentatie over ons jaarplan."
Voorbeeldprompt — de assistent doet de rest

De assistent haalt zelf de instructies, kleuren, typografie en voorbeelden op en bouwt het document volgens de huisstijlregels — inclusief de details die je anders vergeet.

Even testen? Vraag je assistent: „Welke tools biedt de wide-skills server?" Of open mcp.widesolutions.eu/wide-presentatie/health in je browser — daar hoort {"status":"ok"} te staan, ook zonder token.

Je token

Persoonlijk, intrekbaar — en alleen van jou

Je token is jouw sleutel tot de server. WIDE bewaart hem nergens leesbaar; wat jij ermee doet, bepaalt de veiligheid.

Doe wél

Bewaar het token in een wachtwoordmanager of geheimenkluis
Meld het direct bij Dennis Verhaert (dennis.verhaert@widesolutions.eu) als het token kwijt of mogelijk uitgelekt is — je krijgt kosteloos een nieuwe
Gebruik per persoon of systeem een eigen token

Doe níet

Het token delen met collega's — ieder krijgt zijn eigen token
Het token in code, repositories, chats of documentatie zetten
Het token in een URL gebruiken als je client headers ondersteunt

wide_9f2c… — vast voorvoegsel + 48 tekens. WIDE bewaart alleen een cryptografische vingerafdruk; kwijt = opnieuw uitgeven. Intrekken werkt per direct.

Problemen oplossen

Als het niet meteen werkt

Melding of symptoom	Wat er aan de hand is
`401 unauthorized`	Het token ontbreekt, is verkeerd overgenomen of is ingetrokken. Controleer de header (`Bearer wide_…`, let op de spatie) en neem zo nodig contact op.
Verbinding weigert of time-out	Controleer de URL — `https://mcp.widesolutions.eu/wide-presentatie/mcp` — en je netwerk. Werkt `/health` in je browser wel, dan ligt het aan de clientconfiguratie.
Tools verschijnen niet in je assistent	Herstart je AI-client na het toevoegen van de server; sommige clients laden MCP-servers alleen bij het opstarten.

Kom je er niet uit? Dennis Verhaert (dennis.verhaert@widesolutions.eu) helpt je verder — houd de foutmelding en de naam van je AI-client bij de hand.

Jouw AI-assistent. Onze huisstijl.