Skip to main content
Cherry Studio is another AI client tool that supports MCP (Model Context Protocol). This document describes how to configure MCP Gateway in Cherry Studio.

​
Configuration Steps

1

Open Cherry Studio

Launch the Cherry Studio application
2

Access Settings

Find settings or configuration options in Cherry Studio
3

Configure MCP Connection

Add MCP Gateway connection information:
  • Server URL: http://localhost:5235/gateway/user/sse
  • Protocol: SSE (Server-Sent Events)
4

Test Connection

Save configuration and test if the connection is successful

​
Supported Endpoints

Cherry Studio supports the following MCP Gateway endpoints:

MCP Endpoints

  • SSE: http://localhost:5235/gateway/user/sse
  • Streamable HTTP: http://localhost:5235/gateway/user/mcp
  • Message: http://localhost:5235/gateway/user/message

​
Usage Example

After configuration is complete, you can do the following in Cherry Studio:
  1. View Available Tools: The interface will display the tool list retrieved from MCP Gateway
  2. Execute Operations: Communicate with AI through natural language and let AI call corresponding tools
  3. View Results: Observe the results of tool execution and returned data

​
Features

Cherry Studio can understand your needs and automatically select appropriate tools to execute operations
Save conversation history and tool execution records for easy review and repeated operations
Support configuring multiple MCP Servers to manage different business scenarios

​
Common Issues

  • Ensure MCP Gateway service is running
  • Check network connection and port access permissions
  • Verify URL configuration format is correct
  • Check if MCP Server configuration is correct
  • Check Cherry Studio’s error logs
  • Verify MCP Gateway’s tool configuration
  • Reasonably configure tool timeout settings
  • Avoid frequent long-duration operations
  • Consider using batch operations to reduce call frequency

​
Advanced Configuration

​
Multi-Service Configuration

If you have multiple business services, you can configure multiple MCP connections in Cherry Studio: 
User Service: http://localhost:5235/gateway/user/sse
Order Service: http://localhost:5235/gateway/order/sse
Product Service: http://localhost:5235/gateway/product/sse

​
Authentication Configuration

For services that require authentication, ensure necessary authentication information is included in request headers:
  • Bearer Token
  • API Key
  • Custom Headers
For specific authentication configuration methods, please refer to Cherry Studio’s official documentation or contact Cherry Studio’s technical support.

​
More Resources

Cherry Studio Official Website

Visit Cherry Studio’s official website for more information and help
⌘I