> 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/shi-yong-ai-he-academy-shade-mcp.md).

# 使用 AI 和 Academy Shade MCP

使用此服务器 URL 将 Academy Shade MCP 连接到任何兼容 MCP 的客户端：

`https://academy.shade.inc/~gitbook/mcp`

如果你的客户端支持远程 MCP 服务器，设置通常不到一分钟即可完成。

### 快速下拉菜单

你可以直接从文档中添加 MCP 或复制上下文。

<figure><img src="/files/06f927703c387d38173150786ce6076a1fe4b620" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
不同的客户端使用不同的名称。你可能会看到 **MCP 服务器**, **连接器**, **工具**，或 **集成**。流程是一样的。
{% endhint %}

{% tabs %}
{% tab title="Claude" %}

1. 打开 Claude 的 **设置**.
2. 找到 **MCP**, **工具**，或 **集成** 区域。
3. 添加一个新服务器。
4. 将其命名为 **Academy Shade**.
5. 粘贴此 URL：

   `https://academy.shade.inc/~gitbook/mcp`
6. 保存服务器。
7. 如有需要，请刷新 Claude。
8. 使用以下内容进行测试：
   * `如何在 Shade 中设置工作区？`
   * `访客和成员有什么区别？`
     {% endtab %}

{% tab title="Cursor" %}

1. 打开 Cursor **设置**.
2. 前往 **MCP** 或 **工具** 部分。
3. 添加一个新的 MCP 服务器。
4. 将其命名为 **Academy Shade**.
5. 粘贴此 URL：

   `https://academy.shade.inc/~gitbook/mcp`
6. 保存服务器。
7. 如有需要，请刷新 Cursor。
8. 可在聊天或代理模式中使用如下提示来调用它：
   * `ShadeFS 缓存是如何工作的？`
   * `如何在 Shade 中邀请访客？`
     {% endtab %}

{% tab title="ChatGPT / Codex" %}

1. 打开你的 **工具**, **连接器**，或 **MCP** 设置。
2. 如果该选项可用，请添加自定义服务器。
3. 将其命名为 **Academy Shade**.
4. 粘贴此 URL：

   `https://academy.shade.inc/~gitbook/mcp`
5. 保存服务器。
6. 如有需要，请刷新会话。
7. 使用以下内容进行测试：
   * `Shade 中的权限是如何工作的？`
   * `如何在 ShadeFS 中挂载驱动器？`

如果你的 ChatGPT 或 Codex 环境尚未提供自定义 MCP 服务器，请改用通过 Claude、Cursor 或其他兼容 MCP 的客户端来使用 Academy Shade MCP。
{% endtab %}

{% tab title="VS Code" %}

1. 打开你在 VS Code 中使用的兼容 MCP 的扩展。
2. 前往该扩展的 **MCP** 或 **服务器** 设置。
3. 添加一个新的远程服务器。
4. 将其命名为 **Academy Shade**.
5. 粘贴此 URL：

   `https://academy.shade.inc/~gitbook/mcp`
6. 如果提示选择传输方式，请使用该扩展推荐的标准远程 HTTP 选项。
7. 保存配置。
8. 如有需要，请重新加载 VS Code 或重启该扩展。
9. 使用以下内容进行测试：
   * `如何在 Shade 中创建 BYOS 驱动器？`
   * `资产上的评论是如何工作的？`
     {% endtab %}

{% tab title="其他 MCP 客户端" %}

1. 打开你的客户端的 **MCP**, **工具**，或 **连接器** 设置。
2. 添加一个新的远程服务器。
3. 将其命名为 **Academy Shade**.
4. 粘贴此 URL：

   `https://academy.shade.inc/~gitbook/mcp`
5. 保存配置。
6. 如有需要，请刷新客户端。
7. 使用以下内容进行测试：
   * `如何在 Shade 中使用 AI 搜索？`
   * `访客和工作区成员有什么区别？`
     {% endtab %}
     {% endtabs %}

### 连接后会发生什么

连接后，你的助手可以帮助处理：

* Shade 入门
* 工作区和权限问题
* ShadeFS 设置和故障排除

它最适合产品指导、工作流程和文档查询。

### 故障排除

如果服务器没有出现：

* 确认 URL 完全是 `https://academy.shade.inc/~gitbook/mcp`
* 刷新或完全重启客户端
* 确保你的客户端支持远程 MCP 服务器

如果你的客户端只支持本地 MCP 服务器，请改用支持远程服务器的兼容 MCP 客户端。


---

# 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/shi-yong-ai-he-academy-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.