How to Register an MCP Connector in Claude.ai

This page explains how to connect Kuroco MCP to Claude.ai.

By connecting MCP, you can simply ask a question in Claude.ai such as "How do I configure authentication in Kuroco?" and get an answer based on the knowledge registered in Kuroco.

Terminology

What is MCP (Model Context Protocol)?

It is a standard specification that lets an AI (such as Claude.ai) connect to external tools and data. Kuroco provides an MCP server, allowing Claude.ai to call Kuroco APIs directly.

What is a connector?

It is a feature in Claude.ai for integrating with external services. By registering an MCP server, Claude.ai can call that service's tools.

Prerequisites

Claude.ai plan

Plan	Connector usage
Free	You can add up to one custom connector
Pro / Max	You can add multiple custom connectors
Team / Enterprise	A member with Organization owner permissions adds and manages connectors

caution

On the Team / Enterprise plan, you cannot add a connector without owner permissions. If the "Connectors" menu is not displayed, ask the owner of your workspace to add it.

Preparation on the Kuroco side

You need a Kuroco API endpoint with the MCP server enabled (for example, https://{your-site}.g.kuroco.app/rcms-api/{id}/mcp).

If you have not yet configured the MCP server, first complete the setup by referring to Model Context Protocol (MCP) Integration with Kuroco.

Step 1: Open the Connectors screen

1. Click "Customize" in the left sidebar of Claude.ai.

   

2. The Customize screen opens. Click "Connectors" in the left menu.

   

tip

You can reach the same screen from the account icon at the bottom left → "Settings" → "Customize" → "Connectors".

Step 2: Add a custom connector

1. Click the "+" button at the top right of the connector list screen.

   

2. When the menu appears, click "Add custom connector".

   

3. The "Add custom connector" dialog opens. Enter the following items.

   

   Item	Value to enter	Example
   Name	The connector name (arbitrary)	Kuroco
   Remote MCP server URL	The Kuroco MCP endpoint URL	https://{your-site}.g.kuroco.app/rcms-api/{id}/mcp
   OAuth Client ID	The Client ID issued by Kuroco in a later step	(enter later)
   OAuth Client Secret	Not required for this setup	(leave blank)

caution

Do not click "Add" at this point. You first need to configure OAuth on the Kuroco side. You may leave this dialog open, or close it and reopen it later.

Step 3: Create an OAuth IdP in Kuroco

Log in to the Kuroco admin panel and create an OAuth IdP using the following steps.

3-1. Open the OAuth IdP list

From the left menu, open "External System Integration" → "OAuth IdP".

3-2. Add an OAuth IdP

Click the "+ Add" button at the top right and configure it as follows.

info

Change the URL to match your own Kuroco domain.

Item	Value
Name	Arbitrary (e.g., claude)
Purpose	API
Allow Dynamic Client Registration (DCR)	Enabled
Supported grant types	Check authorization_code and refresh_token
Access token lifetime	3600 (seconds)
Refresh token lifetime	2592000 (seconds)
Authorization code lifetime	60 (seconds)
Enabled	ON
Login page URL	https://{your-domain}.g.kuroco-mng.app/management/login/login/

Once the settings are complete, click "Add" to save.

After adding, the created IdP appears in the list screen.

tip

We recommend keeping a single IdP with the "API" purpose. If an "API"-purpose IdP already exists for another service such as ChatGPT, do not create a new one; instead, add a client for claude from that IdP's "Manage clients".

Step 4: Add an OAuth IdP client

4-1. Open the client list

On the IdP list screen, click "Manage clients" in the row of the IdP you created.

The OAuth IdP client list opens. Click the "+ Add" button at the top right.

4-2. Add a client

Configure it as follows.

Item	Value
Client name	Arbitrary (e.g., claude)
Token endpoint authentication method	none (public client (PKCE only))
Redirect URI	https://claude.ai/api/mcp/auth_callback
Supported grant types	Check authorization_code
Enabled	ON

When you click "Add", a Client ID is issued automatically. Make a note of the Client ID displayed in the client list.

note

Because the authentication method is set to none (PKCE only), you only need to enter the Client ID on the Claude.ai side. No client secret is required.

Step 5: Enter the Client ID in Claude.ai and connect

1. Open the "Add custom connector" dialog from Step 2 (leave it as is if it is still open).

2. Enter the following.

   

   Item	Value to enter
   Name	Arbitrary (e.g., Kuroco)
   Remote MCP server URL	https://{your-site}.g.kuroco.app/rcms-api/{id}/mcp
   OAuth Client ID	The Client ID you noted in Step 4
   OAuth Client Secret	Leave blank

3. Click "Add".

4. It is added to the connector list, and a "Connect" button appears on the detail screen.

   

5. When you click "Connect", the Kuroco login screen opens.

   

6. After you log in with your Kuroco account, an access permission confirmation screen appears.

   

7. Review the content and click "Allow" to complete authentication. The connector is now in a connected state.

caution

Perform the operations from login to "Allow" quickly. If the authorization code lifetime (60 seconds) expires, you will get a Consent request is invalid or expired error. In that case, start over from "Connect" on the Claude.ai side.

Step 6: Verify the connection

6-1. Check the tool list

Click the Kuroco connector you registered in the connector list to display the list of available tools. If you can see tool names such as knowledge_search, the connection was successful.

6-2. Try it in a chat

1. Open a new chat.

2. Click the "+" button at the bottom left of the chat input field.

   

3. Select "Connectors" and toggle the Kuroco connector ON.

   

4. Send the following prompt to verify the behavior.

   "Retrieve just one piece of knowledge registered in Kuroco."

If the connection is successful, you will see that the knowledge_search tool was called, and the response will include content retrieved from Kuroco.

Related documents

• Model Context Protocol (MCP) Integration with Kuroco — A guide to MCP setup on the Kuroco side