MCP-Server erstellen oder wiederverwenden

Verwenden Sie die MCP-Serverentscheidung aus Ihrem Komponentenplan, um remote gehostete Tools oder Ressourcen bereitzustellen. Der ausgeführte MCP-Server bleibt vom Plug-In-Paket getrennt, sodass Sie sowohl die Remotelaufzeit als auch die unterstützte Verbindung mit der Microsoft-Zielumgebung implementieren oder bestätigen müssen.

Wiederverwenden eines MCP-Servers

Vor dem Erstellen eines Servers:

  1. Identifizieren Sie einen genehmigten MCP-Server, der die erforderlichen Tools oder Ressourcen verfügbar macht.
  2. Überprüfen Sie die Tooldefinitionen, Eingaben, Ausgaben, Fehler, Anmerkungen und das Bestätigungsverhalten.
  3. Vergewissern Sie sich, dass die Transport-, Authentifizierungsmodell- und Protokollfeatures von der Microsoft-Zielanwendung unterstützt werden.
  4. Bestätigen Sie den Serverbesitzer, den Endpunkt, die Version, die Verfügbarkeit, die Datenverarbeitung, den Support und den Änderungsprozess.
  5. Erhalten Sie Zugriff und konfigurieren Sie die Entwicklungs- oder Testverbindung.
  6. Testen Sie repräsentative Ermittlungs-, Authentifizierungs-, Aufruf- und Fehlerszenarien.

Durch das Verweisen auf einen MCP-Server wird die Verantwortung für dessen Betrieb nicht übertragen. Notieren Sie den Dienstbesitzer und die Supportvereinbarung, bevor Sie sie wiederverwenden.

Aufbau und Betrieb eines MCP-Servers

Erstellen Sie einen neuen MCP-Server, wenn kein genehmigter Server die Anforderung erfüllt.

  1. Implementieren Sie nur die Tools und Ressourcen, die für den Komponentenplan erforderlich sind.
  2. Definieren Sie klare Namen, Beschreibungen, Eingaben, Ausgänge, Fehler und Sicherheitsanmerkungen.
  3. Implementieren Sie Authentifizierung, Autorisierung, Datenzugriff und Verhalten mit den geringsten Berechtigungen.
  4. Konfigurieren Sie Hosting, Netzwerk, Geheimnisse, Protokollierung, Überwachung, Skalierung und Reaktion auf Vorfälle.
  5. Versionsprüfung, Protokollverhalten und dokumentieren Sie die Kompatibilitätserwartungen.
  6. Testen Sie den Server unabhängig voneinander, bevor Sie ihn mit einer Microsoft-Benutzeroberfläche verbinden.

GitHub Copilot kann Sie bei Servercode, Schemas, Tests und Repositoryänderungen unterstützen. Es stellt die MCP-Laufzeit, das Hosting, die Authentifizierung oder die Microsoft 365-Verbindung nicht selbst bereit.

Verbinden Sie den Server

Verwenden Sie die Integration, die vom ausgewählten Entwicklungstool und der ausgewählten Zielerfahrung unterstützt wird.

Hinweis

Verwenden Sie WIQD, um ein Plug-In zu erstellen, das auf einen Remote-MCP-Server verweist. Informationen zur manuellen Konfiguration über das agentConnectors Array im Microsoft 365-App-Manifest finden Sie unter Konfigurieren von MCP-Remoteservern für Microsoft 365 Copilot-Plug-Ins. Diese Konfiguration unterscheidet sich vom MCP-Plug-In-Manifest, das für deklarative Agent-Aktionen verwendet wird. Der Support hängt von der Zielerfahrung ab.

Entwicklungsansatz Beginnen mit
Work IQ Dev Tools (empfohlen für unterstützte Pro-Code-Szenarien) Erstellen Sie ein Plugin mit Work IQ Dev Tools; für eine Agentaktion verwenden Sie den WIQD-Agentenaktionsworkflow
Vorhandenes Projekt eines deklarativen Agents mit Agents Toolkit Toolkitbasierte MCP-Integration – Exemplarische Vorgehensweise
Copilot Studio Dokumentation zu Microsoft Copilot Studio
Interaktive MCP-Antwort Hinzufügen von MCP-Apps zu deklarativen Agents
BYO-Remote-MCP-Serverregistrierung mit Agent 365 CLI Registrieren eines Remote-MCP-Servers in Agent-Tools

