plnnrlydevelopers

Je AI-client, ingelogd als jij.

Koppel Claude, ChatGPT, Cursor of Gemini aan je plnnrly-organisatie, of roep de REST API aan vanuit je eigen code. Beide handelen namens jou, met jouw rechten.

Bouw je een koppeling? Begin met de REST API

https:///mcp/v1

Typ het adres waarop je in plnnrly inlogt, zoals acme.plnnrly.com. Het AI-paneel in plnnrly (het sterretjesicoon in de bovenbalk) toont de exacte URL.

Waar vind ik mijn URL?

Typ het adres waarop je in plnnrly inlogt, zoals acme.plnnrly.com. Het AI-paneel in plnnrly (het sterretjesicoon in de bovenbalk) toont de exacte URL.

Voeg hem daarna toe aan 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

Wat er gebeurt als je iets vraagt

Je vraagt

Welke van mijn werkitems staan nog open?

Tool
api_read
Verzoek
GET /work-itemsfilter[assignee_id]=mefilter[resolved]=false
Gecontroleerd
Antwoord
200 OKJe openstaande werkitems, pagina voor pagina

Dezelfde controles als de REST API. Een client doet nooit meer dan jij kunt.

Wat de server kan

Er is geen tool per functie: een client zoekt de operatie die hij nodig heeft, leest wat die accepteert en voert die uit namens jou. Alles behalve bestanden uploaden is bereikbaar.

  • search_api

    Zoekt de API-operatie voor een taak en laat zien wat die accepteert.

    Leest de documentatie, niet je gegevens

  • api_read

    Leest alles wat de REST API kan lezen.

    Jouw leesrechten

  • api_write

    Maakt gegevens aan en wijzigt ze. Verwijdert alleen als je organisatie dat toestaat en jij het bevestigt.

    Jouw schrijfrechten; vraagt het eerst voor hij verwijdert

  • get-current-user-tool

    Geeft je eigen profiel terug.

    Je eigen profiel

Zo werken de tools

Voordat je koppelt

Voor nieuwe organisaties staat MCP uit. Een beheerder zet het aan, en het werkt alleen zolang de REST API aanstaat.

InstellingStandaardWat het doet
REST API inschakelenAanLaat mensen de REST API aanroepen met hun eigen API-tokens, en laat apps hen inloggen via OAuth.
MCP inschakelenUitLaat mensen een AI-client, zoals Claude of ChatGPT, koppelen door in te loggen. De client werkt via de REST API, namens wie hem koppelde.Vereist REST API inschakelen.
Destructieve acties toestaanUitLaat een gekoppelde AI-client verwijderen wat de REST API kan verwijderen, binnen de eigen rechten van die persoon en pas nadat die het bevestigt.Vereist MCP inschakelen.

Instellingen › Beheer › MCP & API

Voor beheerders

Liever code?

De REST API leest en wijzigt projecten, werkitems, uren, Drive-documenten, klanten, facturen, verlof en planning. Bij elke operatie staat welke tokenrechten en welk recht ervoor nodig zijn.

  1. Maak een token aan: gebruikersmenu › API-toegang › Token aanmaken.
  2. Je basis-URL is https://<jouw-url>/api/v2/.
  3. Doe je eerste aanroep: GET /api/v2/ laat zien wat je organisatie aanbiedt.

Je eerste API-aanroep (Engels)

De referentie beschrijft 228 operaties en wordt bij elke release uit de code van plnnrly gegenereerd.

Terminal
curl https://<jouw-url>/api/v2/ \
  -H "Authorization: Bearer <token>"

Handleidingen

Beginnen

Werken met gegevens

Als er iets misgaat