跳到主要内容

快速接入

更新时间: 2025-06-03

📚 说明

凡是支持MCP协议的平台(如纳米 AI、Cherry Studio、Claude、Cursor、Cline)均能够快速接入360 AI云盘MCP Server, 支持通过 Stdio、Streamable HTTP 或 SSE 方式接入使用。

提示:以纳米 AI平台接入为例,在进行接入操作前,建议用户先安装并使用最新版本的纳米 AI客户端

环境要求:本地需要安装 Node.js 运行环境(v16+)。如果未安装,请从Node.js 官网下载安装。

🔌 接入方式

通过Stdio接入

纳米 AI配置

  1. (方式 1)打开纳米AI客户端,在MCP中添加MCP Server

注意:请先完成360 AI云盘开放平台用户鉴权,获取API_KEY 参考【使用入门-使用准备】。

纳米配置界面

  1. (方式 2)在cursor等其他客户端的mcp.json配置文件中进行配置

    注意:请先完成360 AI云盘开放平台用户鉴权,获取API_KEY、clientId、clientSecret。 参考【使用入门-使用准备】。

    Mac 系统配置

    {
    "mcpServers": {
    "360-netdisk-mcp": {
    "command": "npx",
    "args": [
    "-y",
    "@aicloud360/mcp-server-disk"
    ],
    "env": {
    "API_KEY": "_xxxxxxxxx"
    }
    }
    }
    }

    Windows 系统配置

    {
    "mcpServers": {
    "360-netdisk-mcp": {
    "command": "cmd",
    "args": [
    "/c",
    "npx",
    "-y",
    "@aicloud360/mcp-server-disk"
    ],
    "env": {
    "API_KEY": "_xxxxxxxxx"
    }
    }
    }
    }
  2. 回到配置,可在MCP Servers列表中查看360 AI云盘MCP Server启用状态

    MCP Server启用状态

在纳米 AI 客户端中使用

  1. 在对话框中,选择 360-netdisk-mcp 工具

    MCP Server启用状态

  2. 尝试使用360 AI云盘MCP Server进行文件上传、下载、删除、重命名、移动、查看文件列表等操作

    MCP Server启用状态 MCP Server启用状态

通过Streamable HTTP接入

Streamable HTTP 接入方式支持通过 HTTP 协议直接连接到云盘 MCP 服务,无需本地安装 Node.js 环境,适合在各种平台和环境中使用。

Cursor 配置方式

  1. 打开 Cursor 编辑器,找到 MCP 配置文件位置:

    • Mac 系统~/Library/Application Support/Cursor/mcp.json
    • Windows 系统%APPDATA%\Cursor\mcp.json
  2. 在配置文件中添加以下内容:

    {
    "mcpServers": {
    "mcp-server-disk-http": {
    "url": "https://mcp.yunpan.com/mcp?api_key=_xxxxxxxxx"
    }
    }
    }

    注意

    • api_key 参数需要替换为您在使用准备中获取的 API KEY
  3. 保存配置文件后重启 Cursor 编辑器,MCP 服务将自动连接

  4. 在 Cursor 中使用时,可以直接调用云盘相关功能,如:

    • 文件列表查询
    • 文件搜索
    • 文件保存
    • 文件移动和重命名等(更多开放功能:请参考功能说明

其他平台配置

其他支持 MCP 协议的平台(如 Claude、Cherry Studio 等)也可以通过类似方式配置 Streamable HTTP 接入,具体配置方法请参考各平台的 MCP 配置文档。

通过SSE接入

SSE (Server-Sent Events) 接入方式提供了一种轻量级的服务器推送技术,适合需要实时数据更新的场景,无需本地环境依赖,配置简单快捷。

配置方式

  1. 找到您使用平台的 MCP 配置文件位置:

    • Mac 系统
      • Cursor: ~/Library/Application Support/Cursor/mcp.json
      • Claude: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows 系统
      • Cursor: %APPDATA%\Cursor\mcp.json
      • Claude: %APPDATA%\Claude\claude_desktop_config.json
  2. 在配置文件中添加以下内容:

    {
    "mcpServers": {
    "mcp-server-disk-sse": {
    "url": "https://mcp.yunpan.com/sse?api_key=_xxxxxxxxx"
    }
    }
    }

    注意

    • api_key 参数需要替换为您在使用准备中获取的 API KEY
    • SSE 模式提供了更轻量级的连接方式,适合大多数基础云盘操作
  3. 保存配置文件后重启您的 AI 助手应用,MCP 服务将自动连接

  4. 使用时,可以直接调用云盘相关功能,如文件列表查询、文件搜索、文件保存等(更多开放功能:请参考功能说明

接入方式对比

特性Stdio接入Streamable HTTP接入SSE接入
连接方式本地进程通信双向HTTP请求/响应单向服务器推送
适用场景全功能操作,包括文件上传下载查询和管理功能,不支持文件上传下载查询和管理功能,不支持文件上传下载
配置复杂度需配置本地环境简单简单
本地依赖需要Node.js环境无需本地环境无需本地环境
连接特性稳定本地连接按需连接持久连接,自动重连