Overzicht MCP

Overzicht MCP

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

Bekijken als Markdown

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 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.

Kies je client

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.
Volledige handleiding voor claude.ai

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.
Volledige handleiding voor Claude Desktop

Voer dit uit in je terminal en log daarna in met claude mcp login plnnrly.

Terminal
claude mcp add --transport http plnnrly https://<jouw-url>/mcp/v1
Volledige handleiding voor Claude Code

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.
Volledige handleiding voor ChatGPT

Zet deze regels in ~/.cursor/mcp.json. Cursor vraagt je in te loggen bij plnnrly zodra hij verbinding maakt.

~/.cursor/mcp.json
{
  "mcpServers": {
    "plnnrly": {
      "url": "https://<jouw-url>/mcp/v1"
    }
  }
}
Volledige handleiding voor Cursor

Voer dit uit in je terminal, start gemini en log in met /mcp auth plnnrly.

Terminal
gemini mcp add --transport http --scope user plnnrly https://<jouw-url>/mcp/v1
Volledige handleiding voor Gemini
Andere clients