> ## 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-Hant/features/projects)裡。
* 當同一個 MCP 工作流程需要按計劃重複執行時，使用 [Automations](/zh-Hant/features/automations)。