> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://helpdesk.pluvo.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15043_u6awdt.png) ## 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15054_4dpgcn.png) ## Stap 3: Velden invullen | Veld | Waarde | | ---- | | Server name | (vrij te kiezen) -> dit is de naam van jouw omgeving | | Server description | Pluvo MCP – 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15100_a17cxe.png) ## Stap 4: De connector is aangemaakt De koppeling verschijnt nu in je Tools-lijst als **Custom Connector** met status **Ready**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15103_1v9j10y.png) ## 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15104_5o24f2.png) ## 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`): ```bash 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15104_14c48mg.png) ## 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15141_9dcaq8.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15144_1c9bpe.png) ## 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15145_icianz.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15155_16rxvui.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15160_yzv55c.png) ## 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. 🎉 ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15162_1agmss0.png) | **Tip:** bewaar je `client_id` en `client_secret` veilig. Wil je de koppeling intrekken? Verwijder dan de connector en de bijbehorende OAuth-client.