Erstellen von Plug-Ins von einem MCP-Server für Microsoft 365 Copilot

Dieser Leitfaden führt Sie durch den Prozess der Integration Ihres Diensts in Microsoft 365 Copilot durch Hinzufügen eines MCP-Servers zu einem deklarativen Agent mithilfe des Microsoft 365 Agents Toolkit. Indem Sie diese Schritte ausführen, aktivieren Sie den konversationsbasierten, KI-gestützten Zugriff auf Ihre MCP-verfügbaren Dienste für Geschäftsbenutzer.

Voraussetzungen

Stellen Sie zunächst sicher, dass die folgenden Voraussetzungen erfüllt sind:

• Unter Anforderungen für Copilot-Erweiterbarkeitsoptionen angegebene Anforderungen
• Ein GitHub-Konto
• Visual Studio Code
• Microsoft 365 Agents Toolkit , Version 6.3.x oder höher

Erstellen des Agents

So erstellen Sie den Agent:

1. Öffnen Sie Visual Studio Code, und wählen Sie in der Aktivitätsleiste das Symbol Microsoft 365 Agents Toolkit aus.

2. Wählen Sie im Aufgabenbereich Agents Toolkit die Option Create a New Agent/App (Neuen Agent/Neue App erstellen) aus.

   

3. Wählen Sie Deklarativer Agent aus.

4. Wählen Sie Aktion hinzufügen und dann Mit einem MCP-Server starten aus.

5. Geben Sie die GitHub MCP-Server-URL https://api.githubcopilot.com/mcp/ein.

   

6. Wählen Sie einen Speicherort für das Agent-Projekt aus.

7. Geben Sie einen Namen für den Agent ein.

Nachdem Sie diese Schritte ausgeführt haben, generiert das Agents Toolkit die erforderlichen Dateien für den Agent und öffnet ein neues Visual Studio Code-Fenster, in dem das Agent-Projekt geladen wurde.

Hinzufügen von Tools vom MCP-Server

So fügen Sie Tools vom MCP-Server hinzu:

1. Öffnen Sie die Datei .vscode/mcp.json . Wählen Sie im Datei-Editor die Schaltfläche Start aus.

2. Wenn Sie zur Authentifizierung aufgefordert werden, wählen Sie Die Authentifizierung zulassen aus.

3. Wählen Sie im Datei-Editor die Schaltfläche ATK: Aktion aus MCP abrufen aus, und wählen Sie dann ai-plugin.json aus.

   

4. Wählen Sie Vorgänge aus, die der Agent verwenden soll. Wählen Sie für diese Übung search_repositories und search_users aus.

   

   Wichtig

   Tools und UX-Widgets von MCP-Remoteservern werden unterstützt. Weitere Informationen finden Sie unter Hinzufügen interaktiver UI-Widgets zu deklarativen Agents.

5. Wählen Sie OAuth (mit statischer Registrierung) als Authentifizierungstyp aus.

   

Registrieren einer OAuth-App bei GitHub

So registrieren Sie eine OAuth-App:

1. Wechseln Sie in Ihrem Browser zu https://github.com/settings/developers . Wählen Sie OAuth-Apps>Neue OAuth-App aus.

2. Fügen Sie einen Namen und eine Homepage-URL für Ihre App hinzu, und legen Sie als Autorisierungsrückruf-URL festhttps://teams.microsoft.com/api/platform/v1.0/oAuthRedirect. Wählen Sie Anwendung registrieren aus.

3. Nachdem die App erstellt wurde, wählen Sie Neuen geheimen Clientschlüssel generieren aus. Kopieren Sie das Geheimnis und die Client-ID , die im nächsten Abschnitt verwendet werden sollen.

Packen und Querladen des Agents

So packen Sie den Agent:

1. Öffnen Sie das Agent-Projekt in Visual Studio Code.

2. Wählen Sie in der linken Aktivitätsleiste das Symbol Microsoft 365 Agents Toolkit aus.

3. Wählen Sie im Bereich Konten die Option Bei Microsoft 365 anmelden aus. (Wenn Sie bereits angemeldet sind, fahren Sie mit dem nächsten Schritt fort.

4. Vergewissern Sie sich, dass sowohl benutzerdefinierter App-Upload aktiviert als auch Copilot-Zugriff aktiviert unter Ihrem Microsoft 365-Konto angezeigt werden. Wenn dies nicht der Fall ist, wenden Sie sich an Ihren organization Administrator. Ausführliche Informationen finden Sie unter Anforderungen für Copilot-Erweiterbarkeitsoptionen.

5. Wählen Sie im Bereich Lebenszyklus die Option Bereitstellen aus.

6. Wenn Sie zur Eingabe der Client-ID für die OAuth-Registrierung aufgefordert werden, geben Sie Ihre Client-ID ein.

7. Wenn Sie zur Eingabe des geheimen Clientschlüssels für die OAuth-Registrierung aufgefordert werden, geben Sie Ihren geheimen Clientschlüssel ein.

8. Wenn Sie nach Bereichen gefragt werden, drücken Sie die EINGABETASTE , um fortzufahren.

9. Lesen Sie die Nachricht im Dialogfeld, und wählen Sie Bestätigen aus, um den Vorgang fortzusetzen.

10. Warten Sie, bis das Toolkit meldet, dass die Bereitstellung abgeschlossen ist.

Verwenden des Agents

So verwenden Sie den Agent:

1. Navigieren Sie in Ihrem Browser zu https://m365.cloud.microsoft/chat.

2. Suchen Sie auf der Randleiste im Abschnitt Agents nach Ihrem Agent. Er wird als der Name aufgeführt, den Sie im Abschnitt Agent erstellen angegeben haben, und dev am Ende angefügt. Wählen Sie den Agent aus.

3. Bitten Sie den Agent, ein Repository oder einen Benutzer zu finden. Beispiel: can you find a repo for kiota?.

4. Wenn Sie dazu aufgefordert werden, wählen Sie Bei {agent-name} anmelden aus. Melden Sie sich im Popupfenster mit Ihrem GitHub-Konto an, und autorisieren Sie den Agent.

5. Wenn das Popupfenster geschlossen wird, gibt der Agent eine Antwort zurück.

   

Verwandte Inhalte

• Hinzufügen interaktiver UI-Widgets zu deklarativen Agents