> 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/shade-mcp.md).

# Shade MCP

Shade MCP 可将你的工作区直接连接到你已在使用的 AI 工具和代理，例如 Claude、ChatGPT、Cursor，或任何其他兼容 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://3843445310-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&amp;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>

#### 其他 MCP 客户端

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

<figure><img src="https://3843445310-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&amp;token=dfa0fa53-d4c4-4bf6-9d46-b9f27b765232" alt=""><figcaption></figcaption></figure>

### Shade MCP 可以做什么

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

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

* 自动化
* 集合
* 评论
* 文件
* 元数据
* 自定义对象
* 共享链接
* 视图

**只读：**

* 浏览 Shade
* 查找重复项
* 获取资产和资产预览
* 获取下载 URL
* 搜索
* 访问并读取转录内容
* 列出工作区和驱动器

### 示例工作流

**将项目管理工具与自定义对象自动同步：** 连接另一个平台的 MCP（Notion、Asana、ClickUp、HubSpot）以及 Shade 的 MCP，然后让你的 LLM 从该工具中提取数据，并在 Shade 中构建一个匹配的自定义对象。例如，“从我的 Notion 内容日历中提取所有数据，将其设置为一个自定义对象，并在每天晚上 5 点将两个平台同步。” 元数据字段和选项会被保留，而且在任一平台上的编辑都会按照你设定的计划进行协调。

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

**在已连接的工具之间移动数据：** 通过将 Shade 与其他 MCP 并行连接，代理可以一步跨平台执行操作，从项目管理工具中提取简报并将匹配的资产收集到 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/zi-ding-yi-dui-xiang.md)

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

[Zapier 集成](/shade-academy/shade-academy-zh/gong-zuo-qu-he-qu-dong-qi/zapier-ji-cheng.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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.