{"id":5698,"date":"2026-09-09T11:29:40","date_gmt":"2026-09-09T09:29:40","guid":{"rendered":"https:\/\/help.r2docuo.com\/?post_type=ht_kb&#038;p=5698"},"modified":"2026-09-10T12:01:47","modified_gmt":"2026-09-10T10:01:47","slug":"connect-copilot-to-the-r2-docuo-ai-connector","status":"publish","type":"ht_kb","link":"https:\/\/help.r2docuo.com\/en\/knowledge-base\/connect-copilot-to-the-r2-docuo-ai-connector\/","title":{"rendered":"Connect Copilot to the R2 Docuo AI connector"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">This article explains how to connect <strong>Microsoft Copilot<\/strong> to the R2 Docuo AI connector, so you can query your repository in natural language, with each user&#8217;s own credentials and permissions.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon\">We are in the process of publishing the <strong>R2 Docuo connector<\/strong> in the <strong>Microsoft 365 Copilot connectors gallery<\/strong>, where other vendors&#8217; connectors are already listed. Once Microsoft approves it, setup will be considerably simpler: the support ticket for credentials and the registration in the Teams Developer Portal will no longer be needed, and an administrator will simply approve the connector from the gallery. We will update this article as soon as that happens.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Before you start, an administrator of your repository must have enabled the connector and granted you access. See <a href=\"\/en\/knowledge-base\/requirements-and-activation-of-the-ai-connector\/\">Requirements and activation of the AI connector<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Choose your route before you start<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">There are two ways to bring R2 Docuo into Copilot, and the difference is not a detail: it changes where it shows up, who sets it up and what permissions you need.<\/p>\n\n\n\n<svg viewBox=\"0 0 720 402\" width=\"100%\" role=\"img\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"max-width:720px;height:auto\">\n  <title>The two routes for bringing R2 Docuo into Microsoft Copilot<\/title>\n  <desc>If you have the Global administrator or AI administrator role, the recommended route is the federated connector, which makes R2 Docuo appear as one more source in Copilot Chat, Excel, Researcher and Cowork, and which each user turns on with their own credentials. If you are not an administrator, the alternative is to add R2 Docuo as a tool of a Copilot Studio agent, which you can only query by talking to that agent.<\/desc>\n  <rect x=\"0\" y=\"0\" width=\"720\" height=\"402\" fill=\"#f6f9fc\"><\/rect>\n  <rect x=\"160\" y=\"14\" width=\"400\" height=\"46\" rx=\"4\" fill=\"#ffffff\" stroke=\"#c8d5e3\" stroke-width=\"1\"><\/rect>\n  <text x=\"360\" y=\"42\" text-anchor=\"middle\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"15\" font-weight=\"600\" fill=\"#14202e\">Do you have a Global admin or AI admin role?<\/text>\n  <line x1=\"280\" y1=\"60\" x2=\"182\" y2=\"97\" stroke=\"#708da9\" stroke-width=\"1.5\"><\/line>\n  <polygon points=\"178,98 188,92 190,100\" fill=\"#708da9\"><\/polygon>\n  <text x=\"220\" y=\"82\" text-anchor=\"middle\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13\" font-weight=\"700\" fill=\"#46617c\">Yes<\/text>\n  <line x1=\"440\" y1=\"60\" x2=\"538\" y2=\"97\" stroke=\"#708da9\" stroke-width=\"1.5\"><\/line>\n  <polygon points=\"542,98 532,92 530,100\" fill=\"#708da9\"><\/polygon>\n  <text x=\"500\" y=\"82\" text-anchor=\"middle\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13\" font-weight=\"700\" fill=\"#46617c\">No<\/text>\n  <rect x=\"20\" y=\"104\" width=\"330\" height=\"284\" rx=\"4\" fill=\"#ffffff\" stroke=\"#dfe7ef\" stroke-width=\"1\"><\/rect>\n  <rect x=\"20\" y=\"104\" width=\"330\" height=\"3\" fill=\"#5b3fe0\"><\/rect>\n  <text x=\"44\" y=\"138\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"10\" font-weight=\"700\" letter-spacing=\"1.4\" fill=\"#5b3fe0\">RECOMMENDED<\/text>\n  <text x=\"44\" y=\"164\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"16\" font-weight=\"700\" fill=\"#043d75\">Route A \u00b7 Federated connector<\/text>\n  <text x=\"44\" y=\"196\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" fill=\"#46617c\">R2 Docuo is one more source in<\/text>\n  <text x=\"44\" y=\"216\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" font-weight=\"600\" fill=\"#14202e\">Copilot Chat, Excel, Researcher<\/text>\n  <text x=\"44\" y=\"236\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" font-weight=\"600\" fill=\"#14202e\">and Cowork.<\/text>\n  <text x=\"44\" y=\"268\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" fill=\"#46617c\">No agents involved: each person<\/text>\n  <text x=\"44\" y=\"288\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" fill=\"#46617c\">turns it on from their own<\/text>\n  <text x=\"44\" y=\"308\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" fill=\"#46617c\">Copilot settings, with their own<\/text>\n  <text x=\"44\" y=\"328\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" fill=\"#46617c\">credentials.<\/text>\n  <line x1=\"44\" y1=\"350\" x2=\"326\" y2=\"350\" stroke=\"#dfe7ef\" stroke-width=\"1\"><\/line>\n  <text x=\"44\" y=\"372\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"12.5\" fill=\"#708da9\">An administrator registers it once.<\/text>\n  <rect x=\"370\" y=\"104\" width=\"330\" height=\"284\" rx=\"4\" fill=\"#eff3f8\" stroke=\"#dfe7ef\" stroke-width=\"1\"><\/rect>\n  <text x=\"394\" y=\"164\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"16\" font-weight=\"700\" fill=\"#043d75\">Route B \u00b7 Studio agent<\/text>\n  <text x=\"394\" y=\"196\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" fill=\"#46617c\">R2 Docuo is added as a tool of<\/text>\n  <text x=\"394\" y=\"216\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" font-weight=\"600\" fill=\"#14202e\">one specific agent.<\/text>\n  <text x=\"394\" y=\"268\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" fill=\"#46617c\">You can only query it by talking<\/text>\n  <text x=\"394\" y=\"288\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" fill=\"#46617c\">to that agent, not from the<\/text>\n  <text x=\"394\" y=\"308\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" fill=\"#46617c\">general Copilot chat, or from<\/text>\n  <text x=\"394\" y=\"328\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"13.5\" fill=\"#46617c\">Excel or Researcher.<\/text>\n  <line x1=\"394\" y1=\"350\" x2=\"676\" y2=\"350\" stroke=\"#dfe7ef\" stroke-width=\"1\"><\/line>\n  <text x=\"394\" y=\"372\" font-family=\"system-ui, 'Segoe UI', sans-serif\" font-size=\"12.5\" fill=\"#708da9\">No administrator role required.<\/text>\n<\/svg>\n\n\n\n<p class=\"wp-block-paragraph\">If you have administrator permissions, use the first one. The second exists for anyone who wants to try the integration without waiting for their organisation to approve it, and it is described further down.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon\">AI assistants change their menus and their capabilities often. The steps in this article describe the process as of <strong>September 2026<\/strong>: in your version, an option may be somewhere else, be called something different, or no longer be needed. If something does not add up, search for &#8220;MCP&#8221;, &#8220;connectors&#8221; or &#8220;sources&#8221; in the settings.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What you need<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">In Microsoft<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The <strong>Global administrator<\/strong> or <strong>AI administrator<\/strong> role in the Microsoft 365 admin center. Route A only.<\/li>\n\n\n\n<li>Access to the <strong>Teams Developer Portal<\/strong>, also route A only.<\/li>\n\n\n\n<li><strong>Microsoft 365 Copilot<\/strong> licences for the people who are going to query the repository.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">In R2 Docuo<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A <strong>compatible plan<\/strong> and <strong>artificial intelligence enabled<\/strong> in the repository.<\/li>\n\n\n\n<li><strong>MCP access<\/strong> enabled, either for the whole repository or on each user&#8217;s record.<\/li>\n\n\n\n<li>A <strong>named user<\/strong> account, with its password. Collaborators cannot use the connector.<\/li>\n\n\n\n<li>The server address: <code>https:\/\/mcp.r2docuo.com<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">The requirements on the Docuo side are set up by your repository administrator, and it is worth confirming them before you start: if any of them is missing, the sign-in screen will not offer you any repository and the message will not tell you which one it is. They are explained one by one in <a href=\"\/en\/knowledge-base\/requirements-and-activation-of-the-ai-connector\/\">Requirements and activation of the AI connector<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Check first<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">One minute that saves many. Check from your network that the server responds before you configure anything:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Invoke-WebRequest https:\/\/mcp.r2docuo.com\/.well-known\/oauth-protected-resource<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">It must return <code>200<\/code> and a JSON document containing <code>\"resource_name\":\"R2 Docuo\"<\/code>. If it does not respond, the problem is in your network or your outbound proxy, and it is worth solving that first.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Route A \u00b7 The federated connector<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A federated connector queries R2 Docuo <strong>in real time<\/strong>. It does not copy or index anything in Microsoft: every answer is requested from the repository at that moment, with the identity of whoever is asking.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">There are three stretches: preparing the credentials, registering the connector in the organisation, and each person turning it on. An administrator does the first two once; each user does the third.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Preparation: credentials and OAuth registration<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Most assistants register themselves with our authorization server and need no configuration at all. <strong>The federated connector does not<\/strong>: the Teams Developer Portal requires a <strong>client ID<\/strong> and a <strong>client secret<\/strong> up front, so this step cannot be self-served.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">We issue those credentials at the customer&#8217;s request. <strong>The request is filed by an administrator<\/strong>, because R2 Docuo support is limited to administrators and advanced users: if you are not one, ask whoever administers your repository to open the ticket.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>An administrator opens a <strong>support ticket<\/strong> from their R2 Docuo account.<\/li>\n\n\n\n<li>They state your organisation&#8217;s name, that the credentials are for the <strong>Copilot federated connector<\/strong>, and which repository will be used.<\/li>\n\n\n\n<li>We send back a client ID and a secret the same way, together with the addresses they will need in the next step.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">You do not need to supply the return URL: Copilot sets it and the server accepts whichever one it brings. And keep the secret somewhere safe, because <strong>it is not shown again<\/strong>: if it is lost, a new one has to be issued.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon\">The client ID and the secret identify the assistant, not a person: <strong>they do not replace named authorization<\/strong>. Whoever connects still signs in with their own R2 Docuo account on the sign-in screen and queries with their own permissions.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">The client secret is a password for access to the service. Configure it only in the environment it was issued for, safeguard it diligently, and do not enter it in third-party applications or services you do not control. If you suspect it has been compromised, request its rotation through a support ticket. We may also rotate or revoke credentials for security reasons, notifying you as soon as possible.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">With the credentials in hand, register the OAuth connection. Go to <a href=\"https:\/\/dev.teams.microsoft.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">dev.teams.microsoft.com<\/a> and open <strong>Tools \u2192 OAuth Client Registration \u2192 + New OAuth connection<\/strong>. Fill in:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Field<\/th><th>Value<\/th><\/tr><\/thead><tbody><tr><td>Name<\/td><td>R2 Docuo<\/td><\/tr><tr><td>Client ID<\/td><td>The one R2 Docuo gave you<\/td><\/tr><tr><td>Client secret<\/td><td>The one R2 Docuo gave you<\/td><\/tr><tr><td>Authorization endpoint<\/td><td><code>https:\/\/mcp.r2docuo.com\/authorize<\/code><\/td><\/tr><tr><td>Token endpoint<\/td><td><code>https:\/\/mcp.r2docuo.com\/token<\/code><\/td><\/tr><tr><td>Refresh endpoint<\/td><td><code>https:\/\/mcp.r2docuo.com\/token<\/code><\/td><\/tr><tr><td>Scopes<\/td><td><code>r2docuo.mcp<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Under <strong>Restrict usage by organization<\/strong> leave <em>Only my organization<\/em>. Under <strong>Restrict usage by Teams app<\/strong> leave <em>Any Teams app<\/em>: a federated connector is not a Teams app, so there is none to tie it to. Also tick the <strong>PKCE<\/strong> box, which R2 Docuo supports.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When you save, the portal shows an <strong>OAuth client registration ID<\/strong>. Keep it: it is the only piece that travels from the Teams portal to the admin center, without it the connector cannot be created, and looking it up again means redoing the registration.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Do not confuse the <strong>registration ID<\/strong> with the <strong>client ID<\/strong>. The client ID was issued by R2 Docuo and you have just typed it into this form; the registration ID is minted by Microsoft when you save. Putting one where the other goes is the most common mistake in the whole process, and the error message does not make it clear.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Registering the connector, once<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>In <a href=\"https:\/\/admin.microsoft.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">admin.microsoft.com<\/a>, go to <strong>Copilot \u2192 Connectors<\/strong> and open the <strong>Gallery<\/strong> tab. Under <em>Created by your org<\/em>, find the <strong>Create a new connector<\/strong> box and click <strong>Add<\/strong>.<\/li>\n\n\n\n<li>On the custom connector page, under <strong>Connect to MCP server<\/strong>, click <strong>Add<\/strong>.<\/li>\n\n\n\n<li>For <strong>Display name<\/strong>, enter <strong>R2 Docuo<\/strong> exactly: it is the name your users will see in the list of sources.<\/li>\n\n\n\n<li>For <strong>Base URL<\/strong>, <code>https:\/\/mcp.r2docuo.com<\/code><\/li>\n\n\n\n<li>For <strong>Registration ID<\/strong>, the <em>OAuth client registration ID<\/em> you saved when you registered the OAuth connection.<\/li>\n\n\n\n<li>Click <strong>Save<\/strong>. The connector moves to the <strong>Your connections<\/strong> list, alongside the tenant&#8217;s other connectors.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">The address is the root, <strong>without adding <code>\/mcp<\/code> or any other path<\/strong>. With a path after it, Copilot looks for the access configuration at an address that does not exist and the connection fails.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Registering the connector does not show it to anyone yet. Select it in <strong>Your connections<\/strong> and use <strong>Staged rollout<\/strong> to enable it first for a few people or for a Microsoft Entra group. When you are happy with it, click <strong>Deploy to all users<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Changes take up to <strong>15 minutes<\/strong> to take effect. If something does not appear straight away, wait before touching the configuration. From that same list you can later <strong>disable<\/strong> the connector without losing its configuration, or <strong>delete<\/strong> it entirely.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Each person turning it on, once<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The connector does not carry administrator credentials along with it: even if it has been deployed to the whole organisation, <strong>each person has to connect with their own<\/strong>. It is a one-off, and it is done from the chat itself.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>In Microsoft 365 Copilot Chat, open the <strong>\u2026<\/strong> menu and go to <strong>Settings \u2192 Sources<\/strong>.<\/li>\n\n\n\n<li>Find <strong>R2 Docuo<\/strong> in the list and click <strong>Connect<\/strong>.<\/li>\n\n\n\n<li>The R2 Docuo sign-in screen opens, in two steps: first your email and password; then the repository \u2014the list only appears if you have access to more than one\u2014 and the authorization.<\/li>\n\n\n\n<li>When you finish you return to the chat and the source is marked as connected.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon\">Your password is typed only on the R2 Docuo screen; Copilot neither sees it nor stores it.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can now ask questions in the chat as usual. If Copilot does not turn to Docuo on its own, name it in your question: <em>&#8220;search R2 Docuo for August&#8217;s invoices&#8221;<\/em>. In the <strong>Researcher<\/strong> agent, R2 Docuo appears in the <strong>sources<\/strong> menu and is selected explicitly for a piece of research. There are more example questions in <a href=\"\/en\/knowledge-base\/what-you-can-ask-the-ai-connector\/\">What you can ask the AI connector<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To stop using it, turn the source off in those same settings. That is also how you <strong>change repository<\/strong>: disconnect and connect again.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What you can query<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A federated connector is <strong>read-only<\/strong> by Microsoft&#8217;s design, so what remains available in it are the query tools from the AI connector&#8217;s catalogue: searching, listing, running saved queries, summarising, reading documents and their text, and going through categories, fields, folders and workflows. They are described one by one in <a href=\"\/en\/knowledge-base\/what-you-can-ask-the-ai-connector\/\">What you can ask the AI connector<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Your repository may also have query tools of its own, defined by your organisation, which will appear alongside these. Write operations \u2014creating documents, advancing workflows\u2014 are still done from R2 Docuo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What is worth knowing<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Aspect<\/th><th>What it means in practice<\/th><\/tr><\/thead><tbody><tr><td>Nothing is indexed<\/td><td>Copilot neither stores nor copies the repository&#8217;s content. Every answer is queried at that moment and disappears with the conversation. Documents do not leave R2 Docuo.<\/td><\/tr><tr><td>The permissions are yours<\/td><td>Each person sees exactly what they would see in the application. Nobody reaches anything through Copilot that they could not open themselves.<\/td><\/tr><tr><td>One repository per connection<\/td><td>The repository is chosen when you connect. To change it, turn the source off in your Copilot settings and connect again.<\/td><\/tr><tr><td>Revocation is immediate<\/td><td>If an administrator withdraws your access in R2 Docuo, your next query fails instantly. Nothing has to be touched in Microsoft.<\/td><\/tr><tr><td>It is audited<\/td><td>Federated connector activity can be audited from Microsoft Purview.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Route B \u00b7 A Copilot Studio agent<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">This is the alternative for anyone without administrator permissions. R2 Docuo is added as a tool of your own private agent, which nobody else in the organisation sees.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The difference from the federated connector: you can only query it by talking to that specific agent, not from the general Copilot chat, or from Excel or Researcher.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>In <a href=\"https:\/\/copilotstudio.microsoft.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">copilotstudio.microsoft.com<\/a>, check that you are in the right environment and create an agent with <strong>Create \u2192 New agent<\/strong>.<\/li>\n\n\n\n<li>Open the <strong>Tools<\/strong> tab and choose <strong>Add a tool \u2192 New tool \u2192 Model Context Protocol<\/strong>.<\/li>\n\n\n\n<li>For <strong>Server URL<\/strong>, enter <code>https:\/\/mcp.r2docuo.com<\/code> \u2014the root, with no path\u2014 and write a specific description of what the repository contains: Copilot reads it to decide when to query it.<\/li>\n\n\n\n<li>Under <strong>Authentication<\/strong>, choose <strong>OAuth 2.0<\/strong> and, as the type, <strong>Dynamic discovery<\/strong>.<\/li>\n\n\n\n<li>Click <strong>Add tool \u2192 Create a new connection<\/strong>, sign in on the R2 Docuo screen, choose a repository and go back to <strong>Add to agent<\/strong>. Try it out in the agent&#8217;s test panel.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon\">On this route <strong>no credentials are needed<\/strong>: the server negotiates them on its own. If the form asks you for a client ID and a secret, you have selected <em>Manual<\/em> by mistake.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">On this route the agent also has the <strong>change repository<\/strong> tool available. Do not use it from Copilot: it closes the session, and Copilot cannot ask you for credentials again on its own, so the connection is left unusable without warning and has to be rebuilt from Power Apps.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Who queries with which permissions<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Pay attention to this point if you are going to share the agent. In Copilot Studio, the connection you created stays associated with the agent, so queries may run with the R2 Docuo authorization you created, not with that of each person using the agent. Check how the connection is configured in your environment before sharing it, and remember that the access token is a password for access to the service and must not be shared between users.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you need each person to query with their own permissions, configure the connection so that each user creates their own, or use the federated connector from route A, where authorization is always personal.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you later want the agent to appear in the Microsoft 365 Copilot chat, publish it from <strong>Channels \u2192 Microsoft 365 Copilot<\/strong>. It goes to an administrator for approval, who decides whether it is assigned to the whole organisation or only to certain people.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Disconnecting<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">With the <strong>federated connector<\/strong>, each person turns the source off in their own Copilot settings. An administrator can also disable or delete the connector from <strong>Your connections<\/strong> in the admin center.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">With the <strong>Copilot Studio agent<\/strong>, remove the tool from the agent and delete the connection from your Power Platform environment.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">On the Docuo side, an administrator can withdraw access at any time without touching anything in Microsoft: the next query will be rejected.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">If something does not work<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>What you see<\/th><th>What to check<\/th><\/tr><\/thead><tbody><tr><td>The connector will not save<\/td><td>Almost always the <em>registration ID<\/em>. The field expects the one the Developer Portal returned when you saved the OAuth connection, not the client ID R2 Docuo gave you. Check too that the base address is the root, with no path added.<\/td><\/tr><tr><td>Users do not see it under Sources<\/td><td>Registering the connector does not deploy it. Review the <em>Staged rollout<\/em> and wait 15 minutes. If it still does not show up, look at the <em>Allowed agent types<\/em> setting in Agent 365: with the published connector options deselected, it has to be enabled individually.<\/td><\/tr><tr><td>Connecting the source fails after clicking Connect<\/td><td>Almost always the OAuth credentials: check that the three endpoints are the ones in the table and that the secret was not copied with trailing spaces.<\/td><\/tr><tr><td>No repository appears after you sign in correctly<\/td><td>One of the Docuo requirements is missing: a compatible plan, AI enabled, MCP access enabled, or the account is a collaborator&#8217;s. Contact your repository administrator.<\/td><\/tr><tr><td>You cannot sign in<\/td><td>The message is deliberately generic, so as not to reveal which email addresses exist. Check the password and, if it is correct, move on to the previous row.<\/td><\/tr><tr><td>Copilot does not query Docuo<\/td><td>Ask naming the source \u2014&#8221;search R2 Docuo for\u2026&#8221;\u2014 or select it explicitly in the Researcher sources menu.<\/td><\/tr><tr><td>The MCP option does not appear when adding a tool in Copilot Studio<\/td><td>Your environment&#8217;s version of Copilot Studio, and your permissions to create connectors in Power Platform.<\/td><\/tr><tr><td>The Copilot Studio form asks for a client ID and a secret<\/td><td>You have chosen <em>Manual<\/em> instead of <em>Dynamic discovery<\/em>. Go back and change the type.<\/td><\/tr><tr><td>The tool is created but has no connection<\/td><td>That you completed the creation of the connection, which is a separate step, and that the R2 Docuo sign-in screen finished properly.<\/td><\/tr><tr><td>The agent does not call the tool<\/td><td>That it is enabled on the agent, and that the agent&#8217;s instructions tell it to query R2 Docuo for this kind of question.<\/td><\/tr><tr><td>It used to work and has stopped<\/td><td>That access has not been withdrawn, that artificial intelligence has not been switched off in the repository, and that your plan&#8217;s usage limit has not run out.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">If the problem persists, open a support ticket stating the repository, the user the connection was created with, and the approximate time of the attempt.<\/p>\n\n","protected":false},"excerpt":{"rendered":"<p>This article explains how to connect Microsoft Copilot to the R2 Docuo AI connector, so you can query your repository in natural language, with each user&#8217;s own credentials and permissions. Choose your route before you start There are two ways to bring R2 Docuo into Copilot, and the difference is&#8230;<\/p>\n","protected":false},"author":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"content-type":"","footnotes":""},"ht-kb-category":[462],"ht-kb-tag":[],"class_list":["post-5698","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-ai-connector-mcp"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.4 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Connect Copilot to the R2 Docuo AI connector - R2 Docuo | Help center<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/help.r2docuo.com\/knowledge-base\/conectar-copilot-al-conector-de-ia-de-r2-docuo\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Connect Copilot to the R2 Docuo AI connector - R2 Docuo | Help center\" \/>\n<meta property=\"og:description\" content=\"This article explains how to connect Microsoft Copilot to the R2 Docuo AI connector, so you can query your repository in natural language, with each user&#8217;s own credentials and permissions. Choose your route before you start There are two ways to bring R2 Docuo into Copilot, and the difference is...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/help.r2docuo.com\/knowledge-base\/conectar-copilot-al-conector-de-ia-de-r2-docuo\/\" \/>\n<meta property=\"og:site_name\" content=\"R2 Docuo | Help center\" \/>\n<meta property=\"article:modified_time\" content=\"2026-09-10T10:01:47+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/help.r2docuo.com\/wp-content\/uploads\/2023\/06\/ILUDEST_CENTRODEAYUDA.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"630\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@R2Docuo\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"14 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/help.r2docuo.com\\\/knowledge-base\\\/conectar-copilot-al-conector-de-ia-de-r2-docuo\\\/\",\"url\":\"https:\\\/\\\/help.r2docuo.com\\\/knowledge-base\\\/conectar-copilot-al-conector-de-ia-de-r2-docuo\\\/\",\"name\":\"Connect Copilot to the R2 Docuo AI connector - R2 Docuo | Help center\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/help.r2docuo.com\\\/#website\"},\"datePublished\":\"2026-09-09T09:29:40+00:00\",\"dateModified\":\"2026-09-10T10:01:47+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/help.r2docuo.com\\\/knowledge-base\\\/conectar-copilot-al-conector-de-ia-de-r2-docuo\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/help.r2docuo.com\\\/knowledge-base\\\/conectar-copilot-al-conector-de-ia-de-r2-docuo\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/help.r2docuo.com\\\/knowledge-base\\\/conectar-copilot-al-conector-de-ia-de-r2-docuo\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Portada\",\"item\":\"https:\\\/\\\/help.r2docuo.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect Copilot to the R2 Docuo AI connector\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/help.r2docuo.com\\\/#website\",\"url\":\"https:\\\/\\\/help.r2docuo.com\\\/\",\"name\":\"R2 Docuo | Help center\",\"description\":\"Todos los recursos para usuarios, administradores y desarrolladores de de R2 Docuo a tu alcance\",\"publisher\":{\"@id\":\"https:\\\/\\\/help.r2docuo.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/help.r2docuo.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/help.r2docuo.com\\\/#organization\",\"name\":\"R2 Docuo | Help center\",\"url\":\"https:\\\/\\\/help.r2docuo.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/help.r2docuo.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/help.r2docuo.com\\\/wp-content\\\/uploads\\\/2023\\\/06\\\/ILUDEST_CENTRODEAYUDA.png\",\"contentUrl\":\"https:\\\/\\\/help.r2docuo.com\\\/wp-content\\\/uploads\\\/2023\\\/06\\\/ILUDEST_CENTRODEAYUDA.png\",\"width\":1200,\"height\":630,\"caption\":\"R2 Docuo | Help center\"},\"image\":{\"@id\":\"https:\\\/\\\/help.r2docuo.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/x.com\\\/R2Docuo\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/r2docuo\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Connect Copilot to the R2 Docuo AI connector - R2 Docuo | Help center","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/help.r2docuo.com\/knowledge-base\/conectar-copilot-al-conector-de-ia-de-r2-docuo\/","og_locale":"en_US","og_type":"article","og_title":"Connect Copilot to the R2 Docuo AI connector - R2 Docuo | Help center","og_description":"This article explains how to connect Microsoft Copilot to the R2 Docuo AI connector, so you can query your repository in natural language, with each user&#8217;s own credentials and permissions. Choose your route before you start There are two ways to bring R2 Docuo into Copilot, and the difference is...","og_url":"https:\/\/help.r2docuo.com\/knowledge-base\/conectar-copilot-al-conector-de-ia-de-r2-docuo\/","og_site_name":"R2 Docuo | Help center","article_modified_time":"2026-09-10T10:01:47+00:00","og_image":[{"width":1200,"height":630,"url":"https:\/\/help.r2docuo.com\/wp-content\/uploads\/2023\/06\/ILUDEST_CENTRODEAYUDA.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_site":"@R2Docuo","twitter_misc":{"Est. reading time":"14 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/help.r2docuo.com\/knowledge-base\/conectar-copilot-al-conector-de-ia-de-r2-docuo\/","url":"https:\/\/help.r2docuo.com\/knowledge-base\/conectar-copilot-al-conector-de-ia-de-r2-docuo\/","name":"Connect Copilot to the R2 Docuo AI connector - R2 Docuo | Help center","isPartOf":{"@id":"https:\/\/help.r2docuo.com\/#website"},"datePublished":"2026-09-09T09:29:40+00:00","dateModified":"2026-09-10T10:01:47+00:00","breadcrumb":{"@id":"https:\/\/help.r2docuo.com\/knowledge-base\/conectar-copilot-al-conector-de-ia-de-r2-docuo\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/help.r2docuo.com\/knowledge-base\/conectar-copilot-al-conector-de-ia-de-r2-docuo\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/help.r2docuo.com\/knowledge-base\/conectar-copilot-al-conector-de-ia-de-r2-docuo\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Portada","item":"https:\/\/help.r2docuo.com\/"},{"@type":"ListItem","position":2,"name":"Connect Copilot to the R2 Docuo AI connector"}]},{"@type":"WebSite","@id":"https:\/\/help.r2docuo.com\/#website","url":"https:\/\/help.r2docuo.com\/","name":"R2 Docuo | Help center","description":"Todos los recursos para usuarios, administradores y desarrolladores de de R2 Docuo a tu alcance","publisher":{"@id":"https:\/\/help.r2docuo.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/help.r2docuo.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/help.r2docuo.com\/#organization","name":"R2 Docuo | Help center","url":"https:\/\/help.r2docuo.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/help.r2docuo.com\/#\/schema\/logo\/image\/","url":"https:\/\/help.r2docuo.com\/wp-content\/uploads\/2023\/06\/ILUDEST_CENTRODEAYUDA.png","contentUrl":"https:\/\/help.r2docuo.com\/wp-content\/uploads\/2023\/06\/ILUDEST_CENTRODEAYUDA.png","width":1200,"height":630,"caption":"R2 Docuo | Help center"},"image":{"@id":"https:\/\/help.r2docuo.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/x.com\/R2Docuo","https:\/\/www.linkedin.com\/company\/r2docuo"]}]}},"_links":{"self":[{"href":"https:\/\/help.r2docuo.com\/en\/wp-json\/wp\/v2\/ht-kb\/5698","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.r2docuo.com\/en\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/help.r2docuo.com\/en\/wp-json\/wp\/v2\/types\/ht_kb"}],"replies":[{"embeddable":true,"href":"https:\/\/help.r2docuo.com\/en\/wp-json\/wp\/v2\/comments?post=5698"}],"version-history":[{"count":3,"href":"https:\/\/help.r2docuo.com\/en\/wp-json\/wp\/v2\/ht-kb\/5698\/revisions"}],"predecessor-version":[{"id":5707,"href":"https:\/\/help.r2docuo.com\/en\/wp-json\/wp\/v2\/ht-kb\/5698\/revisions\/5707"}],"wp:attachment":[{"href":"https:\/\/help.r2docuo.com\/en\/wp-json\/wp\/v2\/media?parent=5698"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.r2docuo.com\/en\/wp-json\/wp\/v2\/ht-kb-category?post=5698"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.r2docuo.com\/en\/wp-json\/wp\/v2\/ht-kb-tag?post=5698"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}