IT-WissenREST-API als MCP-Server für Copilot

REST-API als MCP-Server für Copilot

KPX AG
16. November 2026
13 Min. Lesezeit

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

WegAufwandPflegeGrenzen
OpenAPI-ÜbersetzerEin Container mit StartparameternFolgt der Beschreibung der APILiefert nur das, was die Beschreibung hergibt
Workflow mit MCP-Server-TriggerAbläufe in n8n zusammenbauenJeder Ablauf einzelnErlaubt nur vorbereitete Aktionen
Eigener CodeProgrammieren und TestenJede Änderung an der API im CodeVolle 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.

Ein Hub verteilt Copilot-Anfragen auf viele WerkzeugeWaagerechte Kette aus drei Kacheln: Copilot Chat, Proxy mit Schild und Hub als Verteiler. Vom Hub führt eine Sammelschiene nach unten zu den Kacheln MCP-Server, OpenAPI-Übersetzer mit Pfeil auf REST-API und MCP-Server.Ein Hub verteilt auf viele WerkzeugeCopilot ChatProxyHubMCP-ServerREST-APIOpenAPI-ÜbersetzerMCP-Server
Copilot Chat erreicht über Proxy und Hub mehrere Werkzeuge, darunter einen OpenAPI-Übersetzer vor der REST-API.

Der Hub verteilt die Anfragen nach Pfad. Jedes Ziel erhält einen eigenen Pfad, im Beispiel //mcp. Der Hub setzt für jedes Ziel den passenden Token und hält die Schlüssel getrennt. Ein Wechsel der Fachanwendung betrifft damit nur den Hub und nicht jedes Werkzeug einzeln.

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-ServerDocbee-REST-API
19 Werkzeuge, kuratiert1'098 Operationen auf 601 Pfaden, Stand Version 2026.2.0
Tickets anlegen, ändern und suchen, Nachrichten, Tags, Leistungen, Tätigkeiten, Protokolle, Tagesagenda, BenachrichtigungenDer volle Funktionsumfang der Anwendung, ohne Filter
Adresse https://docbee.example.ch/mcpBeschreibung 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äuftAnmeldung ü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.

1. Hub und Übersetzer bereitstellen
  • 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>
2. Anmeldung für Copilot einrichten
  • 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
3. Connector anlegen und prüfen
  • 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

SymptomUrsacheLösung
404 bei //mcp, das Hub-Log meldet «server returned 4xx for initialize POST»Die Variable mit der Adresse enthielt bereits den Pfad /mcp. Daraus entstand /mcp/mcpNur die Domain in die Variable schreiben, den Pfad setzt der Hub
Die Anmeldung scheitert mit invalid_scopeCopilot sendet beim Anmelden immer den Scope openid mit. Der Client war per Dynamic Client Registration ohne diesen Scope angelegtDen Client mit dem Scope openid registrieren und die Registrierung wiederholen
Der Server bleibt im Connector unsichtbarDer Hub bindet die Server nur beim Start einNach 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

Ihre Fachanwendung soll in Copilot Chat erscheinen? Wir prüfen im Gratis Erstgespräch, welcher Anbindungsweg zu Ihren Systemen passt.

Jetzt Ihre individuelle Erstanalyse

Die 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

REST API MCPOpenAPI MCP ServerREST API in CopilotMCP ConnectorMicrosoft 365 CopilotDocbee
Nächster Schritt

Wissen schafft Sicherheit – Handeln schafft Resultate.

Lernen Sie uns in einem unverbindlichen Erstgespräch kennen. Wir hören zu, verstehen Ihre Situation und zeigen Ihnen konkret auf, wie wir das Beschriebene für Ihr Unternehmen umsetzen können.