Connect MCP using a custom connector

  • Updated on Apr 30, 2026
  • Published on Mar 29, 2026
  • 7 minute(s) read
Prev Next

Document360 MCP server can be connected to AI assistants using MCP server URL or a JSON configuration file.

Custom connectors allow you to establish a secured connection between your knowledge base and supported AI assistants. Once connected, the AI assistant can interact with documentation content in your Document360 project through MCP.

Use the MCP server URL when your AI platform accepts a direct URL for connector setup (for example, Claude AI and Copilot). Use the JSON configuration when your AI platform requires a structured config file (for example, Cursor IDE).

Before you begin

Before setting up MCP, ensure the following:

  • You have a Project Owner or Admin role. Only these roles can enable or disable MCP for a project.

  • You have access to a supported AI assistant: ChatGPT, Claude AI, Cursor IDE, Copilot, or any platform that supports MCP or custom connectors.

Enable MCP

To enable MCP,

  1. Navigate to Settings () in the left navigation bar.

  2. Go to AI Settings > MCP.

  3. Click Enable MCP.

    A confirmation message appears asking whether you want to allow external AI assistants to access your knowledge base. Only Project Owners and Admins can enable or disable MCP for a project.

  4. Click Allow Access to proceed.

Document360 MCP settings page with tutorial video and options for AI configuration.

Once enabled, the MCP configuration becomes available under Custom Connectors.

NOTE

Enabling MCP allows structured access to your knowledge base. Content access continues to follow your existing project version, language, and visibility settings.

Get the JSON configuration

After enabling MCP,

  1. Under Custom Connectors, click Get details.

    User interface showing AI settings with highlighted 'Get details' button for custom connectors.

  2. The MCP configuration will be displayed.

  3. You can either copy the full JSON configuration or use the URL provided within it, depending on your AI assistant’s requirements.

    This configuration is required to establish the MCP connection in your AI assistant.

Configuration settings for connecting to Document360's custom connector interface.

MCP server URLs

Use the following MCP server URLs when configuring connectors in your AI assistant. Select the appropriate URL based on your project’s region or environment. Paste the URL into the MCP custom connector configuration field in your AI assistant.

Region

MCP configuration URL

EU region

https://mcp.document360.io/mcp

US region

https://mcp.us.document360.io/mcp

Canada region

https://mcp.ca.document360.io/mcp

Connect MCP to your AI assistant

After enabling MCP in Document360, you can connect your knowledge base to an AI assistant using the provided MCP JSON configuration. Depending on the AI platform, you may need to use either the MCP Server URL or the JSON configuration. The setup steps vary slightly across platforms.

The following sections outline the connection process for commonly used AI assistants such as ChatGPT, Claude, and Copilot.

To connect MCP IN ChatGPT:

  1. Open ChatGPT.

  2. Go to Settings.

  3. Navigate to Apps > Advanced settings.

  4. Enable Developer mode.

  5. Click Create app.

Settings menu showing Apps and Advanced settings options for ChatGPT.

Provide the following details:

  1. Name - Enter a label for the connection (for example, Document360 MCP).

  2. Description - (Optional) Add a description for reference.

  3. MCP Server URL - Paste the MCP Server URL provided in Document360.

  4. Authentication method - Select OAuth.

  5. Click Advanced settings.

  6. In the side panel that appears, scroll to the bottom.

  7. Uncheck the OIDC enabled option.

  8. Select the confirmation checkbox (I understand…).

  9. Click Create.

Settings for Document360 app including OIDC support and advanced configuration options.

After creating the app, you will be redirected to Document360. Review the connection request and choose the required project.

  1. Select the confirmation checkbox (I understand and trust this URL).

  2. Click Continue. You will be redirected to ChatGPT.

To start using the MCP connector in ChatGPT:

  • In the ChatGPT message box, type / to open a list of available options.

  • Scroll down to locate the added connectors, then select the Document360 connector by clicking on its provided name.

Menu options in Developer mode with Document360 highlighted for selection.

ChatGPT can now interact with your knowledge base using the MCP capabilities enabled in your project.

To connect MCP in Claude AI:

  1. Open Claude AI.

  2. Click your profile and navigate to Settings.Menu displaying settings option with shortcuts for easy navigation and access.

  3. Go to Connectors.

  4. Click Add.

  5. Choose Custom from the given options.

  6. Select Web or Desktop based on your requirement.

    If your organization allows to add custom connectors, you can proceed with the setup.

    If not, you may need to contact your organization admin to enable or grant permission to add custom connectors.

Settings page showing connectors with options to add and filter by type and category.

Provide the required details:

  1. Name - Enter a label (for example, Document360 MCP).

  2. Configuration - Paste the MCP server URL from the MCP configuration provided in Document360.

  3. Click Add.

  4. Navigate to Personal settings and locate the custom connector with the name you provided.

  5. Click Connect to establish the MCP connection.

After creating the connection:

  1. You will be redirected to Document360.

  2. Review the connection request and choose the required project.

  3. Select the confirmation checkbox (I understand and trust this URL).

  4. Click Continue.

The connection is now established. Claude AI can interact with your knowledge base using the MCP capabilities enabled in your project.

To connect MCP in Cursor IDE:

  1. Open Cursor IDE.

  2. Navigate to Settings.

  3. Go to Tools & MCP.

  4. Click Add new MCP server.

