dRofus Help & Learning
English

dRofus MCP Connector

Early access testing: This MCP connector is currently in early access testing. Features, availability, and behavior may change as testing continues.

The dRofus MCP connector lets MCP-capable AI tools connect to dRofus through a remote server so users can query project data using natural language. This guide explains what it is, how to connect, which server addresses to use by region, and the key precautions to follow before using it.

Use the MCP connector carefully. Before connecting an AI tool to dRofus project data, make sure you have permission from the person or organization that owns or controls that project data. Only share data with AI tools that your project owner, employer, or organization has approved for that purpose.

How sign-in and access works: When you connect an AI tool, you sign in with your normal dRofus account and pick a project. The connector can only access the dRofus projects and information that your account is allowed to access. If you do not have permission to see or change something in dRofus, the connected AI tool cannot do it either.

What the MCP connector is for

MCP stands for Model Context Protocol. In dRofus, the MCP connector provides a structured way for AI clients to access dRofus data and tools over HTTP. Instead of only chatting with a language model, you can let a compatible client retrieve live information from dRofus and, where supported and permitted, perform structured actions.

  • Ask questions about project data in plain language

  • Find rooms, items, and occurrences using filters and project context

  • Inspect details such as room data, item definitions, and equipment assignments

  • Support analysis workflows like discrepancy checks, standards review, and data verification

The exact tools available inside the client depend on the current MCP server implementation, your permissions, and the MCP client you are using.

Regional MCP server addresses

Use the regional endpoint that matches the dRofus environment or region you need to access. The endpoint format is https://api-xx.drofus.com/mcp.

Region

Address

Typical use

EU

https://api-eu.drofus.com/mcp

Europe

NO

https://api-no.drofus.com/mcp

Nordics

US

https://api-us.drofus.com/mcp

United States

CA

https://api-ca.drofus.com/mcp

Canada

AU

https://api-au.drofus.com/mcp

Australia and Oceania

JP

https://api-jp.drofus.com/mcp

Japan

UK

https://api-uk.drofus.com/mcp

United Kingdom

Before you connect

  1. Pick your regional address from the table above.

  2. Check that your organization allows it. Some AI tools need an administrator to enable custom connectors or remote MCP servers, and some plans do not include them.

  3. Add a remote MCP server or custom connector in the client's MCP, connector, plugin, extension, or tool settings, using your regional URL.

  4. Use browser sign-in only. Choose OAuth browser sign-in with your dRofus account. If the client shows advanced OAuth settings, leave OAuth Client ID and OAuth Client Secret empty. Do not choose API key, bearer token, basic authentication, or manual client ID/secret setup. The only exception is Microsoft Copilot Studio, which needs a client ID and secret from dRofus (see the Microsoft Copilot Studio section).

  5. Open a new chat or agent session and verify that the dRofus tools are available.

Tools

Client or tool

Status

Notes

Claude

Supported

Use when your organization has approved Claude and the client supports remote MCP over HTTP.

ChatGPT

Supported

Use where custom connectors are available for your plan and organization settings.

GitHub Copilot CLI

Supported

Add the regional dRofus MCP URL as a remote MCP server and sign in with your dRofus account when prompted.

Microsoft Copilot Studio

Manual setup

Needs a manual OAuth setup with a client ID and secret from dRofus. See the Microsoft Copilot Studio section below.

Other MCP-capable clients

Depends

Requires remote MCP over HTTP, CIMD support, and OAuth browser sign-in without manual client ID or client secret setup.

Claude

Use Claude if your organization has approved it for the relevant dRofus project data and you want an interactive chat-based workflow. Claude can be used where your Claude plan and organization settings allow custom connectors or remote MCP servers.

Claude

  1. Open Claude.

  2. Go to Settings, then find Connectors, Extensions, or MCP.

  3. Add a new custom connector or remote MCP server.

  4. Enter the appropriate dRofus MCP server URL for your region.

  5. Use OAuth browser sign-in (see Before you connect). Claude identifies itself automatically, so leave any advanced OAuth client ID and secret fields empty.

  6. Start the authentication flow, sign in with your normal dRofus account, and pick a project.

  7. Open a new chat and verify that dRofus tools are listed or available when Claude offers tool use.

