Q.wiki Assistent per MCP in Microsoft Copilot bereitstellen

Modell Aachen liefert einen vorkonfigurierten Q.wiki Copilot-Agenten als ZIP-Datei. Du importierst ihn, verbindest ihn mit deinem Q.wiki und teilst ihn mit deinen Nutzern. Der Agent ist nach unserer Best Practice vorkonfiguriert – alles lässt sich nach dem Import anpassen.

Voraussetzungen

Ein Global Admin richtet alles ein – Endnutzer brauchen keine eigene Lizenz. Die Nutzung wird über vorhandene Microsoft-365-Copilot-Lizenzen oder Copilot Credits abgerechnet.

Download

Lade den vorkonfigurierten Agenten herunter und importiere ihn anschließend in Schritt 1.

Schritt 1: Lösung importieren

Die ZIP ist eine fertige Power-Platform-Lösung – der Q.wiki Assistent ist als Agent-Komponente bereits enthalten. Du legst keine neue Solution an, sondern importierst die ZIP über den Solution Explorer.

1. In copilotstudio.microsoft.com (extern) anmelden und oben rechts die Umgebung wählen, in die der Agent soll.
2. In der linken Navigation auf Solutions / Lösungen klicken. Falls das Icon nicht direkt sichtbar ist: über das „…" (Mehr)-Menü unten in der Sidebar einblenden.

3. Oben in der Toolbar auf Lösung importieren / Import solution klicken.
   

4. Im Import-Dialog: Durchsuchen → ZIP auswählen → Wizard mit Weiter bis Importieren durchklicken. Falls der Wizard nach Connection References oder Environment Variables fragt: leer lassen – der Q.wiki-MCP-Anschluss wird in Schritt 3 separat eingerichtet.
5. Status in der Glocke oben rechts beobachten – der Import läuft 1–5 Min. im Hintergrund. Warte das Banner „Erfolgreich" ab.

Schritt 2: Agent öffnen & prüfen

1. Im Solution Explorer die gerade importierte Lösung anklicken.
2. Links im Objects-Bereich auf Agents klicken.
3. „Q.wiki Assistent" anklicken – er öffnet sich in Copilot Studio.

Schritt 3: Q.wiki MCP-Tool hinzufügen

Die MCP-Verbindung ist tenant-spezifisch und daher bewusst nicht in der ZIP enthalten. Du legst sie einmalig in deinem Tenant an. Öffne im Agenten den Reiter Tools und wähle Tool hinzufügen / Add a tool → Neues Tool / New tool → Model Context Protocol.

Im Dialog „Modellkontextprotokoll-Server hinzufügen" folgende Werte eintragen:

Auf Create / Erstellen klicken. Es öffnet sich der Dialog „Add tool" mit zwei Schritten:

1. Connection: „Create a new connection" auswählen → im OAuth-Pop-up mit deinem Q.wiki-Account anmelden (bei Entra-SSO ohne Passwort).
2. Add to agent: nach erfolgreichem Login bestätigen.

Das Tool erscheint im Reiter mit Status „Verbunden".

Weitere Details zum MCP-Onboarding-Assistenten bei Microsoft: Connect your agent to an existing MCP server (extern).

Schritt 4: Testen

Klicke oben rechts auf Test – es öffnet sich der Testbereich. Stelle eine Frage, deren Antwort du in deinem Q.wiki kennst, z. B. zu einem Prozess, einer Rolle oder einer Arbeitsanweisung. Folgende drei Punkte sollten erfüllt sein:

• Das Q.wiki-Tool wird im Aktionsprotokoll sichtbar aufgerufen.
• Am Ende der Antwort erscheint ein Block „Quellen aus Q.wiki:" mit Links auf die genutzten Seiten.
• Die inhaltliche Antwort deckt sich mit den tatsächlichen Inhalten in deinem Q.wiki.

Schritt 5: Agent veröffentlichen (Publish)

1. Im Agenten oben rechts auf Publish klicken.
2. Im Bestätigungsdialog erneut Publish klicken.
3. Status wechselt zu „Published by …".

Schritt 6: Channel „Microsoft 365 and Microsoft Teams" hinzufügen

Damit der Agent in Microsoft 365 Copilot und Teams erscheinen kann, fügst du den kombinierten Kanal hinzu.

