Este artículo explica cómo conectar Microsoft Copilot al conector de IA de R2 Docuo, para poder consultar el contenido de tu repositorio desde un agente de Copilot.
Antes de empezar, un administrador de tu repositorio tiene que haber activado el conector y haberte concedido el acceso. Consulta Requisitos y activación del conector de IA.
Cómo funciona en Copilot
Copilot trata los servidores MCP de una forma distinta a los demás asistentes: no se añaden a la aplicación de Copilot, sino a un agente creado en Copilot Studio. Es decir, montas un agente —por ejemplo Consultas de documentación— y le das el conector de R2 Docuo como herramienta. Después usas ese agente desde Copilot o desde Teams.
Es un paso más que en Claude o ChatGPT, pero tiene una ventaja: el agente se puede compartir con un equipo con sus instrucciones ya escritas.
Qué necesitas
- Una cuenta de R2 Docuo de usuario contratado, con «Acceso por MCP» concedido, y tu contraseña.
- Acceso a Copilot Studio con permisos para crear agentes y herramientas en tu entorno de Power Platform.
- La dirección del servidor:
https://mcp.r2docuo.com
Solicitar el identificador y el secreto de cliente
La mayoría de los asistentes se dan de alta solos en nuestro servidor de autorización y no hace falta configurarles nada. Copilot no lo hace: el conector que crea en Power Platform te pedirá un identificador de cliente y un secreto de cliente de OAuth.
Esas credenciales las emitimos nosotros a petición tuya:
- Abre un ticket de soporte desde tu cuenta de R2 Docuo.
- Indica que necesitas credenciales de cliente fijas para el servidor MCP, para qué asistente son —en este caso Copilot— y sobre qué repositorio vas a trabajar.
- Te devolveremos un identificador y un secreto por esa misma vía.
No necesitas aportar la URL de retorno: la pone Copilot y el servidor acepta la que traiga.
El identificador y el secreto identifican al asistente, no a una persona: no sustituyen la autorización nominal. Quien conecte sigue identificándose con su cuenta de R2 Docuo en la pantalla de acceso.
El secreto de cliente es una contraseña de acceso al servicio. Configúralo únicamente en el entorno para el que se emitió, custódialo con diligencia y no lo introduzcas en aplicaciones o servicios de terceros que no controles. Si sospechas que se ha visto comprometido, pide su rotación por ticket de soporte. También podemos rotarlas o revocarlas nosotros por motivos de seguridad, avisándote a la mayor brevedad.
Añadir el conector a un agente
- Entra en Copilot Studio y abre el agente al que quieras darle acceso, o crea uno nuevo.
- Ve a la página Herramientas del agente.
- Elige Añadir una herramienta y después Nueva herramienta.
- Selecciona MCP.
- Indica un nombre reconocible —R2 Docuo— y la dirección del servidor:
https://mcp.r2docuo.com - Cuando te pida las credenciales de OAuth, rellena el identificador de cliente y el secreto de cliente que te hayamos facilitado por ticket de soporte.
- Confirma. Copilot Studio creará por detrás un conector en tu entorno de Power Platform y te pedirá crear la conexión.
- Al crear la conexión se abrirá la pantalla de acceso de R2 Docuo: escribe tu usuario y contraseña, elige el repositorio y acepta el consentimiento.
- Vuelve al agente y comprueba que la herramienta aparece habilitada.
Tu contraseña se escribe únicamente en la pantalla de R2 Docuo; Copilot no la ve ni la guarda.
El conector de R2 Docuo utiliza transporte streamable HTTP, que es el que admite Copilot Studio. No hace falta que configures nada al respecto: es el que anuncia el servidor.
Comprobar que funciona
Usa el panel de pruebas del agente en Copilot Studio y pregunta:
¿A qué repositorio de R2 Docuo estás conectado y qué puedes hacer en él?
Debe contestar con el usuario, el identificador del repositorio y un resumen de lo que puede consultar. Cuando responda bien, publica el agente para usarlo desde Copilot o desde Teams. Tienes más ejemplos de preguntas en Qué puedes preguntarle al conector de IA.
Quién consulta con qué permisos
Presta atención a este punto si vas a compartir el agente. En Copilot Studio, la conexión que creaste queda asociada al agente, de modo que las consultas pueden ejecutarse con la autorización de R2 Docuo que tú creaste, no con la de cada persona que use el agente. Revisa en tu entorno cómo está configurada la conexión antes de compartirlo, y recuerda que el testigo de acceso es una contraseña de acceso al servicio y no debe compartirse entre usuarios.
Si necesitas que cada persona consulte con sus propios permisos, configura la conexión para que cada usuario cree la suya, o utiliza un asistente en el que la autorización sea personal, como Claude o ChatGPT.
Desconectar
Quita la herramienta del agente en Copilot Studio y elimina la conexión desde tu entorno de Power Platform. El acceso queda revocado.
Desde el lado de Docuo, un administrador puede retirar el acceso en cualquier momento sin tocar Copilot: la siguiente consulta será rechazada.
Si algo no funciona
| Qué ves | Qué comprobar |
|---|---|
| No aparece la opción MCP al añadir una herramienta | La versión de Copilot Studio de tu entorno y tus permisos para crear conectores en Power Platform. |
| El conector pide un identificador y un secreto de cliente | Es lo normal en Copilot. Solicítalos por ticket de soporte, como se explica más arriba. |
| Error de cliente no válido al autorizar | Que el identificador y el secreto estén bien copiados, sin espacios, y que no se hayan revocado o rotado. |
| La herramienta se crea pero queda sin conexión | Que hayas completado la creación de la conexión, que es un paso aparte, y que la pantalla de acceso de R2 Docuo terminara correctamente. |
| Te identificas pero no aparece tu repositorio | Que el administrador haya activado el conector en ese repositorio, o te haya puesto «Acceso por MCP» en «Permitido». |
| El agente no llama a la herramienta | Que esté habilitada en el agente y que las instrucciones del agente le indiquen que consulte R2 Docuo para este tipo de preguntas. |
| Funcionaba y ha dejado de funcionar | Que no se haya retirado el acceso ni apagado la inteligencia artificial del repositorio, y que no se haya agotado el límite de uso de tu plan. |
Si el problema persiste, abre un ticket de soporte indicando el repositorio, el usuario con el que se creó la conexión y la hora aproximada del intento.