plnnrlydevelopers

Ihr KI-Client, angemeldet als Sie.

Verbinden Sie Claude, ChatGPT, Cursor oder Gemini mit Ihrer plnnrly-Organisation, oder rufen Sie die REST-API aus Ihrem eigenen Code auf. Beides handelt in Ihrem Namen, mit Ihren Rechten.

Sie bauen eine Integration? Beginnen Sie mit der REST-API

https:///mcp/v1

Geben Sie die Adresse ein, unter der Sie sich bei plnnrly anmelden, zum Beispiel acme.plnnrly.com. Der KI-Bereich in plnnrly (das Funkel-Symbol in der oberen Leiste) zeigt die genaue URL.

Wo finde ich meine URL?

Geben Sie die Adresse ein, unter der Sie sich bei plnnrly anmelden, zum Beispiel acme.plnnrly.com. Der KI-Bereich in plnnrly (das Funkel-Symbol in der oberen Leiste) zeigt die genaue URL.

Fügen Sie sie dann Ihrem Client hinzu

Ein benutzerdefinierter Connector in Ihrem Claude-Konto. Er funktioniert danach auch in Claude Desktop und den mobilen Apps.

  1. Öffnen Sie in Claude Customize › Connectors und wählen Sie Add custom connector.
  2. Geben Sie plnnrly als Namen ein und fügen Sie die Server-URL ein.
  3. Klicken Sie auf Add, melden Sie sich bei plnnrly an und klicken Sie auf Freigeben.
Vollständige Anleitung für claude.ai

Derselbe Connector wie auf claude.ai. Haben Sie ihn dort hinzugefügt, ist er hier schon vorhanden.

  1. Öffnen Sie in Claude Desktop Customize › Connectors und wählen Sie Add custom connector.
  2. Geben Sie plnnrly als Namen ein und fügen Sie die Server-URL ein.
  3. Klicken Sie auf Add. Ein plnnrly-Fenster öffnet sich in Ihrem Browser: Melden Sie sich an und klicken Sie auf Freigeben.
Vollständige Anleitung für Claude Desktop

Führen Sie dies im Terminal aus und melden Sie sich dann mit claude mcp login plnnrly an.

Terminal
claude mcp add --transport http plnnrly https://<ihre-url>/mcp/v1
Vollständige Anleitung für Claude Code

ChatGPT im Web fügt plnnrly als eigenen MCP-Server hinzu.

  1. Öffnen Sie chatgpt.com/plugins und wählen Sie + und dann Add custom MCP server.
  2. Fügen Sie die Server-URL unter Connection ein und wählen Sie OAuth.
  3. Erstellen und installieren Sie das Plugin. Melden Sie sich dann bei plnnrly an und klicken Sie auf Freigeben.
Vollständige Anleitung für ChatGPT

Tragen Sie dies in ~/.cursor/mcp.json ein. Cursor bittet Sie um die Anmeldung bei plnnrly, sobald es sich verbindet.

~/.cursor/mcp.json
{
  "mcpServers": {
    "plnnrly": {
      "url": "https://<ihre-url>/mcp/v1"
    }
  }
}
Vollständige Anleitung für Cursor

Führen Sie dies im Terminal aus, starten Sie gemini und melden Sie sich mit /mcp auth plnnrly an.

Terminal
gemini mcp add --transport http --scope user plnnrly https://<ihre-url>/mcp/v1
Vollständige Anleitung für Gemini
Andere Clients

Was passiert, wenn Sie fragen

Sie fragen

Welche meiner Arbeitselemente sind noch offen?

Tool
api_read
Anfrage
GET /work-itemsfilter[assignee_id]=mefilter[resolved]=false
Geprüft
Antwort
200 OKIhre offenen Arbeitselemente, Seite für Seite

Dieselben Prüfungen wie bei der REST-API. Ein Client tut nie mehr, als Sie dürfen.

Was der Server kann

Es gibt kein Tool pro Funktion: Ein Client sucht die Operation, die er braucht, liest, was sie annimmt, und ruft sie in Ihrem Namen auf. Alles außer Datei-Uploads ist erreichbar.

  • search_api

    Findet die API-Operation für eine Aufgabe und zeigt, was sie annimmt.

    Liest die Dokumentation, nicht Ihre Daten

  • api_read

    Liest alles, was die REST-API lesen kann.

    Ihre Leserechte

  • api_write

    Legt Daten an und ändert sie. Löscht nur, wenn Ihre Organisation es erlaubt und Sie bestätigen.

    Ihre Schreibrechte; fragt vor dem Löschen

  • get-current-user-tool

    Gibt Ihr eigenes Profil zurück.

    Ihr eigenes Profil

So funktionieren die Tools

Bevor Sie verbinden

Bei neuen Organisationen ist MCP ausgeschaltet. Ein Administrator schaltet es ein, und es funktioniert nur, solange die REST-API eingeschaltet ist.

EinstellungStandardWas sie bewirkt
REST-API aktivierenAnErlaubt Personen, die REST-API mit ihren eigenen API-Tokens aufzurufen, und Apps, sie per OAuth anzumelden.
MCP aktivierenAusErlaubt Personen, einen KI-Client wie Claude oder ChatGPT per Anmeldung zu verbinden. Der Client arbeitet über die REST-API, im Namen der Person, die ihn verbunden hat.Braucht REST-API aktivieren.
Destruktive Aktionen erlaubenAusErlaubt einem verbundenen KI-Client zu löschen, was die REST-API löschen kann, im Rahmen der Rechte der Person und erst nach ihrer Bestätigung.Braucht MCP aktivieren.

Einstellungen › Verwaltung › MCP & API

Für Administratoren

Lieber Code?

Die REST-API liest und ändert Projekte, Arbeitselemente, Stunden, Drive-Dokumente, Kunden, Rechnungen, Abwesenheiten und Planung. Jede Operation nennt die Token-Berechtigung und das Recht, die sie braucht.

  1. Token erstellen: Benutzermenü › API-Zugang › Token erstellen.
  2. Ihre Basis-URL ist https://<ihre-url>/api/v2/.
  3. Erster Aufruf: GET /api/v2/ zeigt, was Ihre Organisation anbietet.

Ihr erster API-Aufruf (Englisch)

Die Referenz umfasst 228 Operationen und wird bei jeder Version aus dem Code von plnnrly erzeugt.

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

Anleitungen

Einstieg

Mit Daten arbeiten

Wenn etwas schiefgeht

  • Fehlerbehebung

    Wenn sich ein Client nicht verbindet, nicht anmelden kann oder eine Anfrage abgelehnt wird.

  • Errors and retries (Englisch)

    Jeder Fehler ist ein Problem-Dokument. Entscheiden Sie nach seinem Typ, nicht nur nach dem Statuscode.

  • Rate limits (Englisch)

    Was jede Anfrage kostet, und die Header, die zeigen, wie viel übrig ist.