> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> 在 Happycapy 中将 MCP 服务器作为集成使用。

## 概览

MCP 可以让 Happycapy 在项目里使用另一套工具和数据。你可以让它查找上下文、读取记录、更新系统、查询数据库，或执行团队自建动作。

你不需要理解协议本身。把 MCP 服务器的设置指南、访问说明和目标发给 Happycapy，它可以先检查这台服务器能提供什么、需要哪些权限，再使用这些工具完成任务。

你可以用 MCP 连接 Gmail、Notion 这类公开服务，也可以连接内部知识库、数据库、CRM、审批流、后台、报表系统、运营工具和旧系统 API。

## 什么时候用 MCP

当你希望 Happycapy 使用另一个系统里的能力，而不只是处理当前对话里的文件和上下文时，就适合用 MCP：

* 从 Notion、Google Drive、Slack 或内部知识库里查找文档、页面、消息和团队资料
* 在邮件、日历、CRM、客服、工单或项目系统里读取或更新信息
* 查询 Postgres、Supabase、Neon、内部数据库、仪表盘或报表系统
* 使用 GitHub、Linear、日志、Issue、发布数据等开发和产品系统
* 调用团队自建动作，例如审批、库存查询、客户记录更新或报告生成

能不能使用取决于对应工具是否有 MCP 服务器，或是否有可以提供给 Happycapy 的设置指南。

## MCP 可以帮你完成什么

<CardGroup cols={2}>
  <Card title="带入上下文" icon="search">
    让 Happycapy 在开始工作前先查找相关文档、工单、消息、记录或客户备注。
  </Card>

  <Card title="执行授权动作" icon="check-circle">
    让 Happycapy 通过服务器提供的工具起草、更新、创建、分配、评论、同步或总结。
  </Card>

  <Card title="使用内部系统" icon="building">
    连接团队自建服务器，用于内部数据库、仪表盘、审批、运营后台或旧系统。
  </Card>

  <Card title="复用一套设置" icon="repeat">
    把服务器信息保留在项目里，后续类似工作流可以继续使用。
  </Card>
</CardGroup>

## 开始前准备

最好先提供这些信息：

* MCP 服务器链接、仓库或设置指南
* 要使用的账号、工作区、项目或数据源
* 服务器文档里要求的登录、token、权限或工作区授权说明
* 服务器准备好之后，希望 Happycapy 完成的任务

## 第一次使用

把服务器和目标一起告诉 Happycapy：

```text theme={null}
为这个 Happycapy 项目设置这个 MCP 服务器。
在修改任何内容前，先告诉我它需要哪些访问权限。
准备好之后，先列出它提供了哪些工具。

MCP 服务器：[链接或设置指南]
目标：[你希望 Happycapy 完成什么]
```

## 示例工作流

```text theme={null}
使用我们的 Notion MCP 服务器。
找到最新的产品发布记录，并总结还没定下来的决策。
```

```text theme={null}
使用 Gmail 和 Calendar MCP 服务器。
查找本周的客户会议邮件，并起草后续跟进计划。
```

```text theme={null}
使用内部 CRM MCP 服务器。
查询这个客户，整理最近互动，并起草一份客户状态更新。
```

```text theme={null}
使用 Postgres MCP 服务器。
查询上周的激活数据，并用自然语言解释趋势。
```

## 访问权限

* 优先使用服务器的官方登录或授权流程。
* 只授予完成任务所需的最小权限。
* 在开始修改数据前，可以让 Happycapy 先列出可用工具。
* 对敏感操作，可以先让 Happycapy 说明它会读取或修改什么。
* 如果服务器会访问公司或客户数据，使用前先确认账号和工作区。

## 故障排查

### 设置失败

把官方设置指南发给 Happycapy，让它检查卡在哪一步。

### 认证失败

确认服务器需要的是浏览器登录、token、API key、环境变量，还是工作区授权。

### 找不到预期的工具

让 Happycapy 列出服务器提供的工具，再和服务器文档对照。

### 结果范围太大

补充工作区、项目、数据源、记录、日期范围或期望输出格式。

## 给开发者

MCP 的全称是 Model Context Protocol。如果你要搭建或选择服务器，请以官方 MCP 文档为准。

<Card title="Model Context Protocol" icon="globe" href="https://modelcontextprotocol.io">
  阅读 MCP 官方文档和服务器资源。
</Card>

## 下一步

* 如果后续还要复用这套设置，可以把服务器链接、访问说明和工作区信息留在[项目](/zh/features/projects)里。
* 当同一个 MCP 工作流需要按计划重复运行时，使用 [Automations](/zh/features/automations)。