# Overzicht MCP

Hoe je een AI-assistent zoals Claude of ChatGPT aan je plnnrly-organisatie koppelt, en wat hij daarna kan.

plnnrly heeft een MCP-server (Model Context Protocol). Koppel je er een AI-assistent aan, dan kan die gegevens in je organisatie voor je lezen en wijzigen. Hij handelt namens jou: hij kan zien en wijzigen wat jouw account kan, en niets meer.

## Voordat je begint

Een beheerder zet MCP aan onder **Instellingen › Beheer › MCP & API**. Voor het openen van die pagina is het recht **MCP & API bekijken** nodig, en voor het wijzigen **MCP & API beheren**. Voor nieuwe organisaties staat MCP uit, en het werkt alleen zolang de REST API aanstaat; [Voor beheerders](https://developers.plnnrly.com/nl/docs/administration/) legt de schakelaars uit.

## Verbindingsgegevens

- Server-URL: `https://<jouw-url>/mcp/v1`
- Transport: HTTP (streamable)
- Authenticatie: Inloggen (OAuth)

`<jouw-url>` is het adres waarop je in plnnrly inlogt, bijvoorbeeld `acme.plnnrly.com`, of het eigen domein van je organisatie. Het **AI**-paneel (het sterretjesicoon in de bovenbalk) toont de exacte server-URL voor je organisatie. Het paneel verschijnt zodra MCP aanstaat.

## Zo werkt koppelen

Je voegt de server-URL toe aan je AI-client. De client opent plnnrly in je browser, waar je zo nodig inlogt en de koppeling goedkeurt. Er is geen token om te kopiëren.

Het goedkeuringsscherm toont:

- als wie je bent ingelogd
- waar de app om vraagt, zoals **De MCP-server gebruiken (AI-assistenten)**
- een waarschuwing als je organisatie destructieve acties toestaat, omdat de app dan ook records kan verwijderen
- het adres waarnaar je na het goedkeuren wordt teruggestuurd
- **Goedkeuren** en **Annuleren**

Vanuit een supportsessie kun je geen app koppelen. Log in als jezelf.

Na het koppelen vernieuwt de client zijn toegang elk uur zelf. Een client die je 30 dagen niet hebt gebruikt, moet opnieuw inloggen.

Heb je een client al met een persoonlijk MCP-token gekoppeld voordat inloggen mogelijk was? Dat token blijft werken. Je kunt het verwijderen in het **AI**-paneel onder **Persoonlijk toegangstoken**. Nieuwe persoonlijke MCP-tokens kun je niet meer aanmaken.

## Een app ontkoppelen

Onder **Gekoppelde apps** toont het **AI**-paneel de apps die je hebt gekoppeld. **Ontkoppelen** beëindigt de AI-verbinding van een app direct, en je kunt hem later opnieuw koppelen. Heeft de app bij hetzelfde inloggen ook toegang tot de REST API gekregen, dan stopt die toegang ook. Apps die alleen aan de REST API zijn gekoppeld, staan in plaats daarvan onder **API-toegang › Gekoppelde apps** in je gebruikersmenu.

Verwijder je plnnrly in de client, dan kan die client het niet meer gebruiken. De koppeling in plnnrly stopt daarmee niet altijd: de app kan tot 30 dagen na het laatste gebruik in de lijst blijven staan, tenzij de client de koppeling zelf heeft ingetrokken. Wil je zeker weten dat de koppeling weg is, gebruik dan **Ontkoppelen**.

## Wat een client kan

Een gekoppelde client bereikt elke operatie van de REST API, behalve bestanden uploaden, altijd namens jou en binnen jouw rechten. Hij kan alleen verwijderen als je organisatie dat toestaat en jij het bevestigt.

- [Wat je kunt vragen](https://developers.plnnrly.com/nl/docs/mcp/examples/) toont voorbeeldvragen per onderdeel.
- [Tools](https://developers.plnnrly.com/nl/docs/mcp/tools/) beschrijft de vier tools die een client gebruikt.
- [Rechten en veiligheid](https://developers.plnnrly.com/nl/docs/mcp/permissions-and-safety/) legt uit wat een client mag en hoe verwijderen op slot zit.

## Kies je client

- [claude.ai](https://developers.plnnrly.com/nl/docs/mcp/install/claude-ai/): Een aangepaste connector op je Claude-account. Daarna werkt hij ook in Claude Desktop en de mobiele apps.

  1. Open in Claude **Customize › Connectors** en kies **Add custom connector**.
  2. Vul `plnnrly` in als naam en plak de server-URL.
  3. Klik op **Add**, log in bij plnnrly en klik op **Goedkeuren**.

- [Claude Desktop](https://developers.plnnrly.com/nl/docs/mcp/install/claude-desktop/): Dezelfde connector als op claude.ai. Heb je hem daar toegevoegd, dan staat hij hier al.

  1. Open in Claude Desktop **Customize › Connectors** en kies **Add custom connector**.
  2. Vul `plnnrly` in als naam en plak de server-URL.
  3. Klik op **Add**. Er opent een plnnrly-venster in je browser: log in en klik op **Goedkeuren**.

- [Claude Code](https://developers.plnnrly.com/nl/docs/mcp/install/claude-code/): Voer dit uit in je terminal en log daarna in met `claude mcp login plnnrly`.

  ```bash
  claude mcp add --transport http plnnrly https://<jouw-url>/mcp/v1
  ```

- [ChatGPT](https://developers.plnnrly.com/nl/docs/mcp/install/chatgpt/): ChatGPT op het web voegt plnnrly toe als aangepaste MCP-server.

  1. Open chatgpt.com/plugins en kies **+** en daarna **Add custom MCP server**.
  2. Plak de server-URL onder **Connection** en kies **OAuth**.
  3. Maak de plugin aan en installeer hem. Log daarna in bij plnnrly en klik op **Goedkeuren**.

- [Cursor](https://developers.plnnrly.com/nl/docs/mcp/install/cursor/): Zet deze regels in `~/.cursor/mcp.json`. Cursor vraagt je in te loggen bij plnnrly zodra hij verbinding maakt.

  ```json
  {
    "mcpServers": {
      "plnnrly": {
        "url": "https://<jouw-url>/mcp/v1"
      }
    }
  }
  ```

- [Gemini](https://developers.plnnrly.com/nl/docs/mcp/install/gemini/): Voer dit uit in je terminal, start `gemini` en log in met `/mcp auth plnnrly`.

  ```bash
  gemini mcp add --transport http --scope user plnnrly https://<jouw-url>/mcp/v1
  ```

- [Andere clients](https://developers.plnnrly.com/nl/docs/mcp/install/other-clients/)