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.
Die Schritte
- BrickDb als Werkzeug in Copilot Studio hinzufügen
- Schick uns die Redirect-URL
- Verbindung anlegen und den Agenten veröffentlichen
- Microsoft 365 Copilot: ein deklarativer Agent
- 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
- Öffne deinen Agenten in Copilot Studio oder lege unter Create → New agent einen an.
- Öffne Tools, wähle Add a tool, dann New tool und Model Context Protocol.
- Gib als Servernamen
BrickDbein, eine Beschreibung, wofür er da ist, und die Server-URLhttps://mcp.brickdb.net/mcp. - Wähle unter Authentication die Option OAuth 2.0 und den Typ Manual und trag ein: Client-ID
Pin3wgdbREmDTblSI02tEiX40vAOD5hL; Client Secret leer; Authorization URLhttps://auth.brickdb.net/authorize; Token URL Template und Refresh URL beidehttps://auth.brickdb.net/oauth/token; Scopesopenid profile email offline_access. - 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
- 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.
- Wähle Add and configure.
- 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.