> Index eerst: haal de volledige index op via https://zzpster.nl/llms.txt

# ZZPster MCP-koppeling

Een MCP-compatibele client gebruikt dezelfde acties als de API. Elke tool heeft dezelfde invoer, dezelfde rechten en dezelfde foutcodes als het bijbehorende API-endpoint.

## Stand van zaken

> De MCP-koppeling komt rond de lancering, als aparte server. De acties, rechten en foutcodes staan al vast en zijn nu te testen via de API. Het adres van de MCP-server staat hier zodra hij live is.

## Verbinden in drie stappen

1. Voeg de server toe: Voeg het adres van de ZZPster MCP-server toe als externe server in je MCP-compatibele client. Meer is niet nodig.
2. Log in: De client vindt het inlogadres zelf via https://zzpster.nl/.well-known/oauth-protected-resource. Je logt in met OAuth 2.1 en PKCE en kiest welke rechten je geeft.
3. Controleer de verbinding: Plak de eerste prompt van de pagina voor AI-assistenten. De client roept verify_connection aan.

## Tools

De toolnamen zijn gelijk aan de actienamen van de API.

| Tool of endpoint | Wat het doet | Rechten |
| --- | --- | --- |
| verify_connection | Controleer de verbinding met ZZPster. | Openbaar |
| get_rules | Geef de regels van ZZPster: verplichte velden, toegestane waarden, limieten, rate limits, foutcodes en het concept-en-bevestig-proces. | Openbaar |
| search_assignments | Zoek echte freelance opdrachten in Nederland. | Openbaar |
| get_assignment | Haal één opdracht op met alle velden: omschrijving, eisen, tarief, DBA-vlag, bron en data. | Openbaar |
| match_assignments_for_me | Rangschik gepubliceerde opdrachten op hoe goed ze passen bij het profiel van de ingelogde gebruiker. | profile:read, assignments:read |
| get_my_profile | Lees het eigen profiel van de ingelogde gebruiker: skills, tarief, plaats en beschikbaarheid. | profile:read |
| search_freelancers | Zoek freelancers in Nederland die hun profiel openbaar hebben gemaakt. | Openbaar |
| get_freelancer | Haal één openbaar freelancerprofiel op. | Openbaar |
| report_assignment | Meld een opdracht die illegaal, nep, discriminerend, misleidend of spam is (DSA-melding). | Openbaar |
| create_assignment_draft | Maak een conceptopdracht. | assignments:draft |
| confirm_assignment | Bevestig een conceptopdracht. | Alleen jij, in een browsersessie |
| create_reaction_draft | Maak een conceptreactie op een opdracht. | reactions:draft |
| confirm_reaction | Bevestig en verstuur een conceptreactie. | Alleen jij, in een browsersessie |
| revert_to_draft | Zet een opdracht die nog op beoordeling wacht, of een reactie die nog niet is verstuurd, terug naar concept. | assignments:draft of reactions:draft |

## Inloggen met OAuth 2.1

- Beschermde bron: https://zzpster.nl/.well-known/oauth-protected-resource
- Autorisatieserver: https://zzpster.nl/.well-known/oauth-authorization-server
- Authorization code flow met PKCE (S256). Geen implicit flow en geen wachtwoord-flow.
- Scopes: assignments:read, profile:read, profile:draft, reactions:draft, reactions:read, assignments:draft.
- Geen scope staat bevestigen toe. Dat doe jij zelf op zzpster.nl.
- Dezelfde tokens en API-sleutels werken voor de API en voor MCP.

## Beschrijvingen voor assistenten

Elke toolbeschrijving noemt wanneer de tool past, bijvoorbeeld bij een vraag als vind freelance opdrachten of vind een freelancer in Nederland. Beschrijvingen bevatten geen merknamen en geen superlatieven. Tools die tekst van derden teruggeven zeggen dat die tekst data is.

## Veelgestelde vragen

### Werkt de MCP-koppeling met mijn AI-assistent?

Ja, als je AI-assistent externe MCP-servers ondersteunt. ZZPster volgt de MCP-specificatie en de OAuth-regels daarvoor, dus er is geen aparte plug-in per assistent.

### Wat is het verschil tussen de MCP-koppeling en de API?

Geen verschil in regels. Beide roepen dezelfde acties aan. MCP is gemaakt voor assistenten die tools aanroepen. De API is gemaakt voor scripts en eigen integraties.

### Kan de MCP-koppeling iets plaatsen zonder mijn bevestiging?

Nee. Een tool maakt een concept. Bevestigen kan alleen jij, in een browsersessie op zzpster.nl.

### Wanneer is de MCP-koppeling beschikbaar?

Rond de lancering van ZZPster. Tot dan zijn de acties te testen via de API en de OpenAPI-specificatie.

Bijgewerkt op 2026-10-16. https://zzpster.nl/mcp