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.

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.

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.

Schritt 4: Der Connector ist erstellt

Die Verbindung erscheint nun in deiner Tools-Liste als Custom Connector mit Status Ready.

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.

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):

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.

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.

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.

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

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.

Aktualisiert am: 12/06/2026

War dieser Beitrag hilfreich?

Danke!