Wichtig

Die Agent 365 CLI BYO MCP-Route befindet sich in der Vorschau und verwendet ein separates Registrierungs- und Verwaltungsmodell von einem MCP-Plug-In, das für einen deklarativen Microsoft 365-Agent gepackt wurde. Die dokumentierten unterstützten Clients sind Copilot Studio, Visual Studio Code, Claude Code und GitHub Copilot CLI. Microsoft 365 declarative Agents werden von dieser Route nicht unterstützt. Administratoren verwenden Agent-Tools, um den registrierten Server zu überprüfen, zu genehmigen, zuzustimmen, zu blockieren und zu überwachen.

Work IQ Dev Tools

Der wiqd plugin add connector Befehl fügt einem WIQD-Plug-In-Paket einen Remote-MCP-Connector hinzu. Zu den dokumentierten Serveranforderungen gehören:

  • HTTPS mit TLS 1.2 oder höher.
  • Streambarer HTTP-Transport mit JSON-RPC 2.0.
  • Unterstützung für tools/list und tools/call.
  • Tool-Aufrufe, die in weniger als 30 Sekunden abgeschlossen werden.

WIQD-Gerüste für Manifestversion 1.29, wobei mcpToolDescription der Wert optional ist. Wenn Sie eine Toolbeschreibungsdatei einschließen, übergeben Sie den Pfad relativ zu appPackage mit wiqd plugin add connector --tool-description <relative-file-path> neben den erforderlichen Verbinderoptionen. Die referenzierte Datei muss in der ZIP-Datei enthalten sein. Informationen zum aktuellen Verhalten und zu Paketanforderungen für Cowork finden Sie unter Build-Plug-Ins für Copilot Cowork.

Registrieren Sie für die OAuth- oder API-Schlüssel-Authentifizierung zuerst die Anmeldeinformationen und fügen Sie dem Paket nur ihren Referenzbezeichner hinzu. Fügen Sie keine geheimen Clientschlüssel, API-Schlüssel oder Token in das Manifest ein. Weitere Informationen finden Sie in der Referenz zum WIQD-Plug-In-Authoring.

Konfigurieren Sie für die WIQD-Plug-In-Paket-Route die Authentifizierung und die Toolermittlung im Microsoft 365-App-Manifest. Wenn Sie den Server stattdessen als MCP-Aktion zu einem deklarativen Agent hinzufügen, verwenden Sie die Authentifizierung der Agent-Aktion und die dynamische Ermittlung oder angeheftete Tools für den Agenten. Folgen Sie den Anforderungen der ausgewählten Integration, anstatt die Konfiguration zwischen Manifestmodellen zu kopieren.

Überprüfen, ob die MCP-Funktion funktioniert

Der MCP-Server und seine Verbindung sind bereit für die Integration, wenn:

  • Der Endpunkt ist in der Entwicklungs- oder Testumgebung verfügbar.
  • Erforderliche Tools oder Ressourcen können von der Ziel-Erfahrung ermittelt werden.
  • Repräsentative Operationen geben die erwarteten strukturierten Ergebnisse zurück.
  • Authentifizierung, Autorisierung, Zustimmung und Berechtigungen funktionieren wie vorgesehen.
  • Das Verhalten von Bestätigung, Timeout, nicht verfügbarem Dienst, ungültiger Eingabe und Teilfehlern ist verständlich.
  • Protokolle und Überwachung bieten genügend Informationen, um Fehler zu diagnostizieren.
  • Serverbesitzer, Version, Endpunkt, Hosting, Abhängigkeiten, Einschränkungen und Testnachweise werden aufgezeichnet.

Verwenden Sie lokales MCP- und API-Debugging , wenn der Server während der Entwicklung nicht öffentlich erreichbar ist.

Fahren Sie mit allen anderen Komponenten im Plan fort. Wenn sie fertig sind, integrieren und testen Sie Ihre Komponenten.