1. Im Agenten oben zum Reiter Channels wechseln.
2. Die Kachel „Microsoft 365 and Microsoft Teams" anklicken.
3. Im Seitenpanel im Abschnitt „Turn on Microsoft 365" ist die Checkbox „Make agent available in Microsoft 365 Copilot" standardmäßig aktiv – so belassen.
4. Unten rechts auf Add channel klicken.
5. Bestätigungs-Statusmeldung abwarten.
   

Schritt 7: Zur Freigabe einreichen

Nach dem Hinzufügen des Kanals erscheint im Seitenpanel der Button „Availability options". Damit beantragst du, dass der Agent in Microsoft 365 Copilot und im Teams-App-Store deiner Organisation freigeschaltet wird.

1. Im selben Side Panel auf Availability options klicken.
2. Es öffnet sich das Panel „Show in Teams app store for org". Gehe folgende Abschnitte durch:
   • Microsoft Teams + admin status: zeigt Version und Freigabe-Status – springt auf „Waiting for approval", sobald du eingereicht hast.
   • Set your agent reach: bestätigt, dass der Agent in allen verfügbaren Channels verfügbar gemacht wird – keine Auswahl nötig.
   • Before submitting, make sure you've …: Pre-Submit-Checkliste – Agent kürzlich publisht (Schritt 5 ✓), Authentifizierung konfiguriert (in der ZIP bereits gesetzt ✓).
   • Teams Authentication SSO Configuration: zeigt die App ID deines Agenten. Über das Kopier-Icon rauskopieren – damit kann der Admin den Agenten in Schritt 8 eindeutig zuordnen.
3. Unten rechts auf Submit to org catalog klicken.
4. Status wechselt zu „Your agent is submitted and waiting for approval from your Teams admin".
   

Schritt 8: Im Admin Center freigeben & Audience festlegen

Im Microsoft 365 Admin Center (extern) wartet die Freigabe-Anfrage. Du entscheidest hier, wer den Agenten installieren darf und wem er automatisch ausgerollt wird.

1. admin.microsoft.com (extern) öffnen.
2. Sidebar: Agents → All agents → Reiter Requests.
3. Q.wiki Assistent in der Liste anklicken – rechts öffnet sich das Detail-Panel. (Bei mehreren wartenden Agenten: Zuordnung über die in Schritt 7 kopierte App ID.)
4. Oben rechts auf Publish to store klicken.
   

Es öffnet sich der Wizard „Publish agent to selected users":

1. Select users– zwei Auswahlbereiche:
   • Select users or groups who can install the agent: All users für den gesamten Tenant oder Specific users/groups für eine Pilotgruppe.
   • Select users or groups who will have the agent pre-installed (optional): All users = automatisches Anpinnen in Teams; None = Nutzer installieren ihn selbst.
2. Apply template – Sicherheits- und Datenschutz-Policy auswählen.
3. Accept permissions – Admin-Consent für die vom Agenten benötigten API-Berechtigungen bestätigen.
4. Review and finish – Zusammenfassung prüfen und mit Finish abschließen.

Schritt 9: Für Endnutzer – Agent finden & nutzen

Nach der Freigabe (ggf. bis zu 24 Std. Wartezeit, siehe Troubleshooting) können deine Nutzer den Agenten an zwei Stellen öffnen.

In Microsoft 365 Copilot

1. Microsoft 365 Copilot öffnen – über m365.cloud.microsoft/chat (extern), die Microsoft-365-Copilot-App oder Copilot in Teams.
2. In der Seitenleiste im Abschnitt Agents den Q.wiki-Agenten anklicken. Falls er dort noch nicht auftaucht: auf Weitere Agents klicken – im Agents-Store steht er im Abschnitt „Erstellt von Ihrer Organisation".

In Microsoft Teams

1. In Teams links auf Apps klicken, nach „Q.wiki Assistent" suchen (Bereich „Für Ihre Organisation erstellt") und Hinzufügen wählen. Wenn du in Schritt 8 Pre-installed: All users gewählt hast, entfällt das – der Agent ist bereits in der Teams-Seitenleiste angepinnt.
2. Der Agent erscheint im Chat-Bereich und lässt sich dort wie ein Kontakt anschreiben.

Erste Nutzung: einmalig mit Q.wiki verbinden

Bei der ersten Frage fordert der Agent zur Anmeldung auf. Jeder Nutzer meldet sich einmalig mit seinem eigenen Q.wiki-Account an (bei Entra-SSO ohne Passworteingabe). Danach kann er direkt loslegen – zum Einstieg helfen die mitgelieferten Conversation Starter.

Troubleshooting

Verwandte Artikel

• Q.wiki MCP-Server – Überblick & Endpoint