Claude Code

If you use Claude Code, add the dRofus MCP server from your terminal. Replace the URL with the correct regional endpoint:

claude mcp add --transport http drofus https://api-xx.drofus.com/mcp

After adding it, open Claude Code and run /mcp to start browser-based authentication and confirm that the connector is available.

For the latest Claude-specific setup steps, see Anthropic's Claude documentation for MCP and connectors. Menu names and availability may vary by plan, app version, and organization settings.

ChatGPT

Use ChatGPT if your organization has approved it for the relevant dRofus project data. Depending on your plan, ChatGPT exposes MCP through connectors or developer mode.

ChatGPT and other hosted OpenAI tools

  1. Open the OpenAI product your organization uses, such as ChatGPT in the browser or desktop app.

  2. Open settings for Connectors, Tools, Integrations, Agents, or Developer mode.

  3. Add a new MCP server, remote tool, or custom connector.

  4. Enter the correct dRofus regional endpoint in the format shown above.

  5. Use OAuth browser sign-in (see Before you connect), and leave any advanced OAuth client ID and secret fields empty.

  6. Start the authentication flow, sign in with your dRofus account, and pick a project.

  7. Save the connection and start a new chat or agent session.

  8. Run a simple test prompt, such as asking the client to list available dRofus tools or retrieve a small known data set.

For the latest product-specific steps, see OpenAI's documentation for ChatGPT connectors. Menu names and availability may vary by plan, app version, and organization settings.

Microsoft Copilot Studio

Copilot Studio does not support the automatic client registration (CIMD) that the other clients use, so it needs a manual OAuth setup. This takes a few extra steps, and you need to contact dRofus support twice: once to get a client ID and secret, and once to send us the callback URL that Copilot Studio creates.

Step 1: Get a client ID and secret from dRofus

Contact dRofus support and ask for an MCP client for Microsoft Copilot Studio. Tell us which region you use. We send you a Client ID and a Client secret.

Step 2: Add the MCP server in Copilot Studio

  1. Open your agent in Copilot Studio and go to the Tools page.

  2. Select Add a tool, then New tool, then Model Context Protocol.

  3. Enter a Server name (for example, dRofus), a short Server description, and the regional dRofus MCP URL as the Server URL.

  4. Under authentication, select OAuth 2.0, and set Type to Manual.

  5. Fill in the fields using the values in the table below.

  6. Select Create. Copilot Studio shows a callback URL. Copy it.

Field

Value

Client ID

The client ID you got from dRofus

Client secret

The client secret you got from dRofus

Authorization URL

https://<identity server>/connect/authorize

Token URL template

https://<identity server>/connect/token

Refresh URL

https://<identity server>/connect/token

Scopes

dr-std offline_access

Replace <identity server> with the identity server for your region:

Region

Identity server

EU

ids-eu.drofus.com

NO

ids-db2.drofus.com

US

ids-us.drofus.com

CA

ids-ca.drofus.com

AU

ids-au.drofus.com

JP

ids-jp.drofus.com

UK

ids-uk.drofus.com

Step 3: Send the callback URL to dRofus

Send the callback URL from step 2 to dRofus support. We add it to your client and let you know when it is ready. Sign-in does not work until this is done.

Step 4: Connect and test

  1. In Copilot Studio, select Next. The Add tool dialog appears.

  2. Select Create a new connection, sign in with your dRofus account, and pick a project.

  3. Select Add to agent.

  4. Test the agent with a small read-only prompt, such as listing a few rooms.

Keep the client secret safe. Do not share it or paste it into chats or documents. If you delete and recreate the tool in Copilot Studio, you may get a new callback URL. Send the new URL to dRofus support.

For the latest Copilot Studio steps, see Microsoft's documentation on connecting an agent to an existing MCP server. Menu names may change between versions.

Other compatible MCP tools

