Workstation Setup leerlijn — Deel 4: De MCP-server aansluiten

MCP — Model Context Protocol — is de standaard-interface waarmee Claude Code naar externe tools praat. Binnen een Conduction-project betekent dat in de praktijk twee dingen: een Playwright-browserpool (browser-1 … browser-7) voor de testing-skills, en de OpenRegister MCP-server voor directe toegang tot je lokale Conduction-datalaag. Een workstation is pas echt af als minstens de browserpool via .mcp.json in je project-root is aangesloten. Dit deel behandelt dat; de OpenRegister MCP-server staat in een eigen tutorial — daar linken we onderaan naar.

In één zin

MCP is een klein open protocol waarmee Claude Code naar buiten kan bellen naar externe services via een uniforme interface. Een "MCP-server" is elk programma dat dat protocol spreekt; Claude behandelt het als een tool-leverancier. Je hangt servers aan een project door ze op te sommen in .mcp.json in de project-root.

Een paar servers die je bij Conduction tegenkomt:

• browser-1 … browser-7 — Playwright-browserinstanties die Claude voor testing-skills kan gebruiken (/test-app, /test-counsel, de hydra-gate-*-familie).
• De OpenRegister MCP-server — Claude praat direct met OpenRegister: registers en schema's lijsten, objecten zoeken en lezen, de audit-trail uitlezen. Behandeld in een eigen tutorial.

Deze module stopt bewust bij de Playwright-pool: het is de pool die elke Conduction-developer nodig heeft, en hij werkt zonder extra accounts.

Stap 1: maak .mcp.json in de project-root

In een Conduction-project bestaat het bestand al — open het, scroll, controleer. In een nieuwe map maak je hem zelf aan. De minimumconfiguratie waar alle testing-skills van uitgaan is de zeven-browserpool: zes headless browsers voor parallelle agents, één headed browser voor wanneer je wilt meekijken.

/pad/naar/je-project/.mcp.json:

{
  "mcpServers": {
    "browser-1": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--browser", "chromium", "--headless", "--isolated"]
    },
    "browser-2": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--browser", "chromium", "--headless", "--isolated"]
    },
    "browser-3": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--browser", "chromium", "--headless", "--isolated"]
    },
    "browser-4": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--browser", "chromium", "--headless", "--isolated"]
    },
    "browser-5": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--browser", "chromium", "--headless", "--isolated"]
    },
    "browser-6": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--browser", "chromium", "--isolated"]
    },
    "browser-7": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--browser", "chromium", "--headless", "--isolated"]
    }
  }
}

Let op de asymmetrie: browser-6 laat --headless weg. Dat is bewust — het is de zichtbare browser voor wanneer je Claude wilt zien werken. De andere zes blijven onzichtbaar.

Hoef je niet vanaf nul te typen. De .github-repo bevat een voorbeeld-.mcp.json die je direct kunt kopiëren.

Stap 2: vertrouw de servers via .claude/settings.json

Elke Conduction-repo heeft een .claude/settings.json (op projectniveau — los van je globale) die de MCP-servers vooraf goedkeurt zodat achtergrondagents niet door prompts geblokkeerd worden. De twee relevante regels:

{
  "enableAllProjectMcpServers": true,
  "permissions": {
    "allow": ["mcp__browser-*"]
  }
}

• enableAllProjectMcpServers: true — keurt alle servers in .mcp.json automatisch goed, zonder prompt bij elke reload.
• mcp__browser-* — keurt elke browser-toolaanroep vooraf goed, zodat sub-agents die parallel werken niet stilzwijgend worden geweigerd.

In een lege map zet je deze settings zelf neer. In een Conduction-repo staan ze er al.

Stap 3: VS Code opnieuw laden

Ctrl+Shift+P → "Developer: Reload Window". VS Code leest .mcp.json opnieuw in en start de browser-processen.

Stap 4: verifiëren

Open het MCP-servers-paneel in VS Code. Twee gelijkwaardige manieren:

• Typ /MCP servers in het Claude Code-chatvenster, of
• Ctrl+Shift+P → zoek "MCP servers" → open het paneel.

Alle zeven browsers moeten Connected tonen. Als er één een fout geeft, open dan het output-paneel: Ctrl+Shift+P → "Output: Focus on Output" → kies Claude VSCode in de dropdown — de foutregel vertelt precies wat er misging.

Veelvoorkomende oorzaak als een browser niet verbindt: de Playwright Chromium-binary is niet geïnstalleerd. Draai npx playwright install chromium vanuit je WSL-terminal (zou er al moeten staan uit Deel 2 Stap 9). Reload het venster daarna.

Hoe weet Claude welke browser hij moet gebruiken?

Er is geen centrale dispatcher. De skills zelf wijzen browsers toe — bij conventie:

Als een browser een fout geeft, valt Claude terug op de volgende genummerde. Je hoeft dat niet handmatig te regelen.

Waarom zeven browsers?

Het aantal is afgestemd op de worst case van /test-app Full mode, met één slot gereserveerd voor menselijke observatie:

• Eén main agent (browser-1) + vijf parallelle sub-agents (browser-2–browser-5 en browser-7) = zes headless. Dat dekt de zwaarste parallelle run van /test-app Full mode.
• Eén headed browser voor observatie — handig wanneer je wilt zien wat Claude doet in plaats van alleen het resultaat lezen.

Andere workspaces gebruiken misschien minder (of meer) browsers afhankelijk van het parallelisme. De Nextcloud-workspace gebruikt deze zeven; voor een eenmalig prototype kun je gerust naar twee terug.

En de OpenRegister MCP-server dan?

Voor Conduction-projecten is de Playwright-pool alleen niet genoeg. De OpenRegister MCP-server — geleverd als endpoint binnen de OpenRegister Nextcloud-app op http://localhost:8080/index.php/apps/openregister/mcp — geeft Claude directe toegang tot de datalaag van je Conduction-stack: registers en schema's lijsten, objecten zoeken en lezen, door de audit-trail lopen.

Het is een aparte installatie met een eigen configuratie en heeft daarom een eigen tutorial:

• Zet de Conduction MCP-server op — de aparte tutorial voor die stap.

Doe je die tutorial, dan voeg je een extra entry toe aan dezelfde .mcp.json en reload je. De Playwright-pool blijft staan.

Een noot over .mcp.json vs. ~/.claude/settings.json

Twee bestanden, verschillende scopes. Houd ze uit elkaar:

De user-configuratie bevat nooit MCP-servers; de project-configuratie wel. Door die scheiding kiest elk project zijn eigen set servers zonder dat je globale safety-policy in de weg zit.

Test jezelf

Vijf korte vragen om te checken of je dit deel begrepen hebt. Vastgelopen? Klik Hint. Curieus naar het antwoord? Klik Antwoord.