> For the complete documentation index, see [llms.txt](https://docs.cherry-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/advanced-basic/mcp.md).

# MCP 使用教程

## 一句講明 MCP

**MCP 係畀 AI 可以調用你電腦或者網上帳號入面資源嘅「統一接口」。**

類比：

* AI 預設好似一部**冇裝任何 App 嘅手機** —— 只可以傾偈，無法存取你電腦入面嘅文件，無法登入你嘅 Notion，亦無法操作瀏覽器
* **MCP** 好似手機嘅**應用商店 + 通用接口**：裝一個 MCP，AI 就會獲得一項新能力，例如「讀取本地文件」、「查詢 Notion 內容」、「代為發送電郵」

MCP 由 Anthropic 公司發起並制定統一規範，全球開發者按呢個規範開發各類工具組件（稱為 **MCP Server**）。任何支援 MCP 嘅 AI 客戶端（包括 Cherry Studio）都可以使用同一批工具。

## 用 MCP 可以做咩？

以下係適合普通用戶嘅常見場景：

* **讀取本地文件**：畀 AI 存取 `~/Documents` 入面嘅筆記、賬單、合約
* **接入筆記類工具**：畀 AI 查詢同修改 Notion / Obsidian / Apple Notes 入面嘅內容
* **自動收發訊息**：畀 AI 起草並直接發送電郵、飛書訊息
* **查詢資料庫**：畀 AI 自動編寫 SQL 查詢 MySQL / PostgreSQL
* **瀏覽網頁 + 截圖**：畀 AI 操作瀏覽器攞資料
* **代碼協作**：畀 AI 直接讀取/修改本地代碼倉庫、查詢 GitHub Issue

## MCP 同「技能」嘅分別

兩者好易混淆，對比如下：

|                 | **技能（Skill）**     | **MCP**                         |
| --------------- | ----------------- | ------------------------------- |
| **本質**          | 「點樣做」嘅能力包         | 「用乜」嘅接口                         |
| **類比**          | AI 嘅學歷背景（思考方式）    | AI 嘅工具箱（操作能力）                   |
| **典型例子**        | 「識做小紅書圖文」、「識畫流程圖」 | 「可以讀取文件」、「可以查詢 Notion」、「可以發送電郵」 |
| **係咪需要外部帳號／工具** | 唔需要（純模型層）         | 通常需要（接入外部 App / API）            |

**實際操作分別**：裝咗一個「小紅書技能」之後，AI 輸出會符合小紅書風格；裝咗一個 Notion MCP 之後，AI 先可以真正存取你嘅 Notion 數據。

> 推薦先睇 [概念入門](/docs/zhong-wen-fan-ti/advanced-basic/concepts-101.md)。

## 我需要點用？

總共三步：

1. **第一次用**：[裝好 MCP 運行環境](/docs/zhong-wen-fan-ti/advanced-basic/mcp/install.md)（一次性，1 分鐘）
2. **加一個 MCP**：[手動配置](/docs/zhong-wen-fan-ti/advanced-basic/mcp/config.md) 或者 [畀 AI 自動安裝](/docs/zhong-wen-fan-ti/advanced-basic/mcp/auto-install.md)
3. **喺對話/Agent 入面啟用佢** → 然後正常傾偈／跑任務，AI 會自己決定幾時調用

詳細流程睇上面三個連結。

## 邊度搵到 MCP？

* **官方倉庫**：[github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)（最齊全）
* **Cherry Studio 內置市場**：喺 `設定 → MCP 伺服器 → 發現 → 內置伺服器` 入面瀏覽同一鍵安裝社群同官方插件。
* **Cherry Studio 內置服務供應商**： `設定 → MCP 伺服器 → 服務商` 入面整合咗部分服務商，可以喺配置後取得佢哋嘅 MCP 使用。
* **第三方分享**：Reddit / Discord / 個人博客都有好多。

## 常見疑問

**Q：裝 MCP 需要編程能力咩？** 唔需要。通常只要複製一段設定貼到 Cherry Studio，或者用 [自動安裝](/docs/zhong-wen-fan-ti/advanced-basic/mcp/auto-install.md) 畀 AI 代為完成。

**Q：裝錯會整壞我部電腦嗎？** 風險較低。MCP 只可以執行佢聲明嘅操作（聲明讀文件嘅只可以讀文件，冇聲明發電郵嘅就無法發送電郵）。但**安裝來源不明嘅 MCP 仍然有風險**，建議優先由官方倉庫揀用。

**Q：MCP 會唔會攞到我嘅數據？** 視乎具體嘅 MCP 實現。官方倉庫入面嘅開源 MCP 代碼可以審查，相對可信；第三方閉源 MCP 安裝前請確認開發者身份。

## 下一步

* 第一次用：先睇 [MCP 環境安裝](/docs/zhong-wen-fan-ti/advanced-basic/mcp/install.md)
* 想直接試一個：睇 [配置同使用 MCP](/docs/zhong-wen-fan-ti/advanced-basic/mcp/config.md) 跟住行一遍
* 嫌手動設定麻煩：試吓 [自動安裝 MCP](/docs/zhong-wen-fan-ti/advanced-basic/mcp/auto-install.md)
* 想睇 Cherry Studio 內置咗邊啲 MCP：[內置 MCP 設定](/docs/zhong-wen-fan-ti/advanced-basic/mcp/builtin.md)
* 裝到一半遇到問題：[常見問題](/docs/zhong-wen-fan-ti/advanced-basic/mcp/faq.md)

***

### 💡 獲取幫助同提交反饋

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改進建議，請參考 [反饋同建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.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://docs.cherry-ai.com/docs/zhong-wen-fan-ti/advanced-basic/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.