Settings menu showing Tools & MCP with options for browser automation and custom tools.

You will be redirected to the MCP configuration screen.

  1. Paste the MCP JSON configuration copied from Document360.

  2. Save it.

JSON structure showing Document360 server configuration with URL and type details.

After saving:

  1. Return to Cursor IDE Settings > Tools & MCP.

  2. Locate the configured MCP server.

  3. Once authentication is enabled, click Connect.

After creating the connection:

  1. You will be redirected to Document360.

  2. Review the connection request and choose the required project.

  3. Select the confirmation checkbox (I understand and trust this URL).

  4. Click Continue.

The connection is now established. You can use MCP capabilities directly within the Cursor IDE to search, retrieve, and update documentation while coding.

To connect MCP in Copilot agents:

Create a new agent

  1. Log in to your Copilot environment.

  2. Navigate to Agents.

  3. Click Create blank agent.

  4. Enter a name for the agent.

  5. Click Create.

Creating a new agent named Document360 in Copilot Studio interface.

You will be redirected to the newly created agent.

Add MCP as a tool

  1. In the agent page, navigate to the Tools tab in the top navigation bar.

  2. Click Add a tool.

  3. Select Model Context Protocol.

Configure MCP settings

  1. Enter the following details:

    • Name – Provide a name for the MCP connector

    • Description – Enter a description (minimum 30 characters)

    • URL – Paste the appropriate MCP server URL

  2. Under Authentication method, select OAuth 2.0.

  3. Ensure Dynamic discovery is selected by default.

  4. Click Create.

Form for adding a Model Context Protocol server with required fields and options.

Establish connection

  1. After creating the tool, a Connection screen will appear showing Not connected.

  2. Click Not connected.

  3. Select Create new connection.

  4. Click Create.

Document360 tool setup screen showing connection options and instructions for creating connections.

After creating the connection:

  1. You will be redirected to Document360.

  2. Review the connection request and choose the required project.

  3. Select the confirmation checkbox (I understand and trust this URL).

  4. Click Continue.

The connection is now established. Copilot agent can interact with your knowledge base using the MCP capabilities enabled in your project.

NOTE

MCP support may vary depending on the AI assistant or client being used (such as IDE-based assistants or experimental tools). Some platforms may have limited or evolving support for MCP capabilities. The available fields and interface may vary slightly depending on the AI platform. Refer to your AI assistant’s documentation for compatibility details.

After connecting

After a successful connection, you can use MCP-supported capabilities through your AI assistant, including:

  • Searching documentation across project versions and languages

  • Retrieving full article content by ID or URL

  • Creating new articles and categories (if write permissions are configured)

  • Updating existing articles while preserving structure and formatting

All interactions respect your existing configuration, including project versions, languages, and visibility rules. For a detailed explanation of the available MCP capabilities and how they work in Document360, refer to the Supported MCP tools article.

Verify the MCP connection

After configuring MCP in your AI assistant, you can verify the connection.

  1. Open your AI assistant.

  2. Start a new conversation.

  3. Enter a query related to your documentation.

For example:

  • Ask for details about a specific feature.

  • Search and retrieve content from a particular project version or language.

  • Ask it to write an article in any specific category in Document360

If the connection is successful, the AI assistant will return results sourced from your Document360 knowledge base.
If no results are returned or an error appears, verify:

  • MCP is enabled in Document360.

  • The JSON configuration was copied correctly.

  • The connector is active in your AI assistant.

If the issue persists, re-authenticate by disconnecting and reconnecting the MCP connector, or contact Document360 support.

NOTE

The AI assistant can only access content permitted by your project’s version, language, and visibility settings.

Disable MCP

To disable MCP:

  1. Navigate to Settings () in the left navigation bar.

  2. Go to AI Settings > MCP.

  3. Click Disable MCP.

  4. Confirm the action in the dialog that appears.

Once disabled, all active MCP connections will stop functioning and any existing sessions will be terminated. Access tokens are also revoked. If you re-enable MCP, connected AI assistants will need to reconnect.

FAQ

What happens if MCP is disabled?

If MCP is disabled in Document360, external AI assistants will no longer be able to access your knowledge base through the MCP connection.

All active connections will stop functioning, and any existing sessions will be terminated. Access tokens are also revoked, requiring reconnection if MCP is enabled again.

Can I restrict which users connect through MCP?

Yes. Access through MCP is tied to the user account used during OAuth authentication. MCP operations follow Document360’s role-based access control (RBAC), so the AI assistant can only access content permitted for that user based on their assigned roles and permissions.

Does enabling MCP allow external tools to access all content?

No. MCP access follows your existing project configuration, including:

  • Project versions

  • Language settings

  • Role-based permissions

  • Visibility rules

Restricted or unpublished content remains subject to these rules.

Which AI assistants can connect to Document360 MCP?

Document360 MCP can be connected to AI assistants that support MCP or custom connector configurations. This includes tools such as ChatGPT, Claude, Copilot, and any other AI platforms that allow external integrations. Support may vary depending on the AI assistant’s implementation and available features.

You can connect to MCP using supported AI assistants with either a personal or an organizational account, depending on your setup. This depends on the AI assistant you are using and whether it allows custom connectors.

Is MCP usage restricted to specific devices?

No. MCP is not limited to a specific device. You can use MCP across supported environments and devices, depending on the AI assistant you are using.

Related articles