Viele Fachanwendungen bieten eine REST-API, aber keinen MCP-Server. Ein OpenAPI-Übersetzer macht aus der Beschreibung der API fertige Werkzeuge, ein Hub verteilt sie an Copilot Chat. Der Beitrag zeigt Architektur, Werkzeugfilter, Einrichtung und die Fehler, die dabei auftreten.
Fast jede Fachanwendung spricht REST. Ticket-Systeme, CRM, Lagerverwaltung und Rechnungssoftware bieten eine Schnittstelle, über die Programme Daten lesen und schreiben. Für Microsoft 365 Copilot genügt diese Schnittstelle allein nicht. Copilot Chat ruft Werkzeuge über das Model Context Protocol (MCP) auf.
Ein Anbieter liefert zu seiner REST-API oft keinen MCP-Server mit. Wer eine solche API in Copilot anbinden will, braucht eine Übersetzung. Ein Programm liest die OpenAPI-Beschreibung der API und baut daraus Werkzeuge.
Der Beitrag zeigt die Architektur und die Einrichtung am Beispiel Docbee, einer Ticket- und Service-Management-Software für IT-Dienstleister.
Kurz gesagt: Copilot Chat erreicht Werkzeuge über MCP. Eine REST-API wird nutzbar, wenn ein Dienst sie als MCP-Server anbietet. Ein OpenAPI-Übersetzer macht aus der Beschreibung der API fertige Werkzeuge, ein Hub verteilt sie an Copilot Chat. Die Anmeldung läuft über einen Proxy mit OAuth, die Fachanwendung antwortet mit einem Token.
REST-API, OpenAPI und MCP in Kürze
Die drei Begriffe beschreiben drei Ebenen einer Anbindung. Die REST-API ist der programmierbare Zugang zur Fachanwendung. OpenAPI ist die schriftliche Beschreibung dieses Zugangs. MCP legt fest, wie ein Assistent Werkzeuge aufruft.
- 1
REST-API – Ein Programm ruft Endpunkte über HTTP ab und erhält JSON zurück. Fast jede Fachanwendung stellt eine solche Schnittstelle bereit.
- 2
OpenAPI/Swagger – Eine Datei beschreibt die Endpunkte, ihre Parameter und die Antworten. Sie dient als Vertrag zwischen Anbieter und Client und als Grundlage der Übersetzung.
- 3
MCP – Der offene Standard, über den KI-Assistenten Werkzeuge aufrufen. Jedes Werkzeug trägt einen Namen, eine Beschreibung und definierte Parameter.
- 4
Werkzeug statt Endpunkt – Copilot sieht Werkzeuge, keine URLs. Name und Beschreibung entscheiden, ob der Assistent das richtige Werkzeug wählt.
Drei Wege von der API zum MCP-Server
Für die Übersetzung einer REST-API gibt es drei etablierte Wege. Alle drei liefern Werkzeuge für Copilot. Sie unterscheiden sich in Aufwand, Pflege und Grenzen.
Wege von der REST-API zum MCP-Server
| Weg | Aufwand | Pflege | Grenzen |
|---|---|---|---|
| OpenAPI-Übersetzer | Ein Container mit Startparametern | Folgt der Beschreibung der API | Liefert nur das, was die Beschreibung hergibt |
| Workflow mit MCP-Server-Trigger | Abläufe in n8n zusammenbauen | Jeder Ablauf einzeln | Erlaubt nur vorbereitete Aktionen |
| Eigener Code | Programmieren und Testen | Jede Änderung an der API im Code | Volle Kontrolle über jedes Werkzeug |
Architektur: Copilot, Proxy und Hub
Copilot Chat spricht OAuth mit dem Proxy. Der Proxy prüft die Anmeldung über Microsoft Entra ID und leitet die Anfrage an den Hub weiter. Der Hub verteilt sie an die passenden Werkzeuge: an einen bestehenden MCP-Server oder an einen OpenAPI-Übersetzer, der aus der API-Beschreibung Werkzeuge baut und die REST-Aufrufe ausführt.
Der Hub verteilt die Anfragen nach Pfad. Jedes Ziel erhält einen eigenen Pfad, im Beispiel /
Beispiel Docbee: eigener MCP-Server oder REST-API
Docbee ist eine Ticket- und Service-Management-Software für IT-Dienstleister. Die Anwendung bringt beide Wege mit: einen eigenen MCP-Server und eine REST-API mit OpenAPI-Beschreibung.
Docbee-MCP-Server und Docbee-REST-API im Vergleich
| Docbee-MCP-Server | Docbee-REST-API |
|---|---|
| 19 Werkzeuge, kuratiert | 1'098 Operationen auf 601 Pfaden, Stand Version 2026.2.0 |
| Tickets anlegen, ändern und suchen, Nachrichten, Tags, Leistungen, Tätigkeiten, Protokolle, Tagesagenda, Benachrichtigungen | Der volle Funktionsumfang der Anwendung, ohne Filter |
| Adresse https://docbee.example.ch/mcp | Beschreibung unter https://docbee.example.ch/restApi/v1/openapi.json, Basis-URL https://docbee.example.ch/restApi |
| Anmeldung mit einem Bearer-Token, der mit den Rechten des Token-Benutzers läuft | Anmeldung über den Header Authorization: Bearer |
Der MCP-Server deckt die häufigen Aufgaben ab. Die REST-API öffnet den ganzen Funktionsumfang, verlangt dafür aber eine sorgfältige Auswahl der Werkzeuge. Beide Wege nutzen denselben Zugangstoken und laufen mit den Rechten des Benutzers, der den Token erstellt hat.
Tools filtern statt alles freigeben
Die REST-API von Docbee liefert 1'098 Operationen. Ohne Filter entsteht daraus ein Werkzeugkatalog, den Copilot schwer nutzt. Der OpenAPI-Übersetzer schränkt die Werkzeuge nach Tag und nach HTTP-Methode ein: Der Parameter --tag nimmt die gewünschten Bereiche auf, --operation legt die erlaubten Methoden fest.
Mit den Tags ticket, ticketMessage, ticketStatus, ticketCategory, customer, customerContact, customerLocation und customerObject sowie den Methoden GET, POST und PUT bleiben 76 Werkzeuge übrig. Keines davon löscht etwas. So sieht Copilot nur die Werkzeuge, die für den Alltag zählen.
Achtung: Der Filter bestimmt, welche Werkzeuge Copilot sieht. Aktionen wie das Zusammenführen oder Verschieben von Tickets geben Sie bewusst frei und testen sie zuerst mit einer Testgruppe. Ohne Filter bleibt die Löschmethode erreichbar.
Schritt für Schritt zur Anbindung
Die Einrichtung braucht einen Server mit Docker, einen Zugriff auf das Teams Developer Portal und die Rolle eines Administrators im Microsoft 365 Admin Center. Die Adressen im Text sind Platzhalter.
- Hub auf einem Server mit Docker betreiben, zum Beispiel in Coolify, einer selbst gehosteten Plattform für Container-Dienste
- Adresse des Hubs eintragen, zum Beispiel https://mcp.example.ch
- OpenAPI-Übersetzer mit der Beschreibung der API starten: https://docbee.example.ch/restApi/v1/openapi.json
- Tags und Methoden festlegen, damit nur die gewünschten Werkzeuge entstehen
- Zugangstoken als Header setzen: Authorization: Bearer <token>
- OAuth-Registrierung im Teams Developer Portal anlegen, mit dem Autorisierungs- und dem Tokenendpunkt des Proxys
- Client-ID und Secret im Admin Center beim MCP-Connector eintragen
- Eine Registrierung genügt für alle Connectoren desselben Proxys
- Im Microsoft 365 Admin Center unter Copilot den MCP-Connector mit der Adresse https://mcp.example.ch/<name>/mcp anlegen
- Testgruppe festlegen und den Rollout freigeben
- Hub nach jeder Korrektur neu starten, damit er die Server neu einliest
- In einem neuen Chat prüfen, ob Copilot das gewünschte Werkzeug auswählt
Fehler aus der Praxis
Drei Fehler treten bei der Einrichtung wiederkehrend auf. Jeder von ihnen lässt sich in wenigen Minuten beheben, wenn man weiss, wo man hinschauen muss.
Symptom, Ursache und Lösung
| Symptom | Ursache | Lösung |
|---|---|---|
| 404 bei / | Die Variable mit der Adresse enthielt bereits den Pfad /mcp. Daraus entstand /mcp/mcp | Nur die Domain in die Variable schreiben, den Pfad setzt der Hub |
| Die Anmeldung scheitert mit invalid_scope | Copilot sendet beim Anmelden immer den Scope openid mit. Der Client war per Dynamic Client Registration ohne diesen Scope angelegt | Den Client mit dem Scope openid registrieren und die Registrierung wiederholen |
| Der Server bleibt im Connector unsichtbar | Der Hub bindet die Server nur beim Start ein | Nach jeder Korrektur den Hub neu starten |
Sicherheit und Datenschutz
Mit dem Connector fliessen Daten aus der Fachanwendung in Copilot-Antworten. Die Anbindung gehört damit in die Verarbeitungsübersicht nach dem revidierten Datenschutzgesetz.
- 1
Technischer Benutzer je Werkzeug: Je Fachanwendung braucht es einen eigenen Benutzer, dessen Rechte nur den benötigten Umfang abdecken.
- 2
Minimale Rechte: Leserechte genügen für die meisten Fragen. Schreibrechte folgen nach einer Testphase.
- 3
Token bleibt auf dem Server: Der Zugangsschlüssel steht in der Umgebung des Hubs, nicht in der Connector-Adresse und nicht im Klartext in einer Konfigurationsdatei.
- 4
Protokollierung: Der Hub protokolliert jeden Aufruf mit Zeitpunkt und Ziel. So bleibt nachvollziehbar, welcher Mitarbeiter welche Aktion ausgelöst hat.
- 5
Testgruppe: Der erste Rollout gilt einer kleinen Gruppe. Erst wenn die Protokolle keine Unregelmässigkeiten zeigen, weiten Sie den Kreis.
Grenzen des Ansatzes
Der Weg über OpenAPI trägt weit, aber nicht überall. Vier Grenzen lohnen sich vor der Einrichtung.
- 1
OAuth je Benutzer: Copilot meldet sich mit dem Konto des Mitarbeiters an. Läuft die API nur mit einem festen Schlüssel, braucht es zusätzlich den Proxy aus dem Beitrag zum MCP-Proxy.
- 2
Sehr grosse APIs: Eine Beschreibung mit über tausend Operationen erzeugt ohne Filter ein Werkzeugverzeichnis, das Copilot schwer nutzt. Der Filter gehört hier zur Grundausstattung.
- 3
Auswahl bei vielen Werkzeugen: Je mehr Werkzeuge ein Connector anbietet, desto eher greift Copilot daneben. Weniger, klar beschriebene Werkzeuge treffen besser.
- 4
Ein Connector je Werkzeug: Der Hub verteilt nach Pfad. Für jede Fachanwendung braucht es einen eigenen Connector mit eigener Adresse.
Für Anwendungen mit eigenem MCP-Server verschwindet der Übersetzer aus der Kette. Dann bleibt der Hub, der die fertigen Werkzeuge verteilt. Den Aufbau dieser Anbindung mit OAuth für Copilot zeigt der Beitrag zum MCP-Proxy.
Häufige Fragen zu REST-API und MCP in Copilot
KPX-Services rund um Copilot und eigene Systeme
Wir binden eigene Systeme an Microsoft 365 Copilot an und betreuen die Anbindung im Betrieb:
Microsoft Copilot für KMU
Pilot, Connectoren zu 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.
Ihre 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 den Dokumentationen von Docbee, Microsoft und den drei genannten Projekten, Stand November 2026. Copilot-Connectoren und OpenAPI-Beschreibungen ändern sich regelmässig.
Themen