Many AI clients can connect to remote MCP servers even if they are not listed above. The important requirements are that the client supports remote MCP over HTTP, supports CIMD, and can complete OAuth browser sign-in without a manual client ID or client secret.

  • Add a remote MCP server, custom connector, or external tool server.

  • Use the regional dRofus MCP URL.

  • Use OAuth browser sign-in with your dRofus account. If the client shows advanced OAuth settings, leave OAuth Client ID and OAuth Client Secret empty. The client must support CIMD; do not choose API key, bearer token, basic authentication, or manual client ID/secret setup.

  • Check that the tool list loads successfully.

  • Run a small read-only test before relying on the connection for larger tasks.

If you are unsure whether a client is supported, check the client documentation for both remote MCP server support and CIMD support.

Good to know before you start

Does the AI tool get my password?

  • No. You sign in on the dRofus sign-in page, and the AI tool only receives a time-limited access token linked to your dRofus account. When it expires, you are asked to sign in again.

  • If a dRofus sign-in page opens that you did not start yourself, close it without signing in.

Where does the data go?

  • When you ask the AI tool something, data from dRofus is sent to the AI provider to create the answer. From that point, the agreement between you or your organization and the AI provider decides how the data is handled. If the data contains personal information, your organization is the data controller.

  • How the provider handles the data depends on your plan:

    • Personal plans (such as Claude Free, Pro or Max, and ChatGPT Free, Plus or Pro) may use conversations to train models unless you turn this off in the settings.

    • Business plans (such as Claude Team or Enterprise, ChatGPT Business or Enterprise, and Microsoft Copilot Studio) usually do not use your data for training and include a data processing agreement.

  • If you work with project data that belongs to a client or project owner, we recommend a business plan. Always check your provider's current terms and your organization's rules for AI tools.

Can I use other connectors in the same chat?

  • Yes, but only connectors and tools you trust. Other MCP servers in the same chat can in principle read what the AI tool gets from dRofus. Turn off unknown or untrusted connectors when you work with dRofus data.

Who is responsible if the AI tool makes a mistake?

  • You are. AI tools can misunderstand a question, miss data or draw conclusions the data does not support. Check the answers before you rely on them. If the AI tool offers to change data in dRofus, read what it plans to do before you confirm, just as you would when working directly in dRofus.

How do I disconnect?

  • Remove the dRofus connector in the AI tool's connector or MCP settings at any time.

  • If you no longer use the AI tool, or think someone else may have gained access to it, remove the connector right away and contact your dRofus administrator.

Do I need a paid AI plan?

  • You need a plan with the AI provider that allows custom connectors or remote MCP servers. Availability differs by provider and plan, and some business plans require an administrator to turn it on.

How to use the connector effectively

Once connected, start with small, low-risk queries to confirm that the tool is using the right project and returning expected results.

Good first tasks

  • List rooms in a department or level

  • Find rooms missing a required property

  • Retrieve details for a known room or item

  • List item occurrences for a selected room

  • Compare room or item data against a standard

Example prompts

List all operating rooms on Level 2 and show their room numbers and statuses.

Find rooms in Department A that are missing the required acoustic rating.

Show all equipment occurrences assigned to Room 3.215.

List item definitions related to surgical lighting and summarize the key fields.

Best practice: Be explicit about scope. Include the project, department, building, level, room type, or item class in your prompt whenever possible. This improves result quality and reduces the chance of acting on the wrong data.

Troubleshooting

The connector does not appear after setup

Check that the MCP server URL is correct, the client supports remote MCP servers and CIMD, and the connection was saved successfully. Then restart the client if needed and verify that authentication completed.

Authentication fails

Confirm that you are using the correct dRofus account for the selected environment and that the client is approved for use with the project data. Use browser sign-in only, as described in Before you connect. For Microsoft Copilot Studio, also check that dRofus has registered your callback URL and that the identity server matches your region. If authentication still fails, contact your dRofus administrators.

No dRofus tools are visible in the client

Make sure the connector is shown as active. If the client separates connection status from tool discovery, refresh or reopen the chat session after sign-in.

Claude loses the dRofus tools during a chat

Sometimes Claude stops using the dRofus tools, or says they are unavailable, even though the connector is shown as connected.

  1. Start a new chat. This usually brings the tools back.

  2. If that does not help, disconnect and reconnect the dRofus connector in Claude's connector settings, sign in again, and start a new chat.

The tools do not come back in the old chat, so copy any important context into the new chat.