Kort antwoord: Voer eenmalig de admin-consent uit (Entra Global Admin), maak een OAuth client registration aan in de Teams Developer Portal met de waarden uit de MCP-adminpagina, en zet vervolgens een custom MCP-connector op in het Microsoft 365 admin center. Dit vereist een betaalde Microsoft 365 Copilot-licentie of pay-as-you-go — de gratis Copilot Chat en Copilot Pro werken niet of enkel beperkt.
⚠️ Dit is een taak voor uw Microsoft 365-beheerder, geen instelling die u als individuele gebruiker zelf aanzet.
Welke Copilot heb je nodig? #
| Licentie | Custom MCP-connector? |
|---|---|
| Consumenten-Copilot / Copilot Pro | ❌ Ondersteunt geen custom connectors |
| Microsoft 365 Copilot Chat (gratis) | ⚠️ Connector-acties worden per gebruik afgerekend (pay-as-you-go) |
| Microsoft 365 Copilot (betaald) | ✅ Inbegrepen, geen extra afrekening |
Stap voor stap #
1. Admin-consent #
Voer eenmalig de admin-consent uit via de MCP-adminpagina. Hiervoor is een Entra Global Admin nodig.
2. OAuth-clientregistratie in de Teams Developer Portal #
Ga naar dev.teams.microsoft.com/tools, en maak een OAuth client registration aan. Neem de basis-URL, de client-id, het per-installatie-secret, de authorization-, token- en refresh-endpoints, en de scope over uit het connector-blok op de MCP-adminpagina; PKCE mag uit. U krijgt een registratie- of reference-id terug.
⚠️ Kies het juiste type: neem een OAuth client registration, niet een “Entra SSO client ID registration.” De SSO-variant maakt een aparte app-identiteit aan, waardoor de handshake ná het inloggen mislukt en de connector weer verdwijnt.
3. Custom MCP-connector in het M365 admin center #
Ga naar admin.cloud.microsoft > Copilot > Connectors, en maak een custom MCP-connector: een naam, de MCP-endpoint-URL (uw host + /ciceroMCP), en als authenticatie OAuth 2.0 met de reference-id uit stap 2.
4. Publiceren #
Publiceer de connector, eventueel eerst gefaseerd naar een testgroep.
5. Verbinden & gebruiken #
De gebruiker koppelt de connector, en meldt zich via OAuth aan. Bij de gratis Copilot Chat is pay-as-you-go of een betaalde licentie nodig om de acties ook echt te laten uitvoeren.
De exacte, ingevulde waarden en stap-voor-stap-schermen staan in de installatiegids op de MCP-adminpagina zelf (knop “Microsoft Copilot”).
