Saltar al contenido principal

Usar BrickDb desde Microsoft Copilot

Cuando termines

Un agente que creas en Microsoft Copilot Studio y usas en Microsoft 365 Copilot o Teams puede trabajar con BrickDb, con la sesión de la cuenta de BrickDb de cada persona.

Unos 15 minutos

Empezar

Los pasos

  1. Añadir BrickDb como herramienta en Copilot Studio
  2. Envíanos la URL de redirección
  3. Crear la conexión y publicar el agente
  4. Microsoft 365 Copilot: un agente declarativo
  5. Desconectar BrickDb

Necesitas una cuenta gratuita de BrickDb. La conexión solo funciona para miembros registrados que inician sesión; sin iniciar sesión no hay nada disponible, ni siquiera la búsqueda en el catálogo. Si aún no tienes cuenta, abre tu página de cuenta y crea una en la página de inicio de sesión que se abre. Si te conectas sin iniciar sesión, el agente muestra BrickDb como no conectado o te pide que inicies sesión, y no se puede usar ninguna de las herramientas de BrickDb.

El agente trabaja con tu cuenta de BrickDb y tus permisos, y nada más: solo es accesible lo que ves en BrickDb, y solo se puede cambiar lo que tú puedes cambiar. Lo que pides consultar en BrickDb pasa a formar parte de tu conversación y se envía a Microsoft, que lo trata según sus propias condiciones. BrickDb no envía nada por su cuenta a Microsoft.

Lo que se puede hacer hoy:

  • buscar en el catálogo y abrir un set;
  • mostrar por cuánto se vende un set, y en cuántas ventas se basa la cifra;
  • leer tu colección, añadir un ejemplar, cambiar su estado o sus notas y quitar un ejemplar (quitarlo pide el número del set como confirmación);
  • listar las piezas que tienes y calcular cuánto vale tu colección;
  • decir qué es un código escaneado de una bolsa de minifigura, y registrar lo que encontraste en una bolsa;
  • leer tus propios MOC y la galería pública de MOC.

Una cuenta de administrador llega además a las herramientas del área de administración, porque la cuenta tiene ese rol. Más partes de BrickDb, como la lista de deseos, las minifiguras y las fotos, irán llegando paso a paso.

Los nombres de menús y botones aparecen aquí como se llaman en inglés; en tu idioma pueden ser otros.

Esta guía es para Microsoft Copilot Studio, donde las organizaciones crean sus propios agentes y los publican en Microsoft 365 Copilot y Teams. Tu organización necesita Copilot Studio. No conocemos ninguna forma de añadir un servidor propio a la aplicación gratuita Microsoft Copilot. Quien chatea con el agente inicia sesión con su propia cuenta de BrickDb, y el agente actúa con los permisos de esa persona.

Copilot Studio da a cada conexión su propia dirección de retorno, que el inicio de sesión de BrickDb tiene que permitir antes de que nadie pueda iniciar sesión. Por eso el segundo paso es un mensaje para nosotros.

Añadir BrickDb como herramienta en Copilot Studio

  1. Abre tu agente en Copilot Studio, o crea uno en Create → New agent.
  2. Abre Tools, elige Add a tool, después New tool y Model Context Protocol.
  3. Escribe el nombre del servidor BrickDb, una descripción de para qué sirve y la URL del servidor https://mcp.brickdb.net/mcp.
  4. En Authentication, elige OAuth 2.0 y el tipo Manual, y rellena: ID de cliente Pin3wgdbREmDTblSI02tEiX40vAOD5hL; secreto de cliente vacío; authorization URL https://auth.brickdb.net/authorize; token URL template y refresh URL ambas https://auth.brickdb.net/oauth/token; scopes openid profile email offline_access.
  5. Elige Create. Copilot Studio muestra una redirect URL: cópiala y después elige Next.

Envíanos la URL de redirección

Envía la URL de redirección a través del formulario de ayuda e indica que es para Copilot Studio. La añadimos al inicio de sesión de BrickDb y te avisamos. Hasta entonces, el inicio de sesión termina en una página de error, y nada queda conectado a medias.

Crear la conexión y publicar el agente

  1. En el cuadro Add tool, elige Create new connection, después Create, e inicia sesión en la página de inicio de sesión de BrickDb con tu cuenta de BrickDb.
  2. Elige Add and configure.
  3. Para usar el agente en Microsoft 365 Copilot o Teams, publícalo y añade el canal Teams and Microsoft 365 Copilot en Channels.

La página de Microsoft: Connect your agent to an existing Model Context Protocol server.

Microsoft 365 Copilot: un agente declarativo

Si tu organización crea un agente declarativo para Microsoft 365 Copilot con un plugin MCP (por ejemplo, con Microsoft 365 Agents Toolkit), registra OAuth para él de forma estática: ID de cliente Pin3wgdbREmDTblSI02tEiX40vAOD5hL, sin secreto de cliente, PKCE activado, authorization URL https://auth.brickdb.net/authorize, URL de token y de actualización https://auth.brickdb.net/oauth/token, scopes openid profile email offline_access. Su dirección de retorno es fija y el inicio de sesión de BrickDb ya la permite, así que no tienes que enviarnos nada: quien usa el agente inicia sesión con su propia cuenta de BrickDb.

Desconectar BrickDb

Quita la herramienta BrickDb del agente en Tools y elimina su conexión en Copilot Studio. El agente ya no puede llegar a BrickDb con la cuenta de nadie.

Si el inicio de sesión termina en una página de error, o algo más no funciona, escríbenos a través del formulario de ayuda.

Empezar Volver a las guías

Se ha producido un error no controlado. Recargar 🗙

Reconectando con el servidor...

No se pudo reconectar. Nuevo intento en segundos.

No se pudo volver a conectar. Inténtalo de nuevo o recarga la página.

El servidor ha pausado la sesión.

No se pudo reanudar la sesión. Recarga la página.