MCP Client Configuration

This page summarizes MCP client setup for Kuroco. Replace https://your-kuroco-domain.com/mcp with your actual Kuroco MCP endpoint in all examples.

For the full implementation walkthrough, see: Model Context Protocol (MCP) Integration with Kuroco.

Supported clients

Chat-based clients

Client	MCP Support	Connectable to Kuroco	Implementation Type	Supports header authentication
Jan	✅	✅	Full (Read/Write)	✅
Claude Desktop	✅	✅	Full (Read/Write)	❌
Microsoft Copilot Studio	✅	✅	Full (Read/Write)	❌
ChatGPT	✅	✅	Limited (Read-only)*	❌

Coding assistants

Client	MCP Support	Connectable to Kuroco	Implementation Type	Supports header authentication
Claude Code	✅	✅	Full (Read/Write)	✅
Codex CLI	✅	❌	Local only	❌
Cursor	✅	✅	Full (Read/Write)	✅

Custom implementations

Client	MCP Support	Connectable to Kuroco	Implementation Type	Supports header authentication
Python MCP Server	✅	✅	Full (Read/Write)	✅
TypeScript MCP Server	✅	✅	Full (Read/Write)	✅
Other custom clients	✅	✅	Full (Read/Write)	✅

Implementation types:

• Full (Read/Write): Complete MCP support with both data retrieval and modification capabilities
• Limited (Read-only): MCP support restricted to data retrieval and search operations only
• Local only: No remote MCP support

Notes:

• *ChatGPT: Currently supports read-only operations through Deep Research mode. Available for Enterprise, Education, Team, and Plus users.

Security of Kuroco APIs used for MCP connections

Public endpoint

To use MCP without authentication, set the API security to None in Kuroco and enable MCP on the target endpoint. Clients can then connect by providing only the MCP server URL — no token or header configuration is required.

Clients where Supports header authentication is ❌ can only use this setup.

caution

Public endpoints are not recommended for production use. Since no authentication is required, anyone who knows the URL can access the API and request origin cannot be tracked. If you must use a public endpoint, restrict it to read-only operations and only expose data that is truly safe to make public. Never expose write endpoints without authentication.

Authenticated endpoint

Clients where Supports header authentication is ✅ can connect to endpoints protected by an access token, enabling read and write operations on non-public endpoints. Using a privileged static token is recommended.

To configure authentication:

1. Open the Swagger UI of the Kuroco API whose security is set to privileged static token.
2. Click Generate in the upper right corner, fill in the required information, and copy the generated token.
3. Set the token as a request header in your MCP client configuration.

The header name is X-RCMS-API-ACCESS-TOKEN. Refer to each client's setup instructions below for the exact configuration syntax.

Chat-based clients

Jan

Jan supports MCP servers from Settings -> MCP Servers.

Official reference:

• Using MCP in Jan

Claude (Web / Desktop / Mobile)

Custom connectors using remote MCP are available on Claude and Claude Desktop. After adding to your account, you can also use connectors on mobile.

1. Open Settings > Connectors.
2. Click Add custom connector.
3. Enter your remote MCP URL: https://your-kuroco-domain.com/mcp.

Official references:

• Getting started with custom connectors using remote MCP
• Pre-built web connectors using remote MCP

Microsoft Copilot Studio

Copilot Studio supports MCP over streamable HTTP. Unauthenticated endpoint: Supported (Authentication type: None in the onboarding wizard).

1. Open your agent and go to Tools.
2. Click Add a tool.
3. Select Model Context Protocol.
4. Connect your MCP server URL.
5. Choose Authentication type: None for a public endpoint.

Official references:

• Connect your agent to an existing MCP server
• Add tools and resources from MCP server

ChatGPT Apps (Developer mode)

Use custom MCP apps in ChatGPT Developer mode.

Important behavior:

• Full MCP (including write/modify actions) is in beta for Business and Enterprise/Edu.
• Pro users can connect MCP with read/fetch permissions in developer mode.
• Deep research can use custom apps for read/fetch only.
• Agent mode does not use custom apps.

Setup:

1. Enable Developer mode for your workspace/user role.
2. Go to Apps -> Create.
3. Enter your MCP endpoint and metadata.

Official reference:

• Developer mode, and MCP apps in ChatGPT (beta)

Coding assistants

Claude Code

Basic setup (public endpoint):

claude mcp add --transport http kuroco https://your-kuroco-domain.com/mcp
claude mcp list

Authenticated endpoint (note: --header must come after the URL):

claude mcp add --transport http kuroco https://your-kuroco-domain.com/mcp --header "X-RCMS-API-ACCESS-TOKEN: your-token"

Project-scoped setup:

claude mcp add --scope project --transport http kuroco https://your-kuroco-domain.com/mcp
claude mcp add --scope project --transport http kuroco https://your-kuroco-domain.com/mcp --header "X-RCMS-API-ACCESS-TOKEN: your-token"

Official reference:

• Claude Code MCP

Codex CLI

Add a remote MCP server directly:

codex mcp add kuroco --url https://your-kuroco-domain.com/mcp
codex mcp list

Official reference:

• Docs MCP quickstart (Codex section)

Cursor

Configure in mcp.json:

{
  "mcpServers": {
    "kuroco": {
      "url": "https://your-kuroco-domain.com/mcp"
    }
  }
}

Official reference:

• Cursor MCP docs

Zed

Configure in settings.json:

{
  "context_servers": {
    "kuroco": {
      "url": "https://your-kuroco-domain.com/mcp"
    }
  }
}

Official reference:

• Zed MCP docs

GitHub Copilot Chat (VS Code)

Use VS Code MCP config (mcp.json) and pass header tokens via env/input variables. Unauthenticated endpoint: Supported with URL-only configuration.

{
  "servers": {
    "kuroco": {
      "type": "http",
      "url": "https://your-kuroco-domain.com/mcp"
    }
  }
}

Official references:

• Using MCP with GitHub Copilot
• VS Code MCP configuration reference

GitHub Copilot coding agent

Copilot coding agent supports MCP tools in repository settings. Unauthenticated endpoint: Supported.

Kuroco-fit note:

• Kuroco MCP exposes tool calls over HTTP, which matches coding agent usage.

Official references:

• MCP and Copilot coding agent
• Extending Copilot coding agent with MCP

Custom implementations

Python / TypeScript / others

• Python: use the official MCP Python SDK to expose an HTTP server, then register that endpoint in your MCP client.
• TypeScript: use an MCP HTTP server SDK and register your endpoint in your MCP client.
• Other languages: expose an HTTP MCP server and point your client to https://your-kuroco-domain.com/mcp.