> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://helpdesk.pluvo.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Pluvo mit Microsoft Copilot Studio verbinden (MCP) Mit dem Model Context Protocol (MCP) verbindest du deine Pluvo-Academy mit einem Agenten in Microsoft Copilot Studio. Dein Agent kann dann direkt Pluvo-Aktionen ausführen, etwa Fragen erstellen oder Bedingungen festlegen. Die Verbindung nutzt OAuth 2.0 für sicheren Zugriff. Dieser Artikel führt dich Schritt für Schritt durch den Prozess. ## Was du brauchst * Zugang zu **Microsoft Copilot Studio** * Die URL deiner Pluvo-Academy — meist `https://[deineacademy].pluvo.com`, oder deine eigene Domain, wenn deine Academy darauf läuft (z. B. `https://academy.deinunternehmen.de`). In den Beispielen unten steht `https://[deineacademy].pluvo.com`; ersetze das überall durch deine eigene Academy-URL. Die Pfade dahinter (`/mcp`, `/oauth/authorize/`, `/oauth/token/`, `/oauth/register/`) bleiben gleich. * Ein **Pluvo-Konto** zum Einloggen * Ein Terminal für einen Befehl (Schritt 6) --- || Der Trick, um nur einmal zu registrieren: Die eindeutige **Redirect URL** erscheint erst, *nachdem* du die Verbindung gespeichert hast — aber Client ID und Client secret sind erforderlich, um überhaupt speichern zu können. Deshalb füllst du diese zunächst vorübergehend mit `temp`, speicherst, und registrierst *danach* den echten Client mit der generierten Redirect URL. So vermeidest du einen „Redirect Mismatch". --- ## Schritt 1: Neues Tool erstellen Geh in Copilot Studio links zu **Tools** und klicke auf **+ New tool**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15043_u6awdt.png) ## Schritt 2: Wähle Model Context Protocol + OAuth 2.0 (Manual) Wähle **Model Context Protocol**. Setze im Dialog **Authentication** auf **OAuth 2.0** und **Type** auf **Manual**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15054_4dpgcn.png) ## Schritt 3: Felder ausfüllen | Feld | Wert | | ---- | | Server name | Pluvo Staging (frei wählbar) | | Server description | Pluvo MCP – Staging-Umgebung (frei wählbar) | | Server URL | `https://[deineacademy].pluvo.com/mcp` ⚠️ kein `/` am Ende | | Client ID | `temp` (vorübergehend — Schritt 7) | | Client secret | `temp` (vorübergehend) | | Authorization URL | `https://[deineacademy].pluvo.com/oauth/authorize/` | | Token URL template | `https://[deineacademy].pluvo.com/oauth/token/` | | Refresh URL | `https://[deineacademy].pluvo.com/oauth/token/` | | Scopes | `mcp` | | Redirect URL | leer lassen — erscheint nach dem Speichern | || **Achte auf den Schrägstrich am Ende** von `/authorize/` und `/token/` — er ist erforderlich. Warte, bis die Meldung „Enter the complete server path to continue" bei der Server URL verschwindet. Klicke danach auf **Create**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15100_a17cxe.png) ## Schritt 4: Der Connector ist erstellt Die Verbindung erscheint nun in deiner Tools-Liste als **Custom Connector** mit Status **Ready**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15103_1v9j10y.png) ## Schritt 5: Redirect URL kopieren Öffne den Connector (du landest im **Custom-Connector-Editor**, Tab **Security**). Unten steht nun die generierte **Redirect URL** mit einem eindeutigen Anhang. Klicke auf das Kopier-Symbol und bewahre sie auf. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15104_5o24f2.png) ## Schritt 6: OAuth-Client registrieren (einmalig) Registriere bei Pluvo einen Client mit genau dieser Redirect URL. Führe dies in einem Terminal aus (ersetze `[deineacademy]` durch deinen Academy-Namen und füge deine Redirect URL bei `redirect_uris` ein): ```bash curl -sS -X POST https://[deineacademy].pluvo.com/oauth/register/ \ -H 'Content-Type: application/json' \ -d '{ "client_name": "Copilot Studio MCP", "redirect_uris": ["HIER-DEINE-REDIRECT-URL-EINFÜGEN"], "grant_types": ["authorization_code","refresh_token"], "response_types": ["code"], "token_endpoint_auth_method": "client_secret_post", "scope": "mcp" }' ``` Du erhältst eine `client_id` und ein `client_secret` zurück. Bewahre diese auf. --- ## Schritt 7: Echte Client ID und Secret eintragen Ersetze im **Security**-Tab die vorübergehenden `temp`-Werte durch die echte **Client ID** und das echte **Client secret** aus Schritt 6. Den Rest (URLs + Scope `mcp`) lässt du stehen. Klicke rechts oben auf **Update connector**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15104_14c48mg.png) ## Schritt 8: Tool zu deinem Agenten hinzufügen Geh zurück zu Copilot Studio → **Agents** → öffne (oder erstelle) deinen Agenten → Tab **Tools** → **Add a tool**. Suche nach dem Namen, filtere ggf. auf **Model Context Protocol** und wähle **Pluvo Staging**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15141_9dcaq8.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15144_1c9bpe.png) ## Schritt 9: Verbindung herstellen und einloggen Bei **Connection** steht zunächst „Not connected". Klicke auf **Create new connection**. Es öffnet sich ein Pluvo-Fenster — klicke auf **Autorisieren** und melde dich mit deinem Pluvo-Konto an. Danach wird die Verbindung grün. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15145_icianz.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15155_16rxvui.png) ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15160_yzv55c.png) ## Schritt 10: Fertig — die Pluvo-Tools erscheinen Der MCP-Server ist verbunden. Unter **Tools** siehst du nun die verfügbaren Pluvo-Aktionen (wie `get_conditions`, `set_conditions`, `create_question`, …). Teste deinen Agenten mit einem Prompt, der ein Tool verwendet. 🎉 ![](https://storage.crisp.chat/users/helpdesk/website/-/e/f/b/2/efb20d00b64eb000/screenshot-2026-06-11-at-15162_1agmss0.png) | **Tipp:** Bewahre deine `client_id` und dein `client_secret` sicher auf. Möchtest du die Verbindung widerrufen? Dann lösche den Connector und den zugehörigen OAuth-Client.