Pluvo koppelen aan Microsoft Copilot Studio

Met het Model Context Protocol (MCP) koppel je je Pluvo-academie aan een agent in Microsoft Copilot Studio. Je agent kan dan direct Pluvo-acties uitvoeren, zoals vragen aanmaken of voorwaarden instellen. De koppeling gebruikt OAuth 2.0 voor veilige toegang.

Dit artikel loopt stap voor stap met je mee.

Wat je nodig hebt

Toegang tot Microsoft Copilot Studio
De URL van je Pluvo-academie — meestal https://[jouwacademie].pluvo.com, of je eigen domein als je academie daarop draait (bijv. https://academie.jouwbedrijf.nl). In de voorbeelden hieronder staat https://[jouwacademie].pluvo.com; vervang dat overal door je eigen academie-URL. De paden erachter (/mcp, /oauth/authorize/, /oauth/token/, /oauth/register/) blijven hetzelfde.
Een Pluvo-account om mee in te loggen
Een terminal voor één commando (stap 6)

De truc om maar één keer te registreren: de unieke Redirect URL verschijnt pas nadat je de koppeling hebt opgeslagen — maar Client ID en Client secret zijn verplicht om te kúnnen opslaan. Daarom vul je die eerst tijdelijk met temp, sla je op, en registreer je dáárna de echte client met de gegenereerde Redirect URL. Zo voorkom je een "redirect mismatch".

Stap 1: Nieuwe tool aanmaken

Ga in Copilot Studio links naar Tools en klik op + New tool.

Stap 2: Kies Model Context Protocol + OAuth 2.0 (Manual)

Kies Model Context Protocol. In het dialoog zet je Authentication op OAuth 2.0 en Type op Manual.

Stap 3: Velden invullen

Veld	Waarde
Server name	Pluvo Staging (vrij te kiezen)
Server description	Pluvo MCP – staging omgeving (vrij te kiezen)
Server URL	`https://[jouwacademie].pluvo.com/mcp` ⚠️ géén `/` op het eind
Client ID	`temp` (tijdelijk — stap 7)
Client secret	`temp` (tijdelijk)
Authorization URL	`https://[jouwacademie].pluvo.com/oauth/authorize/`
Token URL template	`https://[jouwacademie].pluvo.com/oauth/token/`
Refresh URL	`https://[jouwacademie].pluvo.com/oauth/token/`
Scopes	`mcp`
Redirect URL	leeg laten — komt na opslaan

Let op de slash op het eind van /authorize/ en /token/ — die is verplicht. Wacht tot de melding "Enter the complete server path to continue" bij de Server URL verdwijnt.

Klik daarna op Create.

Stap 4: De connector is aangemaakt

De koppeling verschijnt nu in je Tools-lijst als Custom Connector met status Ready.

Stap 5: Redirect URL kopiëren

Open de connector (je komt in de custom connector-editor, tab Security). Onderaan staat nu de gegenereerde Redirect URL met een uniek staartje. Klik op het kopieer-icoon en bewaar 'm.

Stap 6: OAuth-client registreren (één keer)

Registreer bij Pluvo een client met precies díe Redirect URL. Draai dit in een terminal (vervang [jouwacademie] door je academienaam en plak je Redirect URL bij redirect_uris):

curl -sS -X POST https://[jouwacademie].pluvo.com/oauth/register/ \
  -H 'Content-Type: application/json' \
  -d '{
    "client_name": "Copilot Studio MCP",
    "redirect_uris": ["PLAK-HIER-JE-REDIRECT-URL"],
    "grant_types": ["authorization_code","refresh_token"],
    "response_types": ["code"],
    "token_endpoint_auth_method": "client_secret_post",
    "scope": "mcp"
  }'

Je krijgt een client_id en client_secret terug. Bewaar deze.

Stap 7: Echte Client ID en secret invullen

Vervang in de Security-tab de tijdelijke temp-waarden door de echte Client ID en Client secret uit stap 6. De rest (URL's + scope mcp) laat je staan. Klik rechtsboven op Update connector.

Stap 8: Tool toevoegen aan je agent

Ga terug naar Copilot Studio → Agents → open (of maak) je agent → tab Tools → Add a tool. Zoek op de naam, filter eventueel op Model Context Protocol, en kies Pluvo Staging.

Stap 9: Verbinding maken en inloggen

Bij Connection staat eerst "Not connected". Klik op Create new connection. Er opent een Pluvo-venster — klik op Autoriseren en log in met je Pluvo-account. Daarna staat de verbinding op groen.

Stap 10: Klaar — de Pluvo-tools verschijnen

De MCP-server is gekoppeld. Onder Tools zie je nu de beschikbare Pluvo-acties (zoals get_conditions, set_conditions, create_question, …). Test je agent met een prompt die een tool gebruikt. 🎉

Tip: bewaar je client_id en client_secret veilig. Wil je de koppeling intrekken? Verwijder dan de connector en de bijbehorende OAuth-client.

Bijgewerkt op: 12/06/2026

Was dit artikel nuttig?

Dankuwel!