Viele MCP-Server kennen nur einen Bearer-Token. Microsoft 365 Copilot Chat verlangt für eigene Connectoren OAuth 2.0 mit festem Client und Secret. Ein MCP-Proxy mit Entra-Login übersetzt zwischen beiden Welten – ohne Copilot Studio und ohne eigenen Programmcode. Der Artikel zeigt Architektur, Proxy-Auswahl, Einrichtung am Beispiel Twenty CRM, die typischen Fehler und den Betrieb.
Microsoft 365 Copilot kennt E-Mails, Teams-Chats und SharePoint-Dokumente. Kundendaten, Tickets oder Projektstände liegen in vielen KMU aber in eigenen Systemen. Seit Copilot Chat das Model Context Protocol (MCP) unterstützt, lassen sich solche Systeme direkt anbinden. Copilot ruft dann Werkzeuge wie «Kontakt suchen» oder «Aufgabe anlegen» live auf, sobald eine Frage dazu passt.
In der Praxis scheitert die Anbindung oft an der Anmeldung. Copilot Chat verlangt für eigene Connectoren OAuth 2.0 mit festem Client und Secret. Viele MCP-Server bieten nur einen Bearer-Token, also einen festen API-Schlüssel. Ein MCP-Proxy schliesst diese Lücke. Er meldet die Mitarbeiter über Microsoft Entra an und setzt beim Weiterleiten den Schlüssel ein. Copilot Studio braucht es dafür nicht. Wir zeigen den Weg am Beispiel des Open-Source-CRM Twenty.
Kurz gesagt: Copilot Chat bindet MCP-Server als Connector im Microsoft 365 Admin Center an. Die Anmeldung läuft über eine OAuth-Registrierung im Teams Developer Portal. Werkzeuge mit Bearer-Token bekommen einen MCP-Proxy vorgeschaltet. Der Proxy prüft das Firmenkonto über Entra und ruft den MCP-Server mit dem hinterlegten Schlüssel auf. Die Daten bleiben im Quellsystem, Copilot liest sie nur bei Bedarf.
Was ein MCP-Server ist und was Copilot damit anfängt
Das Model Context Protocol ist ein offener Standard, über den KI-Assistenten Werkzeuge eines fremden Systems aufrufen. Ein MCP-Server beschreibt seine Werkzeuge mit Name, Zweck und Parametern. Copilot liest diese Liste beim Verbinden ein. Bei jeder Frage entscheidet der Assistent, ob ein Werkzeug passt, und ruft es mit passenden Parametern auf. Twenty bringt einen eigenen MCP-Server mit, erreichbar unter der Adresse der Instanz mit dem Pfad /mcp.
- 1
Live-Abfrage: Copilot kopiert und indexiert nichts. Jede Antwort entsteht aus einem aktuellen Aufruf im Quellsystem.
- 2
Beschreibung entscheidet: Copilot wählt den Connector anhand der Beschreibung im Admin Center. Konkrete Begriffe wie Kontakte, Firmen und Deals helfen bei der Auswahl.
- 3
Lesen und Schreiben: Das Admin Center stuft jedes Werkzeug als Lesen oder Schreiben/Löschen ein. Schreibwerkzeuge schaltet Microsoft für MCP-Connectoren schrittweise frei.
- 4
Transport: Der MCP-Server muss per HTTPS erreichbar sein und Streamable HTTP sprechen. Das ältere SSE bieten viele Dienste nicht mehr an.
- 5
Lizenz: Jeder Mitarbeiter, der den Connector nutzt, braucht eine Microsoft-365-Copilot-Lizenz.
Bearer-Token oder OAuth: wo das Problem liegt
Ein Bearer-Token ist ein fester Schlüssel, den ein Programm im Header Authorization mitschickt. Wer den Schlüssel besitzt, darf zugreifen. Das Verfahren ist einfach und für Server-zu-Server-Verbindungen verbreitet. Viele MCP-Server, Automatisierungsdienste und Fachanwendungen kennen nur diesen Weg. Copilot Chat bietet für eigene MCP-Server zwei Anmeldewege: keine Authentifizierung oder OAuth 2.0. Ohne Authentifizierung steckt der Schlüssel in der URL. Alle Mitarbeiter arbeiten dann mit demselben Konto, und wer die URL kennt, hat Zugriff. Für ein CRM mit Kundendaten scheidet das aus. OAuth 2.0 verlangt eine Client-ID, ein Secret, einen Autorisierungs- und einen Tokenendpunkt. Jeder Mitarbeiter meldet sich beim ersten Aufruf einmal selbst an. Genau diese Endpunkte fehlen einem MCP-Server, der nur einen Bearer-Token kennt. Twenty bietet zwar eine eigene OAuth-Schnittstelle, dort registriert sich jeder Client aber selbst per API (RFC 7591). Das Teams Developer Portal erwartet dagegen feste Werte.
Copilot Chat oder Copilot Studio?
Für eigene Daten nennt Microsoft zwei Wege. Der Connector im Admin Center macht einen MCP-Server direkt in Copilot Chat verfügbar. Copilot Studio baut daraus einen eigenen Agenten, den die Mitarbeiter mit @Name aufrufen. Für die meisten Lesezugriffe reicht der erste Weg.
Connector in Copilot Chat und Agent in Copilot Studio
| Kriterium | Connector in Copilot Chat | Agent in Copilot Studio |
|---|---|---|
| Einrichtung | Microsoft 365 Admin Center und Teams Developer Portal | Copilot Studio, Veröffentlichung im Kanal Microsoft 365 Copilot |
| Aufruf | Direkt in Copilot Chat, sobald eine Frage passt | Mit @Name des Agenten |
| Schreibaktionen | Werden schrittweise freigeschaltet | Sofort nutzbar |
| Lizenz | Microsoft-365-Copilot-Lizenz | Je nach Connector zusätzlich Copilot-Studio-Kapazität |
| Aufwand | Einmal registrieren, dann Rollout per Gruppe | Agent bauen, testen und pflegen |
| Passt für | Suchen und Nachschlagen im Arbeitsalltag | Feste Abläufe mit Schreibschritten |
Die Architektur mit MCP-Proxy
Der Proxy steht zwischen Copilot Chat und dem MCP-Server. Gegenüber Copilot tritt er als OAuth-Server auf und gibt eine Client-ID mit Secret aus. Für die Anmeldung leitet er die Mitarbeiter an Microsoft Entra ID weiter. Gegenüber dem MCP-Server verhält er sich wie ein normaler Client mit Bearer-Token. Der Schlüssel liegt nur in den Umgebungsvariablen des Proxys.
Der Proxy erfüllt damit drei Aufgaben: Er stellt die OAuth-Endpunkte bereit, prüft das Firmenkonto und tauscht das Copilot-Token gegen den Bearer-Token. Der MCP-Server selbst bleibt unverändert. Für jedes weitere Werkzeug wiederholt sich dasselbe Muster mit eigener Subdomain und eigenem Schlüssel.
Welcher MCP-Proxy passt: sechs Wege im Vergleich
Wir haben sechs Varianten geprüft, die sich selbst betreiben lassen oder bereits im Microsoft-Umfeld vorhanden sind. Entscheidend waren drei Fragen: Liefert der Proxy Copilot eine feste Client-ID mit Secret? Setzt er einen Bearer-Token pro Werkzeug ein? Und lässt er sich ohne eigenen Code betreiben?
MCP-Proxys für Microsoft 365 Copilot Chat
| Lösung | Anmeldung für Copilot | Bearer-Token zum Werkzeug | Betrieb | Einschätzung |
|---|---|---|---|---|
| mcp-auth-proxy (sigbit) | Eigener OAuth-Server mit Client-Registrierung, Login über Entra (OIDC) | Ja, per PROXY_BEARER_TOKEN | Ein Container pro Werkzeug | MIT-Lizenz, Ablauf mit Copilot getestet |
| Traefik + oauth2-proxy | Login direkt über Entra, Token-Prüfung per forwardAuth | Ja, per Header-Middleware | Zentral im Reverse Proxy | Nutzt vorhandene Infrastruktur, kein Tool-Filter |
| agentgateway | Prüft Entra-Token (JWT) | Ja, pro Backend | Zentral, eine Route pro Werkzeug | MCP-spezifisch mit Tool-Filter, Konfiguration anspruchsvoller |
| Pomerium | Entra-Login, akzeptiert Entra-Zugriffstoken | Ja, per set_request_headers | Zentral, Subdomain pro Werkzeug | Copilot-Ablauf nicht dokumentiert |
| LiteLLM | Token-Prüfung nur in der Enterprise-Lizenz | Ja, pro MCP-Server | Zentral mit Datenbank | Passt, wenn LiteLLM ohnehin als KI-Gateway läuft |
| n8n MCP Server Trigger | Keine oder fester Bearer-Token | Ja, im Workflow | Zentral in n8n | Für kuratierte Einzelwerkzeuge, kein Login pro Mitarbeiter |
Für Twenty eignet sich mcp-auth-proxy am besten. Er liefert Copilot über seine Registrierung eine Client-ID mit Secret und meldet die Mitarbeiter über Entra an. Beim Weiterleiten ersetzt er das Copilot-Token durch den Twenty-Schlüssel. Der Container läuft zum Beispiel in Coolify, einer selbst gehosteten Plattform für Docker-Dienste. Domain und TLS-Zertifikat stellt Coolify bereit.
Schritt für Schritt am Beispiel Twenty CRM
Die Einrichtung dauert rund eine Stunde, wenn die Zugänge bereitliegen. Gebraucht werden ein Entra-Administrator, Zugriff auf das Teams Developer Portal, die Rolle KI- oder globaler Administrator im Microsoft 365 Admin Center sowie ein Server mit Docker. Die Adressen im Text sind Platzhalter.
- In Twenty unter Settings → APIs & Webhooks einen API-Schlüssel für einen eigenen Benutzer «Copilot» anlegen und dessen Rolle auf das Nötige beschränken
- In Entra eine App-Registrierung vom Typ Web anlegen, nur für das eigene Verzeichnis
- Als Umleitungs-URI die Callback-Adresse des Proxys eintragen, beim mcp-auth-proxy https://crm-mcp.example.ch/.auth/oidc/callback
- Ein Client-Secret erzeugen und den Wert sofort im Passwortmanager ablegen
- Neuen Docker-Compose-Dienst mit dem Image ghcr.io/sigbit/mcp-auth-proxy anlegen und eine eigene Subdomain zuweisen
- Als Ziel die Twenty-Adresse ohne Pfad angeben: https://crm.example.ch
- Entra-Mandant, Client-ID und Secret als OIDC-Variablen setzen, den Zugriff per OIDC_ALLOWED_USERS_GLOB auf die Firmendomain begrenzen
- Den Twenty-Schlüssel als PROXY_BEARER_TOKEN hinterlegen und NO_AUTO_TLS setzen, weil Coolify das Zertifikat übernimmt
- Am Proxy einmalig einen Client mit der Rückadresse https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect registrieren
- Im Teams Developer Portal eine OAuth-Clientregistrierung mit dieser Client-ID, dem Secret sowie Autorisierungs- und Tokenendpunkt des Proxys anlegen, PKCE einschalten
- Im Admin Center unter Copilot → Connectors einen MCP-Connector mit der Adresse https://crm-mcp.example.ch/mcp und der Registrierungs-ID anlegen
- Rollout zuerst für eine Testgruppe, Agent-Einstellungen und Benutzerzugriff prüfen, nach rund zehn Minuten in einem neuen Chat testen
Die Konfiguration des Proxys passt in eine kurze Compose-Datei. Die wichtigsten Werte stehen als Umgebungsvariablen in Coolify, damit kein Schlüssel im Klartext in der Datei landet:
Umgebungsvariablen des MCP-Proxys
| Variable | Inhalt | Herkunft |
|---|---|---|
| EXTERNAL_URL | Öffentliche Adresse des Proxys, z. B. https://crm-mcp.example.ch | Domain in Coolify |
| Ziel-URL (Startparameter) | Adresse des MCP-Servers ohne Pfad, z. B. https://crm.example.ch | Twenty-Instanz |
| OIDC_CONFIGURATION_URL | https://login.microsoftonline.com/ | Verzeichnis-ID aus Entra |
| OIDC_CLIENT_ID | Anwendungs-ID (Client) der Entra-App | Übersicht der App-Registrierung |
| OIDC_CLIENT_SECRET | Wert des Client-Secrets | Zertifikate & Geheimnisse |
| OIDC_ALLOWED_USERS_GLOB | *@firma.ch | Eigene Firmendomain |
| PROXY_BEARER_TOKEN | API-Schlüssel des MCP-Servers | Twenty → Settings → APIs & Webhooks |
| NO_AUTO_TLS / TRUSTED_PROXIES | true / private Netzbereiche des Reverse Proxys | Coolify übernimmt TLS |
Der Bearer-Token gehört ausschliesslich in die Umgebungsvariablen des Proxys. In der Connector-URL oder in einer Konfigurationsdatei im Klartext ist er ein offenes Passwort. Prüfen Sie ausserdem die Rolle des Schlüssels in Twenty: Copilot kann genau das, was dieser Benutzer darf.
Weitere MCP-Server mit Bearer-Token anbinden
Das Muster lässt sich auf jedes Werkzeug übertragen, das einen MCP-Server mit Bearer-Token anbietet. Pro Werkzeug entstehen ein Proxy-Container, eine Subdomain und ein Connector im Admin Center. Die Entra-App und die Registrierung im Teams Developer Portal lassen sich wiederverwenden, wenn die Umleitungs-URI jedes Proxys in der App eingetragen ist.
- 1
Eigene Subdomain je Werkzeug: Getrennte Adressen halten Schlüssel, Logs und Rollout pro System auseinander.
- 2
Eigener technischer Benutzer je Werkzeug: Der Schlüssel trägt nur die Rechte, die Copilot für dieses System braucht.
- 3
Beschreibung schärfen: Im Admin Center nennt jeder Connector seine Daten konkret, damit Copilot das richtige System wählt.
- 4
Werkzeuge reduzieren: Systeme mit sehr vielen oder sehr allgemeinen Werkzeugen überfordern die Auswahl. Ein Filter im Proxy oder im MCP-Server hilft.
Die drei Fehler, die in der Praxis fast immer auftreten
Bei der Einrichtung treten drei Fehler typischerweise nacheinander auf. Alle drei lassen sich in wenigen Minuten beheben, wenn man weiss, wo man hinschauen muss. Das Proxy-Log zeigt jede Anfrage von Copilot mit Statuscode und hilft bei der Eingrenzung.
Symptom, Ursache und Lösung
| Symptom | Ursache | Lösung |
|---|---|---|
| Entra meldet AADSTS500113: No reply address is registered | In der Entra-App fehlt die Umleitungs-URI oder sie liegt bei einer anderen App | Callback-Adresse des Proxys unter Authentifizierung als Plattform Web eintragen und die Client-ID mit der App vergleichen |
| Entra meldet AADSTS700016: Application not found in the directory | Bei der Client-ID steht die Mandanten-ID | In der App-Übersicht die Anwendungs-ID (Client) kopieren, nicht die Verzeichnis-ID, und den Proxy neu starten |
| Anmeldung klappt, das Admin Center meldet «Tools konnten nicht abgerufen werden» | Der Proxy hängt den Pfad doppelt an und fragt Twenty unter /mcp/mcp ab, Twenty antwortet mit 404 | Als Ziel die Twenty-Adresse ohne /mcp angeben |
Ein fester Testablauf grenzt jeden Fehler in drei Schritten ein. Zuerst ein POST mit tools/list direkt an den MCP-Server, mit dem Schlüssel als Bearer-Token: Liefert er die Werkzeugliste, stimmt der Schlüssel. Danach derselbe Aufruf ohne Token an den Proxy: Er muss mit 401 und einem Verweis auf die Metadaten antworten. Zuletzt das Proxy-Log während eines Anmeldeversuchs im Admin Center lesen. Dort steht, ob Copilot ein Token erhält und mit welchem Status der MCP-Server antwortet.
Rollout und Betrieb
Ein Connector in Copilot Chat ist erst sichtbar, wenn alle Freigaben gleichzeitig stimmen. Im Admin Center sind das der Rollout des Connectors sowie unter Agents die Optionen für Agents und Plug-ins der Organisation und der Benutzerzugriff. Änderungen brauchen bis zu zehn Minuten, danach hilft ein neuer Chat.
- 1
Gestaffelt ausrollen: Zuerst eine Testgruppe, nach einigen Tagen die übrigen Mitarbeiter mit Bedarf.
- 2
Erste Anmeldung erklären: Beim ersten Aufruf erscheinen die Microsoft-Anmeldung und eine Bestätigungsseite des Proxys. Ein Satz in der Einführung verhindert Rückfragen.
- 3
Secret-Ablauf planen: Das Entra-Secret läuft nach der gewählten Frist ab. Ein Termin im Kalender vor dem Ablauf verhindert einen Ausfall.
- 4
Updates einplanen: Der Proxy ist ein eigener Dienst mit eigenen Versionen. Ein festes Image-Tag und ein geplanter Wechsel halten den Betrieb ruhig.
- 5
Logs auswerten: Statuscodes 401 und 404 im Proxy-Log zeigen Probleme früh, bevor Mitarbeiter sie melden.
Sicherheit und Datenschutz bei der Anbindung
Mit dem Connector fliessen Daten aus dem Quellsystem in Copilot-Antworten. Damit gehört die Anbindung in die Verarbeitungsübersicht nach dem revidierten Datenschutzgesetz. Microsoft verarbeitet die Antworten innerhalb der Microsoft-365-Dienstgrenze und nutzt sie laut eigener Dokumentation nicht zum Training der Modelle.
- 1
Gemeinsames Konto: Alle Anfragen erreichen den MCP-Server mit demselben Schlüssel. Wer welche Abfrage gestellt hat, steht im Proxy-Log mit Entra-Anmeldung.
- 2
Zugriff doppelt begrenzen: Der Proxy lässt nur Konten der eigenen Domain zu. Der Rollout im Admin Center beschränkt den Connector zusätzlich auf berechtigte Mitarbeiter.
- 3
Rechtekonzept für den technischen Benutzer: Leserechte reichen für die meisten Fragen. Schreib- und Löschrechte folgen erst nach einer Testphase und bewusster Freigabe.
- 4
Bestehende Berechtigungen prüfen: Copilot zeigt nur, was die Rechte hergeben. Zu weit gefasste Rollen im Quellsystem werden über den Connector sichtbar.
Wie Copilot mit Berechtigungen umgeht, zeigt der Beitrag zu den Microsoft-Copilot-Berechtigungen. Die Unterschiede der KI-Anbieter beim Datenschutz fasst der Vergleich der LLM-Anbieter zusammen. Wer parallel ChatGPT im Einsatz hat, findet die Richtlinien im Beitrag zu ChatGPT und Datenschutz.
Häufige Fragen zu MCP-Proxy und Copilot Chat
KPX-Services rund um Copilot und eigene Daten
Wir binden eigene Systeme an Microsoft 365 Copilot an und betreuen die Anbindung im Betrieb:
Microsoft Copilot für KMU
Pilot, Connectoren zu CRM und Fachanwendungen sowie Schulung der Mitarbeiter – mit Berechtigungs-Check vor dem Rollout.
KI sicher nutzen im Unternehmen
KI-Richtlinie, Verarbeitungsübersicht und kontrollierte Anbindung eigener Daten als Managed Service.
Managed Microsoft 365
Entra, Conditional Access und laufende Überwachung des Mandanten – eingerichtet und dauerhaft betreut.
Ihr CRM oder eine Fachanwendung soll in Copilot Chat erscheinen? Wir prüfen im Gratis Erstgespräch, welcher Anbindungsweg zu Ihren Systemen passt.
Jetzt Ihre individuelle ErstanalyseDie Angaben beruhen auf einer praktischen Einrichtung und den Dokumentationen von Microsoft, Twenty und mcp-auth-proxy, Stand November 2026. Oberflächen und Funktionsumfang von Copilot-Connectoren ändern sich regelmässig.
Themen
