# 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 数据。

> 推荐先阅读 [概念入门](/advanced-basic/concepts-101.md)。

## 我需要怎么用？

总体三步：

1. **第一次用**：[装好 MCP 运行环境](/advanced-basic/mcp/install.md)（一次性，1 分钟）
2. **添加一个 MCP**：[手动配置](/advanced-basic/mcp/config.md) 或 [让 AI 自动安装](/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，或使用 [自动安装](/advanced-basic/mcp/auto-install.md) 让 AI 代为完成。

**Q：安装错误会损坏我的电脑吗？** 风险较低。MCP 仅能执行其声明的操作（声明读文件的只能读文件，未声明发邮件的就无法发送邮件）。但**安装来源不明的 MCP 仍存在风险**，建议优先从官方仓库选用。

**Q：MCP 是否会获取我的数据？** 取决于具体的 MCP 实现。官方仓库中的开源 MCP 代码可审查，相对可信；第三方闭源 MCP 安装前请确认开发者身份。

## 下一步

* 第一次用：先看 [MCP 环境安装](/advanced-basic/mcp/install.md)
* 想直接试一个：看 [配置和使用 MCP](/advanced-basic/mcp/config.md) 跟着走一遍
* 嫌手动配置麻烦：试试 [自动安装 MCP](/advanced-basic/mcp/auto-install.md)
* 想看 Cherry Studio 内置了哪些 MCP：[内置 MCP 配置](/advanced-basic/mcp/builtin.md)
* 装到一半遇到问题：[常见问题](/advanced-basic/mcp/faq.md)

***

### 💡 获取帮助与提交反馈

如果您在配置或使用过程中遇到任何疑问、Bug 或有功能改进建议，请参考 [反馈与建议](/question-contact/suggestions.md) 中提供的官方渠道。


---

# Agent Instructions: 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:

```
GET https://docs.cherry-ai.com/advanced-basic/mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.