Zum Hauptinhalt springen

BrickDb in Microsoft Copilot nutzen

Wenn du fertig bist

Ein Agent, den du in Microsoft Copilot Studio baust und in Microsoft 365 Copilot oder Teams nutzt, kann mit BrickDb arbeiten, angemeldet mit dem eigenen BrickDb-Konto jeder Person.

Etwa 15 Minuten

Leg los

Die Schritte

  1. BrickDb als Werkzeug in Copilot Studio hinzufügen
  2. Schick uns die Redirect-URL
  3. Verbindung anlegen und den Agenten veröffentlichen
  4. Microsoft 365 Copilot: ein deklarativer Agent
  5. BrickDb trennen

Du brauchst ein kostenloses BrickDb-Konto. Die Verbindung funktioniert nur für registrierte Mitglieder, die sich anmelden; ohne Anmeldung ist nichts verfügbar, nicht einmal die Suche im Katalog. Wenn du noch kein Konto hast, öffne deine Kontoseite und lege auf der Anmeldeseite, die sich öffnet, eins an. Verbindest du dich ohne Anmeldung, zeigt der Agent BrickDb als nicht verbunden an oder bittet dich, dich anzumelden, und keines der Werkzeuge von BrickDb lässt sich nutzen.

Der Agent arbeitet mit deinem BrickDb-Konto und deinen Rechten, mehr nicht: Erreichbar ist nur, was du in BrickDb siehst, und änderbar nur, was du ändern kannst. Was du in BrickDb nachschlagen lässt, wird Teil deines Gesprächs und geht an Microsoft; dort gelten die eigenen Bedingungen des Anbieters. BrickDb schickt von sich aus nichts an Microsoft.

Was heute geht:

  • im Katalog suchen und ein Set öffnen;
  • zeigen, wofür ein Set verkauft wird, und auf wie vielen Verkäufen die Zahl beruht;
  • deine Sammlung lesen, ein Exemplar hinzufügen, seinen Zustand oder seine Notizen ändern und ein Exemplar entfernen (zum Entfernen musst du die Setnummer bestätigen);
  • die Teile auflisten, die du besitzt, und den Wert deiner Sammlung berechnen;
  • sagen, was ein gescannter Minifiguren-Beutelcode ist, und festhalten, was du in einem Beutel gefunden hast;
  • deine eigenen MOCs und die öffentliche MOC-Galerie lesen.

Mit einem Administratorkonto stehen außerdem die Werkzeuge des Adminbereichs zur Verfügung, weil das Konto diese Rolle hat. Weitere Teile von BrickDb, etwa die Wunschliste, Minifiguren und Fotos, kommen nach und nach dazu.

Die Namen von Menüs und Schaltflächen stehen hier so, wie sie auf Englisch heißen; in deiner Sprache können sie anders lauten.

Diese Anleitung ist für Microsoft Copilot Studio, wo Organisationen eigene Agenten bauen und in Microsoft 365 Copilot und Teams veröffentlichen. Dafür braucht deine Organisation Copilot Studio. Für die kostenlose Microsoft-Copilot-App kennen wir keinen Weg, einen eigenen Server hinzuzufügen. Wer mit dem Agenten chattet, meldet sich mit dem eigenen BrickDb-Konto an, und der Agent handelt dann mit den Rechten dieser Person.

Copilot Studio gibt jeder Verbindung eine eigene Rücksprungadresse, die die Anmeldung von BrickDb erst erlauben muss, bevor sich jemand anmelden kann. Deshalb ist der zweite Schritt eine Nachricht an uns.

BrickDb als Werkzeug in Copilot Studio hinzufügen

  1. Öffne deinen Agenten in Copilot Studio oder lege unter Create → New agent einen an.
  2. Öffne Tools, wähle Add a tool, dann New tool und Model Context Protocol.
  3. Gib als Servernamen BrickDb ein, eine Beschreibung, wofür er da ist, und die Server-URL https://mcp.brickdb.net/mcp.
  4. Wähle unter Authentication die Option OAuth 2.0 und den Typ Manual und trag ein: Client-ID Pin3wgdbREmDTblSI02tEiX40vAOD5hL; Client Secret leer; Authorization URL https://auth.brickdb.net/authorize; Token URL Template und Refresh URL beide https://auth.brickdb.net/oauth/token; Scopes openid profile email offline_access.
  5. Wähle Create. Copilot Studio zeigt eine Redirect URL: Kopiere sie und wähle dann Next.

Schick uns die Redirect-URL

Schick die Redirect-URL über das Hilfeformular und schreib dazu, dass sie für Copilot Studio ist. Wir tragen sie bei der Anmeldung von BrickDb ein und sagen dir Bescheid. Bis dahin endet die Anmeldung auf einer Fehlerseite, und nichts ist halb verbunden.

Verbindung anlegen und den Agenten veröffentlichen

  1. Wähle im Dialog Add tool die Option Create new connection, dann Create, und melde dich auf der Anmeldeseite von BrickDb mit deinem BrickDb-Konto an.
  2. Wähle Add and configure.
  3. Um den Agenten in Microsoft 365 Copilot oder Teams zu nutzen, veröffentliche ihn und füge unter Channels den Kanal Teams and Microsoft 365 Copilot hinzu.

Die eigene Seite von Microsoft: Connect your agent to an existing Model Context Protocol server.

Microsoft 365 Copilot: ein deklarativer Agent

Baut deine Organisation einen deklarativen Agenten für Microsoft 365 Copilot mit einem MCP-Plugin (zum Beispiel mit dem Microsoft 365 Agents Toolkit), registriere OAuth dafür statisch: Client-ID Pin3wgdbREmDTblSI02tEiX40vAOD5hL, kein Client Secret, PKCE an, Authorization URL https://auth.brickdb.net/authorize, Token- und Refresh-URL https://auth.brickdb.net/oauth/token, Scopes openid profile email offline_access. Seine Rücksprungadresse ist fest, und die Anmeldung von BrickDb erlaubt sie schon, deshalb musst du uns nichts schicken: Wer den Agenten nutzt, meldet sich mit dem eigenen BrickDb-Konto an.

BrickDb trennen

Entferne das Werkzeug BrickDb unter Tools aus dem Agenten und lösche seine Verbindung in Copilot Studio. Danach kann der Agent BrickDb mit niemandes Konto mehr erreichen.

Wenn die Anmeldung auf einer Fehlerseite endet oder etwas anderes nicht klappt, schreib uns über das Hilfeformular.

Leg los Zurück zu den Anleitungen

Ein unbehandelter Fehler ist aufgetreten. Neu laden 🗙

Verbindung zum Server wird wiederhergestellt ...

Verbindung fehlgeschlagen. Nächster Versuch in Sekunden.

Die Verbindung konnte nicht wiederhergestellt werden. Versuche es noch einmal oder lade die Seite neu.

Der Server hat die Sitzung angehalten.

Die Sitzung konnte nicht fortgesetzt werden. Bitte lade die Seite neu.