> 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/guides/guides-zh/sou-suo-ai-he-dang-an/jiang-shade-mcp-yu-claude-huo-cursor-yi-qi-shi-yong.md).

# 将 Shade MCP 与 Claude 或 Cursor 一起使用

将你的工作区连接到 Claude、ChatGPT 或 Cursor，并通过提示词在 Shade 中搜索、整理和自动化操作。

**结果：** 一个连接到你的 Shade 工作区的 AI 助手，可以根据自然语言请求查找资源、创建集合、更新元数据、创建共享链接，并起草自动化。

**适用于：** 任何已经在 Claude、ChatGPT、Cursor 或 VS Code 中工作，并希望从那里访问 Shade 的人。

**时间：** 大约 5 分钟即可连接。

## 开始之前

* 使用支持 MCP 连接器的 AI 客户端：Claude、ChatGPT、Cursor、VS Code，或其他 MCP 客户端。
* 这个助手可以执行你的 Shade 账户所能执行的任何操作，所以请使用一个其权限与你要请求的任务相匹配的账户进行连接。

{% hint style="info" %}
Shade MCP 会连接到你正在使用的工作区。它与 Academy MCP 是分开的，后者只会回答关于此文档的问题。
{% endhint %}

## 步骤

{% stepper %}
{% step %}

### 从 Shade 复制连接详情

在 Shade 中，前往 **设置 > 集成 > MCP 连接** 并选择你的客户端。如果你的客户端未列出，请复制通用 MCP URL。
{% endstep %}

{% step %}

### 将其添加到你的 AI 客户端

* **Claude：** 打开 Claude 的连接器设置，并将该 URL 作为自定义连接器粘贴。
* **ChatGPT：** 打开 **工具** 或 **连接器** 并使用该 URL 添加一个自定义连接器。
* **Cursor：** 打开 Cursor 的 **MCP** 设置，并使用该 URL 添加服务器。
* **VS Code：** 将提供的配置粘贴到你的 MCP 配置中。

在提示下登录以授权连接。每个客户端的完整步骤见 [Shade MCP](https://academy.shade.inc/ai-tools/the-shade-mcp).
{% endstep %}

{% step %}

### 决定哪些操作需要你的批准

在你的 AI 客户端工具设置中，要求对任何会更改数据的操作进行批准，例如移动或删除文件、编辑元数据以及创建共享链接。对于只读工具，例如搜索、浏览和查找重复项，则无需限制。
{% endstep %}

{% step %}

### 试试几个提示词

* `在 Brand 驱动器中查找我们 CEO 在 2025 年的采访视频`
* `把 ACME 驱动器中最好的 5 个无人机镜头放入一个名为“ACME selects”的新集合中`
* `将 /Projects/ACME/05_Delivery 中的每个文件的 Status 设置为 Approved`
* `为 ACME 驱动器中的 Review 文件夹创建一个具有评论权限的共享链接`
* `构建一个自动化：每当有文件上传到 /Incoming 时就给我发邮件`
  {% endstep %}
  {% endstepper %}

{% hint style="warning" %}
通过 MCP 创建的自动化最初都是草稿。请在 Shade 中打开它们，检查每一步，然后由你自己将其激活。
{% endhint %}

## 它不能做什么

不支持上传文件，而且 MCP 不会挂载驱动器。它与 Web 应用的工作方式相同，直接作用于你的工作区。

## 相关文章

* [构建可搜索的归档](/guides/guides-zh/sou-suo-ai-he-dang-an/gou-jian-ke-sou-suo-de-gui-dang.md)
* [你的第一个自动化](/guides/guides-zh/zi-dong-hua/ni-de-di-yi-ge-zi-dong-hua.md)
* [通过 webhooks 将 Shade 连接到其他工具](/guides/guides-zh/zi-dong-hua/tong-guo-webhooks-jiang-shade-lian-jie-dao-qi-ta-gong-ju.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/guides/guides-zh/sou-suo-ai-he-dang-an/jiang-shade-mcp-yu-claude-huo-cursor-yi-qi-shi-yong.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.