Naar de inhoud

Aansluiten via MCP

Denkploeg aansluiten als MCP-server in Claude, Codex of een andere client, met wat je nodig hebt, welk gereedschap er is en wat er nooit gebeurt.

DocumentatieAansluiten via MCP

Denkploeg is een platform waarop een ploeg AI-agents werk doet voor een werkruimte, met een mens die tekent voordat er iets naar buiten gaat.

Je kunt hem ook andersom gebruiken: Denkploeg is zelf een MCP-server. Een client als Claude Desktop, Claude Code of Codex praat daarmee met één werkruimte en kan daarin veel van wat je in het chatscherm en de studio's doet, inclusief een vraag aan de regisseur.

Het chatscherm, de studio's en de MCP-server zijn drie ingangen op hetzelfde werk. Alles wat je via MCP kunt, kun je ook in de portal. Andersom niet: sommige dingen blijven met opzet een handeling van een mens op een scherm.

Werkt met
  • Claude Code
  • Claude Desktop
  • Codex
  • Cursor

Wat je nodig hebt

Een machinetoken. Die hoort bij precies één werkruimte en draagt een van de gewone rollen (lezer, maker, beheerder of eigenaar). Tekenen kan met geen enkele rol: een handtekening blijft een handeling van een mens op een scherm. Een sleutel kan nooit meer dan jijzelf. Een sleutel vervalt altijd: standaard na 90 dagen, hoogstens na 365. Maak voor die tijd een nieuwe.

Een beheerder van je werkruimte maakt hem aan onder Koppelingen > Denkploeg in Claude (/w/<werkruimte>/connections?tab=denkploeg-in-claude). Hij begint met dpl_, staat één keer op het scherm en is daarna nooit meer te lezen, ook niet door ons. Kwijt is opnieuw maken. Intrekken werkt meteen.

Aansluiten

Je hebt twee dingen nodig en verder niets: een adres en een sleutel. Er wordt niets geïnstalleerd.

  • Adres: https://app.denkploeg.nl/api/mcp
  • Sleutel: je machinetoken (dpl_...), als Authorization: Bearer <sleutel>.

Onder Koppelingen > Denkploeg in Claude staat per client een instelblok met het adres al ingevuld. Daar maak je ook de sleutel.

  1. Maak een sleutel

    Een beheerder doet dat onder Koppelingen > Denkploeg in Claude. Hij staat één keer op het scherm.

  2. Kies je client

    Op dezelfde plek staat per client een instelblok met het adres al ingevuld.

  3. Vul adres en sleutel in

    Het adres is https://app.denkploeg.nl/api/mcp, de sleutel gaat mee als Authorization: Bearer <sleutel>.

  4. Vraag iets

    Bijvoorbeeld aan de regisseur, met denkploeg_vraag.

  • Claude Code

    Eén opdracht in de terminal.

  • Cursor

    Een instelling in .cursor/mcp.json.

  • Codex

    Een blok in ~/.codex/config.toml.

  • Claude Desktop

    Een eigen connector onder Customize, Connectors. Ook voor claude.ai.

Per client precies zo:

ClientWat je doet
Claude Codeclaude mcp add --transport http denkploeg https://app.denkploeg.nl/api/mcp --header "Authorization: Bearer <sleutel>"
CursorIn .cursor/mcp.json: {"mcpServers":{"denkploeg":{"url":"https://app.denkploeg.nl/api/mcp","headers":{"Authorization":"Bearer <sleutel>"}}}}
CodexIn ~/.codex/config.toml: [mcp_servers.denkploeg] met url = "https://app.denkploeg.nl/api/mcp" en http_headers = { "Authorization" = "Bearer <sleutel>" }
claude.ai en Claude DesktopCustomize, Connectors, Add custom connector. Vul het adres in, kies No sign-in en zet onder Request headers de kop authorization met de waarde Bearer <sleutel>

