Benutzerdefinierte Header für MCP-Connectoren in Copilot Studio

Read this in English

Serverweiten Kontext für MCP-Connectoren in Copilot Studio einrichten, indem OpenAPI-YAML bearbeitet, jeder Agent aktualisiert und der Header als Eingabe hinzugefügt wird.

27/10/2026 27/10/2026

Power Platform Governance

Eine Abfolge mit vier Schritten zeigt das Bearbeiten des OpenAPI-YAML unter dem POST-Endpunkt /mcp, das Aktualisieren des Connectors, das Entfernen und erneute Hinzufuegen in jedem Agenten und danach das Setzen des Header-Eingabewerts. — Schematische Darstellung der beschriebenen Schritte nach Microsoft Copilot Studio CAT, kein Screenshot.

TL;DR

MCP-Connectoren in Copilot Studio bieten keine Oberfläche für benutzerdefinierte Header. Definiere sie im OpenAPI-YAML unter dem POST-Endpunkt /mcp, aktualisiere den Connector, entferne ihn aus jedem Agenten und füge ihn erneut hinzu. Danach kann der Header mit einem festen Wert, einer Systemvariable oder PowerFX konfiguriert werden.

Original von Adi Leibowitz, auf Microsoft Copilot Studio CAT. Artikel lesen

Dies ist unsere eigene Kurzfassung, keine Wiederveröffentlichung oder vollständige Übersetzung.

Bedeutung für Governance

Makers: Verwende verifizierten Kontext wie einen Benutzerrang als benutzerdefinierten Header statt als Tool-Eingabe, damit der MCP-Server Aufrufe einheitlich filtert.
Admins/CoE: Bearbeite das OpenAPI-YAML des benutzerdefinierten Connectors, aktualisiere ihn und füge ihn in jedem betroffenen Agenten neu hinzu, weil eine Aktualisierung allein nicht genügt.
Security/Compliance: Prüfe Header für Authentifizierung, Rollen, Berechtigungen oder Feature Flags und vermeide X-Präfixe, solange das dokumentierte Connector-Problem besteht.

Häufige Fragen

Wie füge ich einem MCP-Connector in Copilot Studio einen Benutzerlevel-Header hinzu?

Bearbeite das OpenAPI-YAML unter dem POST-Endpunkt /mcp, aktualisiere den Connector und stelle den Header anschliessend im Bereich Inputs bereit.

Warum muss ein MCP-Connector nach einer OpenAPI-YAML-Änderung entfernt und neu hinzugefügt werden?

Copilot Studio erkennt den geänderten benutzerdefinierten Header erst, wenn der Connector in jedem verwendenden Agenten entfernt und erneut hinzugefügt wurde.

Funktionieren X-präfixierte benutzerdefinierte Header bei MCP-Connectoren im Oktober 2025?

Das dokumentierte Problem vom Oktober 2025 besagt, dass X-präfixierte Header nicht funktionieren. Verwende bis zur Behebung Namen ohne X-Präfix.