# 整合 (/zh-Hant/docs/verdent-manager/core-features/integration)

> 瀏覽、安裝並管理 Verdent 擴充功能，以連接第三方工具與服務



工具整合是 Verdent 用於瀏覽、安裝與管理擴充功能的系統。你不需要手動設定複雜的 API 腳本，只要點幾下就能安裝外掛。

當你新增外掛時，Verdent 會從官方市集下載安全的套件、驗證其完整性，並自動註冊所有元件——無論是新的部署指令、資料庫管理技能，還是工作流程自動化工具。

## 支援的整合 [#支援的整合]

目前市集中熱門的外掛：

| 工具       | 典型使用情境                     |
| -------- | -------------------------- |
| GitHub   | 檢視 PR、管理 issue、觸發 Actions  |
| Stripe   | 查詢付款、管理訂閱、分析營收             |
| Supabase | 讀寫資料庫、管理使用者、查詢資料表          |
| Notion   | 查詢文件與資料庫、建立頁面、管理知識庫、同步專案資訊 |
| Linear   | 管理 issue 與專案、追蹤開發進度、同步任務狀態 |

## 安裝外掛 [#安裝外掛]

<Steps>
  <Step title="開啟設定">
    啟動 Verdent 並前往 **設定**。
  </Step>

  <Step title="開啟整合分頁">
    你會看到外掛分為兩個區塊：

    * **已安裝** — 你已擁有的外掛
    * **推薦** — 市集中可用的外掛
  </Step>

  <Step title="挑選外掛">
    點擊 **推薦** 區塊中的任一外掛卡片以開啟其詳細資訊。
  </Step>

  <Step title="加入 Verdent">
    檢視其功能與元件，然後點擊 **Add to Verdent**。外掛會自動下載、驗證並安裝。
  </Step>

  <Step title="連接 MCP">
    依照提示連接對應的 MCP，讓外掛能存取外部服務。
  </Step>
</Steps>

## 驗證 [#驗證]

不同的外掛採用不同的安全驗證方式：

* **OAuth** — 例如 GitHub、Notion 和 Linear 等外掛支援無縫的 OAuth 流程。Verdent 會自動處理用戶端憑證——你只需在瀏覽器中登入並授權，無需複製貼上。

<Note>
  你提供的任何 API 金鑰或存取權杖都儲存在你的本機。Verdent 絕不會將你的憑證上傳到我們的伺服器。
</Note>

## 使用外掛 [#使用外掛]

安裝後，有兩種主要方式開始使用外掛：

### 直接與 Manager 對話 [#直接與-manager-對話]

自然地請 Manager 使用該整合：

* 「使用 GitHub 整合來總結我最近的 PR」
* 「查看我 Supabase 使用者資料表中最新註冊的使用者」

### 在 Chat 中試用 [#在-chat-中試用]

如果你不確定從何開始，前往 **設定 → 整合**，點擊已安裝的外掛，然後點擊 **Try in Chat**。設定會關閉，外掛的預設提示詞會插入聊天輸入框中。

## 管理已安裝的外掛 [#管理已安裝的外掛]

你隨時可以完全掌控 Verdent 能存取哪些工具：

* **檢視詳細資訊** — 點擊任一已安裝的外掛卡片，即可查看其確切的元件（MCP、技能、規則等）。
* **解除安裝** — 開啟外掛詳細資訊並點擊 **Uninstall**。確認後，Verdent 會完整移除執行階段的註冊、刪除快取檔案並清理狀態。
* **重新安裝** — 隨時可在 **推薦** 區塊中再次找到該外掛並重新安裝。

<Note>
  解除安裝會移除所有本機檔案與功能。若要完全中斷連線，你可能仍需在第三方服務的儀表板中撤銷 OAuth 存取權或刪除 API 金鑰。
</Note>

## 外掛內含什麼 [#外掛內含什麼]

一個整合可能包含多個元件：

* **MCP 伺服器** — 標準化的工具，讓 Verdent 能從外部服務讀寫資料
* **技能** — 特定任務的 AI 能力或工作流程（例如 GitHub 的「程式碼審查」技能）
* **子代理** — 專注、獨立的代理，Manager 可將複雜任務委派給它們
* **規則** — 自訂的行為指示，定義 Verdent 在使用特定工具時應如何行動
* **指令** — 便利的斜線指令（例如 `/deploy`），你可以直接在聊天中執行

## 使用情境 [#使用情境]

### 程式碼審查與合併（GitHub） [#程式碼審查與合併github]

完成功能後，可以這樣詢問：

> 為我最近的提交建立一個 PR 並總結變更內容。

Verdent 會使用 GitHub 外掛起草 PR、新增摘要，並檢查 CI/CD 狀態。

### 訂閱管理（Stripe） [#訂閱管理stripe]

當客戶寄來帳務問題的郵件時：

> 找出 [user@example.com](mailto:user@example.com) 的 Stripe 訂閱，並檢查他們最近一次付款是否成功。

Verdent 會安全地擷取資料——無需開啟 Stripe 儀表板。

### 監控（Supabase） [#監控supabase]

連接 Supabase 後：

> 從使用者資料表中擷取財務類型使用者的客戶紀錄。

Verdent 會直接擷取並顯示資料。

### 專案追蹤（Linear） [#專案追蹤linear]

會議前：

> 在 Linear 中顯示本次衝刺所有未完成的 issue，並依優先順序排序。

Verdent 會彙整進度，你也可以直接將已修復的 bug 標記為 Done。

### 知識與文件（Notion） [#知識與文件notion]

> 在 Notion 中找出最新版本的產品需求文件，並將關鍵需求轉換成任務清單。

Verdent 會擷取內容並自動產生結構化的任務清單。

<Note>
  請務必透過官方 Verdent 市集安裝外掛，以確保套件經過 SHA256 驗證且安全無虞。
</Note>