> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-zh/ai-gong-ju/the-shade-mcp.md).

# Shade MCP

Shade MCP 可将你的工作区直接连接到你已经在使用的 AI 工具和代理中，例如 Claude、ChatGPT、Cursor、VS Code，或任何其他兼容 MCP 的客户端。连接后，你的助手可以搜索素材、读取和更新自定义对象、构建自动化，并管理共享和元数据，所有操作都可通过提示完成，无需打开 Shade。

> 注意：Shade MCP 不同于 Academy Shade MCP，后者只回答有关 Shade 文档的问题。Shade MCP 连接到你的实时工作区，可以读取并修改你的实际数据。

{% embed url="<https://youtu.be/lAas9Sekjvk?si=n-h5UwLaK1VlYi_R>" %}

### 开始使用

从以下位置连接 Shade MCP **设置 → 集成 → MCP 连接**。你会看到我们最常见平台的预置选项。如果你的平台未列出，请复制本页的通用 MCP URL，并将其粘贴到客户端的自定义连接器字段中。

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2Ff78z6qfRtR9BggQRugEM%2FScreenshot%202026-07-14%20at%205.15.39%E2%80%AFPM.png?alt=media&#x26;token=8bbbd24e-8a35-49c4-9c55-5f7b04f7d0ed" alt=""><figcaption></figcaption></figure>

#### Claude

1. 在 Shade 中，进入 **设置 → 集成 → MCP 连接**.
2. 选择 **Claude**.
3. 按照提示打开 Claude 的连接器设置。
4. 将提供的 URL 粘贴到自定义连接器字段中。
5. 通过 OAuth 登录以授权连接。
6. 使用如下提示进行测试：

   <mark style="color:红色;">`在我的 Fall Campaign 云盘中查找所有标记为“hero shot”的素材`</mark>

   <mark style="color:红色;">`为这个文件夹创建一个带评论权限的共享链接`</mark>

#### ChatGPT

1. 在 Shade 中，进入 **设置 → 集成 → MCP 连接**.
2. 选择 **ChatGPT**.
3. 打开你的 **工具** 或 **连接器** 设置。
4. 在添加自定义连接器时，粘贴提供的 URL。
5. 授权该连接。
6. 使用如下提示进行测试：

   <mark style="color:红色;">`在我的工作区中搜索上周上传的内容`</mark>

   <mark style="color:红色;">`列出我的 Clients 云盘中的自定义对象`</mark>

#### Cursor

1. 在 Shade 中，进入 **设置 → 集成 → MCP 连接**.
2. 选择 **Cursor**.
3. 打开 Cursor 的 **MCP** 设置并添加服务器。
4. 粘贴提供的 URL。
5. 授权该连接。
6. 使用如下提示进行测试：

   <mark style="color:红色;background-color:red;">`拉取我的 Deliverables 对象的元数据架构`</mark>

#### VS Code

1. 在 Shade 中，进入 **设置 → 集成 → MCP 连接**.
2. 选择 **VS Code**.
3. 将提供的 MCP 配置复制到你的 VS Code MCP 配置中。
4. 授权该连接。

#### 其他 MCP 客户端

1. 在 Shade 中，进入 **设置 → 集成 → MCP 连接**.
2. 复制通用 MCP URL。
3. 将其粘贴到客户端的自定义连接器或 MCP 服务器字段中。
4. 通过 OAuth 授权连接。

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2Fo7Shys1WhrSIaQTkZQW2%2FScreenshot%202026-07-14%20at%205.18.27%E2%80%AFPM.png?alt=media&#x26;token=dfa0fa53-d4c4-4bf6-9d46-b9f27b765232" alt=""><figcaption></figcaption></figure>

### Shade MCP 可以做什么

连接后，你可以准确查看 MCP 被允许执行哪些操作，并在 AI 客户端的工具设置中指定哪些操作需要你的批准。

**管理** （创建、编辑和删除）：

* 自动化（也可开启或关闭，并查看历史运行记录）
* 自定义对象（对象类型、字段和记录）
* 视图

**有限操作** （仅限列出的内容）：

* 集合：列出和创建集合，并添加或移除素材
* 评论：读取和添加评论
* 文件：移动、重命名（包括批量重命名）、复制、创建文件夹、移至垃圾箱和删除。不支持上传文件。
* 元数据：读取云盘字段，读取和设置值（包括批量），创建新字段，并为选择字段添加选项
* 共享链接：列出和创建共享链接

**只读：**

* 浏览 Shade
* 查找重复项
* 获取素材和素材预览
* 获取下载 URL
* 搜索
* 访问并阅读转写内容
* 列出工作区和云盘

### 示例工作流

**将项目管理工具与自定义对象同步：** 将其他平台的 MCP（Notion、Asana、ClickUp、HubSpot）与 Shade 的 MCP 并排连接，然后让你的 LLM 从该工具中提取数据，并在 Shade 中构建一个匹配的自定义对象。例如，“将我 Notion 内容日历中的所有数据提取出来，并将其设置为一个自定义对象。” 元数据字段和选项会一并保留。Shade 不会自行按计划运行同步，因此要让两个平台保持最新，请再次运行提示，或者如果你的 AI 客户端提供计划功能，也可以使用它们。

**通过提示构建自动化：** 与其逐块构建自动化，不如直接描述工作流。例如，“每当文件上传到我的 rough exports 文件夹时，生成一个带评论权限的共享链接，并以主题‘New Export Delivery’将其通过邮件发送给 <timothy@shade.inc>。” MCP 会按要求构建该自动化。

**在已连接的工具之间移动数据：** 当 Shade 与其他 MCP 一起连接时，代理可以一步跨平台执行操作，例如从项目管理工具中提取简报，并将匹配的素材收集到 Shade 集合中，或把生成的共享链接回传到外部跟踪器中。

[Shade 如何使用 Shade MCP](https://www.youtube.com/playlist?list=PLWwQgtasVlKA)

### 注意事项

Shade MCP 独立于 **Academy Shade MCP**。文档问题请使用 Academy MCP，而涉及你实际工作区的任何内容请使用 Shade MCP。

### 相关内容

[自定义对象](/shade-academy/shade-academy-zh/zi-dong-hua-yu-zi-ding-yi-dui-xiang/custom-objects.md)

[自动化](/shade-academy/shade-academy-zh/zi-dong-hua-yu-zi-ding-yi-dui-xiang/automations.md)

[Zapier 集成](/shade-academy/shade-academy-zh/gong-zuo-qu-he-qu-dong-qi/zapier-integration.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/shade-academy/shade-academy-zh/ai-gong-ju/the-shade-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.