# MCP-Übersicht

Wie Sie einen KI-Assistenten wie Claude oder ChatGPT mit Ihrer plnnrly-Organisation verbinden und was er danach kann.

plnnrly betreibt einen MCP-Server (Model Context Protocol). Wenn Sie einen KI-Assistenten damit verbinden, kann er für Sie Daten in Ihrer Organisation lesen und ändern. Er handelt in Ihrem Namen: Er kann sehen und ändern, was Ihr Konto kann, und nicht mehr.

## Bevor Sie loslegen

Ein Administrator schaltet MCP unter **Einstellungen › Verwaltung › MCP & API** ein. Zum Öffnen dieser Seite braucht man das Recht **MCP & API ansehen**, zum Ändern **MCP & API verwalten**. Bei neuen Organisationen ist MCP aus, und es funktioniert nur, solange die REST-API eingeschaltet ist; [Für Administratoren](https://developers.plnnrly.com/de/docs/administration/) erklärt die Schalter.

## Verbindungsdaten

- Server-URL: `https://<ihre-url>/mcp/v1`
- Transport: HTTP (streamable)
- Authentifizierung: Anmeldung (OAuth)

`<ihre-url>` ist die Adresse, unter der Sie sich bei plnnrly anmelden, zum Beispiel `acme.plnnrly.com`, oder die eigene Domain Ihrer Organisation. Der **KI**-Bereich (das Funkel-Symbol in der oberen Leiste) zeigt die genaue Server-URL für Ihre Organisation. Der Bereich erscheint, sobald MCP eingeschaltet ist.

## So funktioniert das Verbinden

Sie fügen die Server-URL in Ihrem KI-Client hinzu. Der Client öffnet plnnrly in Ihrem Browser. Dort melden Sie sich bei Bedarf an und geben die Verbindung frei. Sie müssen kein Token kopieren.

Die Freigabeseite zeigt:

- als wer Sie angemeldet sind
- was die App anfordert, zum Beispiel **Den MCP-Server nutzen (KI-Assistenten)**
- eine Warnung, wenn Ihre Organisation destruktive Aktionen erlaubt, weil die App dann auch Datensätze löschen kann
- die Adresse, zu der Sie nach der Freigabe zurückgeleitet werden
- **Freigeben** und **Abbrechen**

In einer Support-Sitzung lässt sich keine App verbinden. Melden Sie sich mit Ihrem eigenen Konto an.

Nach dem Verbinden erneuert der Client seinen Zugriff jede Stunde selbst. Ein Client, den Sie 30 Tage lang nicht benutzt haben, muss sich erneut anmelden.

Sie haben einen Client mit einem persönlichen MCP-Token verbunden, bevor es die Anmeldung gab? Dieses Token funktioniert weiterhin. Sie können es im **KI**-Bereich unter **Persönliches Zugriffstoken** löschen. Neue persönliche MCP-Tokens lassen sich nicht mehr erstellen.

## Eine App trennen

Der **KI**-Bereich listet die Apps, die Sie verbunden haben, unter **Verbundene Apps** auf. **Trennen** beendet die KI-Verbindung einer App sofort, und Sie können sie später erneut verbinden. Hat dieselbe Anmeldung der App auch Zugriff auf die REST-API gegeben, endet auch dieser. Apps, die nur mit der REST-API verbunden sind, stehen stattdessen in Ihrem Benutzermenü unter **API-Zugang › Verbundene Apps**.

Wenn Sie plnnrly im Client entfernen, kann dieser Client es nicht mehr nutzen. Die Anmeldung in plnnrly endet dadurch aber nicht immer: Die App kann bis zu 30 Tage nach ihrer letzten Nutzung in der Liste bleiben, sofern der Client seine Anmeldung nicht selbst aufgehoben hat. Um sicherzugehen, dass die Verbindung beendet ist, nutzen Sie **Trennen**.

## Was ein Client kann

Ein verbundener Client erreicht jede Operation der REST-API außer Datei-Uploads, immer in Ihrem Namen und im Rahmen Ihrer Rechte. Löschen kann er nur, wenn Ihre Organisation es erlaubt und Sie bestätigen.

- [Was Sie fragen können](https://developers.plnnrly.com/de/docs/mcp/examples/) zeigt Beispielfragen pro Bereich.
- [Tools](https://developers.plnnrly.com/de/docs/mcp/tools/) beschreibt die vier Tools, die ein Client nutzt.
- [Rechte und Sicherheit](https://developers.plnnrly.com/de/docs/mcp/permissions-and-safety/) erklärt, was ein Client darf und wie das Löschen gesperrt ist.

## Wählen Sie Ihren Client

- [claude.ai](https://developers.plnnrly.com/de/docs/mcp/install/claude-ai/): 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**.

- [Claude Desktop](https://developers.plnnrly.com/de/docs/mcp/install/claude-desktop/): 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**.

- [Claude Code](https://developers.plnnrly.com/de/docs/mcp/install/claude-code/): Führen Sie dies im Terminal aus und melden Sie sich dann mit `claude mcp login plnnrly` an.

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

- [ChatGPT](https://developers.plnnrly.com/de/docs/mcp/install/chatgpt/): 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**.

- [Cursor](https://developers.plnnrly.com/de/docs/mcp/install/cursor/): Tragen Sie dies in `~/.cursor/mcp.json` ein. Cursor bittet Sie um die Anmeldung bei plnnrly, sobald es sich verbindet.

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

- [Gemini](https://developers.plnnrly.com/de/docs/mcp/install/gemini/): Führen Sie dies im Terminal aus, starten Sie `gemini` und melden Sie sich mit `/mcp auth plnnrly` an.

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

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