# Voor beheerders Zet MCP en de REST API aan of uit voor je organisatie, en bepaal wie API-tokens mag aanmaken en apps mag koppelen. Deze pagina is voor wie je plnnrly-organisatie beheert. Wil iemand alleen een AI-assistent koppelen of de API aanroepen, dan moet jij dat misschien eerst aanzetten. ## De pagina MCP & API De schakelaars staan in plnnrly onder **Instellingen › Beheer › MCP & API**. Twee rechten bepalen wie de pagina kan gebruiken: - Met **MCP & API bekijken** kan iemand de pagina openen en zien welke schakelaars aanstaan. - Met **MCP & API beheren** kan iemand de schakelaars ook omzetten. Zolang je organisatie is opgeschort, kan er op de pagina niets worden gewijzigd. ## De drie schakelaars | Schakelaar | Standaard | Wat hij doet | | -------------------------------- | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **REST API inschakelen** | Aan | Mensen kunnen de REST API aanroepen met hun eigen API-tokens, en apps kunnen hen via OAuth laten inloggen. | | **MCP inschakelen** | Uit in een nieuwe organisatie | Mensen kunnen een AI-assistent, zoals Claude of ChatGPT, koppelen door in te loggen. De assistent werkt via de REST API, namens de persoon die hem heeft gekoppeld. | | **Destructieve acties toestaan** | Uit | Een gekoppelde AI-assistent kan alles verwijderen wat de REST API kan verwijderen, binnen de rechten van de persoon zelf en pas nadat die het heeft bevestigd. Zolang deze schakelaar uitstaat, kan een assistent lezen, aanmaken en wijzigen, maar niet verwijderen. | Hoe de schakelaars van elkaar afhangen: - **MCP inschakelen** kan alleen aan zolang **REST API inschakelen** aanstaat, omdat AI-assistenten via de REST API werken. - Zet je MCP uit, dan gaat **Destructieve acties toestaan** ook uit. Zet je MCP later weer aan, dan gaat die schakelaar niet vanzelf mee aan. - **Destructieve acties toestaan** geldt alleen voor AI-assistenten. Een persoonlijk API-token met **Verwijderen** als tokenrecht kan alles verwijderen wat de eigenaar mag verwijderen, hoe deze schakelaar ook staat. Apps die na inloggen via OAuth de REST API aanroepen, kunnen daarmee nooit iets verwijderen. Voor het koppelen van een AI-assistent is geen extra recht nodig. Zolang MCP aanstaat, ziet iedereen in de organisatie het **AI**-paneel (het sterretjesicoon in de bovenbalk) en kan iedereen een assistent koppelen. De assistent kan alleen wat het account van die persoon kan. ## Wat er gebeurt als een schakelaar uitstaat ### REST API uit - Elk verzoek aan `/api/v2` krijgt `404` [endpoint-not-found](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#endpoint-not-found) met de melding "The REST API is not enabled for this organisation.", ook een verzoek met een token dat al bestaat. - Apps kunnen mensen niet meer via OAuth laten inloggen. - **API-toegang** verdwijnt uit het gebruikersmenu, dus niemand kan nog tokens aanmaken, vernieuwen of intrekken. - MCP gaat ook uit. Zet je de REST API weer aan, dan gaat MCP niet vanzelf weer aan. - Bestaande tokens blijven bewaard. Ze werken weer zodra de REST API aanstaat, tenzij ze intussen zijn verlopen. ### MCP uit - Gekoppelde AI-assistenten krijgen `404` met de melding "The MCP server is not enabled for this organisation." - Geen enkele AI-assistent kan nog inloggen om te koppelen. - Het **AI**-paneel verdwijnt uit de bovenbalk. ## Wie tokens mag aanmaken en apps mag koppelen Het recht heet **API-tokens beheren**. Wie het heeft, kan: - **API-toegang** openen in het gebruikersmenu, en eigen API-tokens aanmaken, vernieuwen en intrekken - een app aan de REST API koppelen door via OAuth in te loggen In een nieuwe organisatie heeft de rol **Admin** dit recht vanaf het begin. Wil je het aan een andere rol geven, open die rol dan onder **HRM › Gebruikersbeheer › Rollen**, ga naar het tabblad **Instellingen** en selecteer **API-tokens beheren** in de groep **API-tokens**. Neem je het recht weer af, dan gebeurt dit: - Apps die de persoon via OAuth aan de REST API heeft gekoppeld, worden direct geweigerd, met `403` [insufficient-permission](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#insufficient-permission). - De persoonlijke API-tokens van die persoon blijven werken tot ze verlopen. De persoon kan **API-toegang** niet meer openen, en die tokens dus ook niet meer zien, vernieuwen of intrekken. ## Onderdelen die je organisatie niet gebruikt Facturatie en sprints zijn optionele onderdelen van plnnrly. Zonder facturatie krijgt elke operatie voor facturatie `404` [endpoint-not-found](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#endpoint-not-found). Zonder sprints krijgen ook de operaties voor workflows, workflowstatussen, workflowovergangen, werktypen en labels `404`. Sprints en werkitems zelf zijn altijd beschikbaar. Het [discovery-verzoek (Engels)](https://developers.plnnrly.com/en/docs/api/v2/discovery/) laat weg wat je organisatie niet heeft. [Hoe de gegevens samenhangen (Engels)](https://developers.plnnrly.com/en/docs/api/v2/guides/data-model/#optional-areas) somt per onderdeel de resources op. ## Je eigen domein Gebruikt je organisatie een eigen domein, gebruik dan precies dat domein voor de REST API en voor MCP. Op elk ander adres antwoordt de REST API met `404`. In plnnrly toont het **AI**-paneel de server-URL van MCP op je eigen domein, en toont **API-toegang** in het gebruikersmenu de basis-URL van de REST API. ## Als plnnrly niet beschikbaar is Zolang een organisatie wordt ingericht, is opgeschort of is gearchiveerd, antwoordt de REST API met `503` [tenant-unavailable](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#tenant-unavailable), en de MCP-server ook met `503`. Beide werken weer zodra de organisatie actief is. Duurt het langer, neem dan contact op met de [support van plnnrly](https://www.plnnrly.com/nl/support). ## Zie ook - [Overzicht MCP](https://developers.plnnrly.com/nl/docs/mcp/) - [Rechten en veiligheid](https://developers.plnnrly.com/nl/docs/mcp/permissions-and-safety/) - [API-tokens (Engels)](https://developers.plnnrly.com/en/docs/api/v2/guides/tokens/) - [Authenticatie (Engels)](https://developers.plnnrly.com/en/docs/api/v2/guides/authentication/)