跳到主要内容

快速接入

更新时间: 2025-05-08

📚 说明

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

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

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

🔌 接入方式

通过Stdio接入

纳米 AI配置

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

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

纳米配置界面

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

    注意:请先完成360AI云盘开放平台用户鉴权,获取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列表中查看360AI云盘MCP Server启用状态

    MCP Server启用状态

在纳米 AI 客户端中使用

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

    MCP Server启用状态

  2. 尝试使用360AI云盘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环境无需本地环境无需本地环境
连接特性稳定本地连接按需连接持久连接,自动重连