# Problemen oplossen

Wat je doet als een AI-client geen verbinding krijgt met plnnrly, niet kan inloggen, of een verzoek geweigerd krijgt.

Zoek de melding of het gedrag dat je ziet, en volg de oplossing. Meldingen van plnnrly staan hier letterlijk, in het Engels. Een paar kunnen in een andere taal verschijnen, zoals het Nederlands of de taal waarin je plnnrly gebruikt; bij die meldingen staat de Nederlandse versie erbij.

## Koppelen en inloggen

| Wat je ziet                                                                                                                 | Waarom                                                                                                                     | Wat je doet                                                                                                                 |
| --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| "The MCP server is not enabled for this organisation." (`404`)                                                              | MCP staat uit voor je organisatie. Nieuwe organisaties beginnen met MCP uit. Zet je de REST API uit, dan gaat MCP ook uit. | Vraag een beheerder om het aan te zetten; zie [Voor beheerders](https://developers.plnnrly.com/nl/docs/administration/).    |
| "OAuth is not available for this organisation." (`404`) tijdens het inloggen                                                | De REST API staat uit, dus geen enkele app kan inloggen.                                                                   | Vraag het een beheerder; zie [Voor beheerders](https://developers.plnnrly.com/nl/docs/administration/).                     |
| De client vindt de server niet, of de inlogpagina geeft `404`                                                               | De server-URL klopt niet, of MCP staat uit.                                                                                | Kopieer de server-URL uit het **AI**-paneel (het sterretjesicoon in de bovenbalk). Ontbreekt het paneel, dan staat MCP uit. |
| De client meldt `invalid_redirect_uri`                                                                                      | De client kan nog niet inloggen bij plnnrly.                                                                               | Zie [Andere clients](https://developers.plnnrly.com/nl/docs/mcp/install/other-clients/).                                    |
| "Your role does not allow connecting apps to the REST API." of "Je rol staat niet toe dat je apps aan de REST API koppelt." | De app vroeg ook om toegang tot de REST API, en je rol mist **API-tokens beheren**.                                        | Vraag een beheerder om dat recht, of gebruik een client die alleen om MCP vraagt.                                           |
| Het inloggen wordt geweigerd (`403`) terwijl je in een supportsessie werkt                                                  | Vanuit een supportsessie kun je geen apps koppelen.                                                                        | Log in als jezelf.                                                                                                          |
| "This organization's access has been suspended." of "De toegang van deze organisatie is opgeschort." (`503`)                | Je organisatie is opgeschort.                                                                                              | Neem contact op met je beheerder.                                                                                           |
| "This organization is currently unavailable." of "Deze organisatie is momenteel niet beschikbaar." (`503`)                  | Je organisatie wordt ingericht, of is gearchiveerd.                                                                        | Neem contact op met je beheerder of met de [support van plnnrly](https://www.plnnrly.com/nl/support).                       |
| De client vraagt je opnieuw in te loggen                                                                                    | Hij is 30 dagen niet gebruikt, of iemand heeft hem ontkoppeld.                                                             | Log opnieuw in.                                                                                                             |

## De tools gebruiken

| Wat je ziet                                                                                                                 | Waarom                                                                                                         | Wat je doet                                                                                                                                            |
| --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| "Too Many Attempts." (`429`)                                                                                                | Je hebt meer dan 60 MCP-verzoeken in een minuut gestuurd, opgeteld over alle AI-clients die je hebt gekoppeld. | Wacht een minuut, en vraag daarna minder tegelijk.                                                                                                     |
| Het antwoord bevat `meta.mcp_truncated`                                                                                     | Het antwoord was langer dan de limiet van ongeveer 30.000 tekens en is ingekort.                               | Vraag om minder rijen, een gerichtere vraag of één veld. Zie [Antwoorden](https://developers.plnnrly.com/nl/docs/mcp/tools/#responses).                |
| Een verwijdering wordt geweigerd met `forbidden-by-policy` en "This organisation does not allow AI clients to delete data." | **Destructieve acties toestaan** staat uit voor je organisatie.                                                | Zie [Rechten en veiligheid](https://developers.plnnrly.com/nl/docs/mcp/permissions-and-safety/). Alleen een beheerder kan het aanzetten.               |
| Een wijziging wordt geweigerd met `forbidden-by-policy` en een andere melding                                               | Je rol, of het record zelf, staat deze wijziging niet toe. De melding zegt waarom.                             | Controleer in plnnrly of je de wijziging zelf kunt doen.                                                                                               |
| Een verwijdering of overschrijving wordt geweigerd met `validation-failed` op `confirm`                                     | Je hebt nog niet bevestigd.                                                                                    | Zeg tegen de assistent dat je akkoord bent, zodat hij de aanroep herhaalt met je bevestiging.                                                          |
| Een upload wordt geweigerd met `endpoint-not-found`                                                                         | Bestanden uploaden kan niet via MCP.                                                                           | Gebruik de REST API met een API-token; zie [Bestanden uploaden en downloaden (Engels)](https://developers.plnnrly.com/en/docs/api/v2/guides/uploads/). |
| Een record waarvan je weet dat het bestaat, geeft `404`                                                                     | Je mag het niet zien, of het hoort bij een onderdeel dat je organisatie niet gebruikt.                         | Controleer in plnnrly of je het kunt openen. De assistent ziet precies wat jij ziet.                                                                   |
| De app staat nog onder **Gekoppelde apps** nadat je hem in de client hebt verwijderd                                        | Zijn inlog blijft tot 30 dagen na het laatste gebruik geldig.                                                  | Klik op **Ontkoppelen** in het **AI**-paneel.                                                                                                          |

## De tools verschijnen niet

Controleer eerst de client zelf:

- **claude.ai en Claude Desktop:** klik in een chat op **+**, kies **Connectors** en controleer of plnnrly aanstaat; zie [claude.ai](https://developers.plnnrly.com/nl/docs/mcp/install/claude-ai/).
- **Claude Code:** voer `claude mcp list` uit, of `/mcp` in een sessie; zie [Claude Code](https://developers.plnnrly.com/nl/docs/mcp/install/claude-code/).
- **ChatGPT:** controleer of de plug-in is geïnstalleerd, typ dan `@` en kies plnnrly; zie [ChatGPT](https://developers.plnnrly.com/nl/docs/mcp/install/chatgpt/).
- **Cursor:** open het paneel **Output** en kies **MCP Logs**; zie [Cursor](https://developers.plnnrly.com/nl/docs/mcp/install/cursor/).
- **Gemini CLI:** voer `/mcp` uit in een sessie; zie [Gemini CLI](https://developers.plnnrly.com/nl/docs/mcp/install/gemini/).

## Kom je er niet uit?

Neem contact op met de [support van plnnrly](https://www.plnnrly.com/nl/support). Gaf plnnrly een foutmelding, vermeld dan de `request_id` daarvan.
