Als je klaar bent
Een agent die je bouwt in Microsoft Copilot Studio en gebruikt in Microsoft 365 Copilot of Teams, kan met BrickDb werken, ingelogd met het eigen BrickDb-account van ieder persoon.
De stappen
- BrickDb als hulpmiddel toevoegen in Copilot Studio
- Stuur ons de redirect-URL
- De verbinding maken en de agent publiceren
- Microsoft 365 Copilot: een declaratieve agent
- BrickDb ontkoppelen
Je hebt een gratis BrickDb-account nodig. De koppeling werkt alleen voor geregistreerde leden die inloggen; zonder inloggen is niets beschikbaar, zelfs het zoeken in de catalogus niet. Heb je nog geen account, open dan je accountpagina en maak er een aan op de inlogpagina die opent. Koppel je zonder in te loggen, dan toont de agent BrickDb als niet gekoppeld of vraagt je in te loggen, en is geen enkel hulpmiddel van BrickDb te gebruiken.
De agent werkt met je BrickDb-account en je rechten, en niets meer: alleen wat jij in BrickDb ziet is bereikbaar, en alleen wat jij mag wijzigen kan worden gewijzigd. Wat je in BrickDb laat opzoeken, wordt deel van je gesprek en gaat naar Microsoft, dat het volgens zijn eigen voorwaarden verwerkt. BrickDb stuurt uit zichzelf niets naar Microsoft.
Wat er vandaag kan:
- in de catalogus zoeken en een set openen;
- laten zien waarvoor een set verkocht wordt, en op hoeveel verkopen dat getal berust;
- je collectie lezen, een exemplaar toevoegen, de staat of notities ervan wijzigen en een exemplaar verwijderen (verwijderen vraagt het setnummer als bevestiging);
- de onderdelen opsommen die je bezit en de waarde van je collectie berekenen;
- zeggen wat een gescande zakjescode van een minifiguur is, en vastleggen wat je in een zakje vond;
- je eigen MOC's en de openbare MOC-galerij lezen.
Met een beheerdersaccount zijn bovendien de hulpmiddelen van het beheergedeelte beschikbaar, omdat het account die rol heeft. Meer van BrickDb, zoals het verlanglijstje, minifiguren en foto's, volgt stap voor stap.
Namen van menu's en knoppen staan hier zoals ze in het Engels heten; in jouw taal kunnen ze anders luiden.
Deze handleiding is voor Microsoft Copilot Studio, waar organisaties hun eigen agents bouwen en publiceren in Microsoft 365 Copilot en Teams. Je organisatie heeft daarvoor Copilot Studio nodig. Voor de gratis Microsoft Copilot-app kennen we geen manier om een eigen server toe te voegen. Wie met de agent chat, logt in met het eigen BrickDb-account, en de agent handelt dan met de rechten van die persoon.
Copilot Studio geeft elke verbinding een eigen terugkeeradres, dat het inloggen bij BrickDb eerst moet toestaan voordat iemand kan inloggen. Daarom is de tweede stap een bericht aan ons.
BrickDb als hulpmiddel toevoegen in Copilot Studio
- Open je agent in Copilot Studio, of maak er een aan onder Create → New agent.
- Open Tools, kies Add a tool, dan New tool en Model Context Protocol.
- Vul als servernaam
BrickDbin, een beschrijving waarvoor hij dient, en de server-URLhttps://mcp.brickdb.net/mcp. - Kies onder Authentication voor OAuth 2.0 en het type Manual, en vul in: client-ID
Pin3wgdbREmDTblSI02tEiX40vAOD5hL; client secret leeg; authorization URLhttps://auth.brickdb.net/authorize; token URL template en refresh URL allebeihttps://auth.brickdb.net/oauth/token; scopesopenid profile email offline_access. - Kies Create. Copilot Studio toont een redirect URL: kopieer die en kies daarna Next.
Stuur ons de redirect-URL
Stuur de redirect-URL via het hulpformulier en vermeld dat hij voor Copilot Studio is. Wij voegen hem toe aan het inloggen bij BrickDb en laten het je weten. Tot dan eindigt het inloggen op een foutpagina, en is niets half gekoppeld.
De verbinding maken en de agent publiceren
- Kies in het venster Add tool voor Create new connection, dan Create, en log op de inlogpagina van BrickDb in met je BrickDb-account.
- Kies Add and configure.
- Om de agent in Microsoft 365 Copilot of Teams te gebruiken, publiceer je hem en voeg je onder Channels het kanaal Teams and Microsoft 365 Copilot toe.
De eigen pagina van Microsoft: Connect your agent to an existing Model Context Protocol server.
Microsoft 365 Copilot: een declaratieve agent
Bouwt je organisatie een declaratieve agent voor Microsoft 365 Copilot met een MCP-plug-in (bijvoorbeeld met de Microsoft 365 Agents Toolkit), registreer OAuth daarvoor dan statisch: client-ID Pin3wgdbREmDTblSI02tEiX40vAOD5hL, geen client secret, PKCE aan, authorization URL https://auth.brickdb.net/authorize, token- en refresh-URL https://auth.brickdb.net/oauth/token, scopes openid profile email offline_access. Het terugkeeradres is vast en het inloggen bij BrickDb staat het al toe, dus je hoeft ons niets te sturen: wie de agent gebruikt, logt in met het eigen BrickDb-account.
BrickDb ontkoppelen
Verwijder het hulpmiddel BrickDb uit de agent onder Tools en verwijder de verbinding ervan in Copilot Studio. De agent kan BrickDb daarna met niemands account meer bereiken.
Eindigt het inloggen op een foutpagina, of werkt er iets anders niet, schrijf ons dan via het hulpformulier.