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/v2krijgt404endpoint-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
404met 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
403insufficient-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. 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) laat weg wat je organisatie niet heeft. Hoe de gegevens samenhangen (Engels) 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, 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.