--- title: "Connect MCP using a custom connector" slug: "connect-mcp-using-a-custom-connector" updated: 2026-06-06T12:10:52Z published: 2026-06-06T12:10:52Z stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # Connect MCP using a custom connector Document360 MCP server can be connected to AI assistants using **MCP server** URL or a JSON configuration file. Readers can connect to Claude in a supported manner and access the article content through the 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/enbale%20mcp%201.png) Once enabled, the MCP configuration becomes available under **Custom Connectors**. > [!NOTE] > 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/mcp%20get%20details%202.png) 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configuration%20in%20mcp%203(1).png) --- ## 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. ### ChatGPT 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/chatgpt%20advanced%20settings.png) 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/advanced%20settingd%20-%20oidc%20disable.png) 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/chatgpt%20slash.png) ChatGPT can now interact with your knowledge base using the MCP capabilities enabled in your project. --- ### Claude AI 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Claude%20settings.png) 3. Go to **Connectors**. 4. Click **Add.** 5. Choose **Custom** from the given options. 6. Select **Web** or **Desktop** based on your requirement. > [!WARNING] > 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Claude%20custom%20connector.png) 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. --- ### Cursor IDE 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/cursor%20ide%20add%20mcp.png) 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1774611048247.png) 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. --- ### Copilot 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/create%20agent%20in%20copilot.png) 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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/copilot%20-%20enter%20infos.png) **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.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/copilot%20-%20not%20connected%20-%20create%20new%20connection.png) 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] > 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](https://docs.document360.com/docs/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](https://document360.com/contact-us/). > [!NOTE] > 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. **Which account is recommended for using MCP?** 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. **Can readers connect to Claude to access and read the article content?** Yes. Readers can connect Claude in the supported manner and access article content through the Integration. Readers have read-only access specifically, they can only retrieve published articles, since their permissions are limited to content that is publicly visible in the knowledge base.