Een AI-agent koppelen via MCP

Laat je eigen AI-agent magazijnprocessen voor je bouwen. Picked heeft een MCP-server voor de procesbouwer: een agent leest de bouwstenen, zet een concept op, test het en publiceert het, met dezelfde controles als iemand die in de procesbouwer werkt.

Wanneer gebruik je dit

Gebruik dit recept als je werkt met een agent die MCP spreekt, zoals Claude Code, en je die processen wilt laten opzetten of aanpassen. Orders doorsturen of voorraad lezen doe je hier niet: dat gaat via de REST API, zoals in Orders doorsturen, met eigen tokens.

Je hebt een Professional- of Enterprise-abonnement nodig, en het recht om processen te bewerken in je werkruimte.

Maak een token aan

Open in Picked Instellingen → AI-agenttoegang en geef een token uit. Geef het een naam waaraan je ziet welke agent het gebruikt. Het token werkt alleen voor deze werkruimte en alleen voor de procesbouwer-tools. Picked toont het geheim één keer: bewaar het in je secret manager, nooit in code of in een chat.

Een API-token uit Instellingen → API-tokens werkt hier niet, en een agent-token werkt niet op de REST API.

Koppel de agent

Het snelst: kopieer op dezelfde pagina de regel onder Onboard je agent en plak die in je agent. Er staat:

Fetch https://picked.nl/mcp/prompt.md

De agent haalt de instructies van Picked op en richt zichzelf in. Om het token vraagt hij jou.

Koppel je een client liever zelf:


Endpoint	`https://picked.nl/mcp/process-builder`
Transport	Streamable HTTP
Authenticatie	`Authorization: Bearer` gevolgd door het token
Rate limit	Per token: 60 aanroepen per minuut bij Professional, 240 bij Enterprise

Bijvoorbeeld in Claude Code:

claude mcp add --transport http picked https://picked.nl/mcp/process-builder \
  --header "Authorization: Bearer $PICKED_MCP_TOKEN"

Wat de agent kan

Tool	Wat het doet
`list_nodes`	Somt alle bouwstenen van een proces op, met de instellingen die elk ervan neemt.
`get_node_schema`	Beschrijft één bouwsteen.
`create_process`	Zet een nieuw proces op als concept.
`edit_process`	Past een concept aan.
`simulate_process`	Draait een concept proef zonder het magazijn te raken.
`publish_version`	Maakt een getest concept de live versie.
`rollback_version`	Haalt een versie terug die eerder live was.
`query_event_store`	Leest de gebeurtenissen van je werkruimte, om te zien wat er op de vloer gebeurde.

De agent werkt in een lus: bouwstenen lezen, concept opzetten, proefdraaien, herstellen aan de hand van wat de controles zeggen, en publiceren.

Zo blijft je magazijn veilig

Eerst een concept. Opzetten en aanpassen veranderen het live proces nooit. Alleen publish_version en rollback_version doen dat, en een rollback haalt alleen een versie terug die eerder live was.
Testen vóór publiceren. publish_version vraagt om een recente geslaagde simulatie van precies dat concept, door hetzelfde token.
Dezelfde controles als in de procesbouwer. Een agent kan geen proces opslaan dat een mens niet kon opslaan.
Alles wordt vastgelegd. Elke aanroep van een tool wordt in je werkruimte gelogd onder het token dat hem deed.
Jij houdt de regie. Trek je het token in op Instellingen → AI-agenttoegang, dan stopt de agent meteen.

Fouten afhandelen

Status	Wat je doet
`401`	Het token ontbreekt, klopt niet of is ingetrokken.
`403`	Het token is geen agent-token, of de werkruimte heeft geen Professional- of Enterprise-abonnement.
`429`	Wacht het aantal seconden uit `Retry-After`.

Weigert een tool een concept, dan staat de reden in het resultaat. Een goede agent leest die en herstelt het concept.