快速开始

本篇文档旨在帮助您在几分钟内完成 Native MCP 的环境准备与配置， 快速在您的客户端应用中启用 IM 通信能力。

准备工作

在开始之前，请确保您已准备就绪：

• 融云账户凭证:
  • App Key: 在融云控制台创建应用后获取。
  • 用户 Token: 通过 Server API 的 获取 Token 接口获取。强烈建议通过您的业务服务器来调用此接口，以确保安全。
• 数据中心区域码（Area Code）:

  • 在融云控制台的应用管理页面中查看您应用对应的数据中心，数据中心对应的区域码为 1: 北京, 2: 新加坡, 3: 北美, 4: 新加坡B, 5: 沙特。

    
• 客户端环境:
  • 已安装 Cursor 或 Cherry Studio 等支持 MCP 协议的客户端。
• 软件环境:
  • 已安装 pip。
  • 已安装 uv。如果尚未安装，请执行 pip install uv。

---

接入步骤

由于 Native MCP 是一个客户端本地服务，其接入方式是在您的 MCP 客户端中进行配置。

在 Cursor 中配置

1. 打开 Cursor 设置，并添加一个全局 MCP Server。

   

2. 在 mcpServers 中添加如下配置，并将 env 中的占位符替换为您的实际凭证：

   JSON

   {
     "mcpServers": {
       "rongcloud-native-mcp-python": {
         "name": "rongcloud-native-mcp-python",
         "type": "stdio",
         "command": "uvx",
         "args": ["rongcloud-native-mcp-python"],
         "env": {
             "APP_KEY": "your_app_key",
             "TOKEN": "your_user_token",
             "AREA_CODE": "your_area_code",
             "NAVI_URL": "your_navi_url",
             "STAT_URL": "your_stat_url"
         }
       }
     }
   }

   环境变量说明

   变量名	是否必填	说明
   APP_KEY	是	您在融云开发者后台获取的应用 App Key。
   TOKEN	是	用于向融云 IM 服务进行认证的用户 Token。
   AREA_CODE	否	数据中心区域码。1: 北京, 2: 新加坡, 3: 北美, 4: 新加坡B, 5: 沙特。默认为 1。
   NAVI_URL	否	导航服务器地址，仅私有云客户需要配置。
   STAT_URL	否	统计服务器地址，仅私有云客户需要配置。

在 Cherry Studio 中配置

1. 在 Cherry Studio 中，进入服务器配置页面。

   

2. 参考在 Cursor 中的配置，填入类似的参数以启动服务。

---

启动与验证

配置完成后，启动 MCP 服务。如果服务状态正常（例如，在 Cursor 中显示为绿色圆点），即表示 Native MCP 已成功运行，您可以开始在对话中调用其提供的工具。