TUTORIAL | Zet de Conduction MCP-server op

[WilcoLouwerse]

Achtergrond

Er staat al een tutorial MCP server op de academy (bron: academy/2026-04-29-mcp-server). Deze legt het basisidee uit, maar mist een duidelijke leerlijn die aansluit op de andere academy-tutorials en op de bredere AI-toolchain van Conduction.

Doel

Een publieke Nederlandstalige tutorial — of korte serie — op conduction.nl/academy die uitlegt wat de Conduction MCP-server is, waarom je hem zou willen draaien, en hoe je hem in vijftien minuten op je werkplek opzet en koppelt aan Claude.

Doelgroep

Developers en power-users die al met Claude/Claude Code werken en eigen tools/data via MCP willen ontsluiten.

Voorgestelde structuur (chaining)

Overlap met Workstation Setup: een MCP-server koppelen is onderdeel van een complete Conduction-werkplek. De tutorial Workstation Setup (issue #53) noemt MCP kort en linkt door naar deze tutorial voor de diepte. Deze tutorial gaat ervan uit dat de lezer een werkende werkplek heeft, of verwijst hem eerst terug naar Workstation Setup. Coördineer de scheidslijn bij het schrijven met issue #53.

1. Wat is MCP en wat doet de Conduction MCP-server? — concept, scenario's, plek in de stack. Doe eerst: Workstation Setup. Linkt door naar 2.
2. MCP-server lokaal opzetten — bestaande tutorial verfijnen/uitbreiden; werkend voorbeeld + verificatie van .mcp.json op project-root.
3. (optioneel) MCP-server koppelen aan een Conduction Nextcloud-app — eind-tot-eind demo.

Bestaande documentatie (referenties)

• Bestaande tutorial-bron: academy/2026-04-29-mcp-server
• In docs/claude/README.md staan wel relevante MCP-stukken die we kunnen hergebruiken/linken:
  • Playwright MCP Browser Setup (sectie rond regel 388) — concreet voorbeeld van zeven MCP-servers in .mcp.json, met de regels voor browser-1 t/m browser-7.
  • Settings-overzicht (rond regel 333) — uitleg over .claude/settings.json, MCP server-approvals en enableAllProjectMcpServers.
  • Troubleshooting (rond regel 587) — "MCP servers not showing in VS Code / not connected" + verificatie van de MCP-binary (npx -y @playwright/mcp@latest --headless --isolated --port 9999).
• docs/claude/playwright-setup.md — volledige Playwright-MCP setup-guide (configuratie, CLI-alternatieven, gebruiksregels).
• docs/claude/examples/.mcp.json.example — sjabloon voor .mcp.json in een project-root.

Deze stukken gaan vooral over MCP-servers consumeren (Claude die met een MCP-server praat). De tutorial mag ook het bouwen/draaien van de Conduction MCP-server toelichten — dat aspect zit nog niet in de claude-docs en is een goede kandidaat om in deze tutorial vast te leggen.

Pluvo-vragen (minimaal 4)

Voorbeelden:

1. Wat is MCP (Model Context Protocol) op één regel uitgelegd?
2. Welke drie hoofdtypen van MCP-resources onderscheid je (tools, resources, prompts), en wat doet elk?
3. Hoe registreer je de Conduction MCP-server in je lokale Claude-config?
4. Hoe controleer je dat de MCP-server daadwerkelijk bereikbaar is voor Claude?
5. Wanneer zou je een MCP-server bouwen in plaats van een Claude Skill?

Op te leveren

• Review en update van bestaande mcp-server tutorial
• Eventueel: nieuwe inleidende tutorial "Wat is MCP?"
• Minimaal 4 Pluvo-vragen per deel
• Cross-links naar Workstation Setup (issue #53) ("Doe eerst …"), Skills-tutorial, Build-an-app
• Linkcheck
• Peer review

Schrijfstijl

Volg de Conduction-schrijfstijl (zie identity.conduction.nl). Voorbeeldstructuur: Bestanden bij een Woo-publicatie uploaden. Liever twee korte tutorials dan één lange.

Tijdregistratie

Uren op dit issue boeken op de Jira-issue van het SLIM-account.

[WilcoLouwerse]