De werkruimte volgt uit de sleutel en is nooit invoer van een stuk gereedschap. Dat is geen detail: was hij invoer, dan is er een vraag te stellen die de gegevens van een andere klant oplevert. Een sleutel hoort bij één werkruimte.

Wat nog niet vanzelf werkt

Wat je ermee kunt

De volledige lijst staat in het gereedschap, en die lijst wordt uitgerekend uit de server en niet opgeschreven. Per onderdeel:

OnderdeelGereedschap
Vragen en opzoekendenkploeg_vraag (een vraag aan de regisseur, met hetzelfde antwoord als in de chat), denkploeg_werkruimte, denkploeg_te_tekenen, denkploeg_kosten, denkploeg_recent_werk
Marketingmarketing_campagnes, marketing_besteding, marketing_killregels, marketing_marge. Alleen lezen. Zie Marketing Studio.
Commercecommerce_winkel, commerce_product. Alleen lezen. Zie Commerce Studio.
Supportsupport_onbeantwoord, support_gesprekken. Alleen lezen. Een assistent instellen kan alleen in de portal. Zie Support Studio.
CreativeCampagnes, advertenties, assets, producten en modellen opzoeken (creative_list_*, creative_get_*), een beeld of video laten maken (creative_generate_image, creative_generate_video), een kostenraming vooraf (creative_estimate_*), avatars en UGC-projecten, een campagne aanmaken (creative_create_campaign).
VideoVideo's lezen, bewerken, controleren en renderen (video_list, video_get, video_edit, video_check, video_render), ondertitels (video_transcribe), stemmen en voice-over (video_stemmen, video_voiceover). Zie Video Studio.
DesignEen ontwerp of website controleren (design_check en design_check_rapport), merkregels en tokens lezen en exporteren, een merk laten inlezen of de brandguide maken (design_merk), een logo of beeld bijwerken (design_logo_opzet, design_beeld). Zie Brand Studio.

Welk merk

Heb je meerdere merken in je werkruimte, dan kun je bij de merkgereedschappen van Design (design_check, design_merkregels, design_tokens_check, design_merk, design_tokens_export, design_logo_opzet) optioneel merk meegeven, als naam of id. Zonder merk geldt je eigen merk. Een onbekend of dubbelzinnig merk geeft een fout in plaats van stil bij een ander merk te landen. Een gereedschap dat je merken opsomt, of een merkkeuze bij creative_create_campaign, creative_generate_image en video_voiceover, is er nog niet. Zie Eigen merk en klantmerken.

Betaald werk

Alles wat geld kost, zoals een beeld, een video, een logo of een voice-over, wordt via MCP een openstaande goedkeuring die een mens in de portal tekent. Er gebeurt niets tot iemand klikt. Vraag daarom eerst een raming (creative_estimate_*) als je wilt weten wat iets gaat kosten. Het dag- en maandplafond van je werkruimte blijft gelden.

Zo gaat dat in een client
Jij

Maak een beeld voor de najaarscampagne.

Regisseur

Ik heb het aangevraagd. Het kost geld, dus het staat nu als openstaande goedkeuring. Er gebeurt niets tot iemand in de portal tekent.

Jij

Wat gaat dat kosten?

Regisseur

Dat zie je vooraf met een raming (creative_estimate_*). Het dag- en maandplafond van je werkruimte blijft gelden.

De rem

Per sleutel, per minuut:

opzoekverzoeken
120
vragen aan de regisseur
6

Wat er nooit gebeurt

  • Tekenen. Geen enkel gereedschap kan een goedkeuring afgeven. Zet een client iets in gang dat naar buiten werkt, dan komt er een kaartje met twee knoppen bij een mens en gebeurt er niets tot iemand klikt.
  • Over de grens van een werkruimte kijken. Elke aanroep draagt de werkruimte uit de omgeving mee. Een id van een andere klant levert een 404 op en geen 403: het bestaan ervan is zelf al iets dat we niet bevestigen.
  • Een sleutel doorgeven. Wat een werkruimte aan koppelingen heeft staat versleuteld, en gaat alleen naar de server die hem nodig heeft.