Werken aan Boord / Documentatie

MCP voor jouw agent.

Laat een AI-assistent zoeken, voorstellen voorbereiden en eigen gegevens beheren.

Lees als Markdown ↗

Eén remote server

Transport: Streamable HTTP. De hele MCP-verbinding vereist OAuth, ook voor zoeken. REST-zoekacties blijven openbaar.

Gebruik een client met OAuth en CIMD. De server biedt geen anonieme MCP-verbinding of API-key-login.

Voorbeeld
https://werkenaanboord.nl/api/mcp

Beschikbare tools

Gebruik tools/list voor de actuele invoerschema’s. De taxonomie is ook beschikbaar als MCP-resource.

Zoekmeldingen wijzigen of verwijderen kan via REST. MCP biedt hiervoor nog geen tools.

ToolsDoel / scope
search_jobs · get_jobVacatures zoeken en lezen
find_available_workers · get_worker_profileBeschikbaarheid en profielen lezen
list_my_recordsEigen gegevens lezen
prepare_job · publish_jobVacature voorbereiden en publiceren / jobs:write
prepare_worker_availability · publish_worker_availabilityProfiel en beschikbaarheid publiceren / profile:write
update_job · pause_job · activate_job · close_job · delete_jobEigen vacatures beheren / jobs:write
update_worker · delete_worker · update_availability · delete_availabilityEigen profiel en beschikbaarheid beheren / profile:write
request_employer_verificationWerkgever controleren / jobs:write
request_bookingBoekingsverzoek / booking:write
watch_jobsZoekmelding opslaan / watches:write

Probeer een zoekopdracht

search_jobs vereist role. find_available_workers vereist role, needed_from en needed_to.

Voorbeeld
Zoek op Werken aan Boord naar werk voor een schipper. Toon de functie, werkgever, periode, het vaargebied en de bronlink. Vermeld ontbrekende gegevens.

Voorbereiden, tonen, bevestigen

prepare_job geeft draft_id, preview en expires_at terug. Toon de preview voordat je om akkoord vraagt.

publish_job gebruikt draft_id, confirmed: true en idempotency_key. Gebruik confirmed alleen na expliciet akkoord.

MCP geeft zowel leesbare tekst als structuredContent terug. Gebruik de vaste bronlinks uit het resultaat.

Voorbeeld
Bereid een vacature voor een afloskapitein voor. Vraag mij om de ontbrekende gegevens. Toon de volledige preview en publiceer pas na mijn akkoord.

Controleer de aansluiting

Een installatievoorbeeld is geen bewijs van een volledige productietest. De integratiepagina’s vermelden deze status.

  1. Rond de browserlogin af.
  2. Controleer of search_jobs zichtbaar is.
  3. Zoek een functie en open één resultaat.
  4. Maak een preview en controleer dat niets is gepubliceerd.
  5. Test schrijven alleen met je eigen gegevens en na akkoord.