> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/work/maigpt/connectors.md).

# 連接器

MaiGPT 連接器是什麼：連接 Notion、Slack、Google Drive、GitHub 等第三方工具（OAuth 授權），實際清單由管理員啟用，以及如何管理與解除已連接的工具。

連接器讓 MaiGPT 能夠存取你的第三方工具，例如 Notion、Slack、Google Drive、GitHub。連接後，你可以直接在對話中查詢和操作這些工具裡的資料。

***

## 可以連接哪些工具 <a href="#supported-tools" id="supported-tools"></a>

| 工具               | 連接後你可以做什麼                        |
| ---------------- | -------------------------------- |
| **Notion**       | 搜尋頁面、查詢資料庫、建立新頁面                 |
| **Slack**        | 搜尋訊息、查看頻道內容                      |
| **Google Drive** | 搜尋和讀取文件                          |
| **GitHub**       | 查看 Repository、Issue、Pull Request |

{% hint style="info" %}
上表是常見範例，實際可用的連接器由組織管理員啟用，並依你的角色開放，請以對話輸入框 ＋ → <mark style="color:blue;">連接器</mark> 看到的清單為準。需要的工具不在清單中時，可以在 <mark style="color:blue;">管理我的連接器</mark> 送出申請；管理員端操作見 [管理連接器（管理員）](/work/maigpt/connectors/connectors-admin.md)。
{% endhint %}

***

## 怎麼連接 <a href="#how-to-connect" id="how-to-connect"></a>

### 1. 開啟連接器選單 <a href="#open-connector-settings" id="open-connector-settings"></a>

點對話輸入框左側的 ＋，選 <mark style="color:blue;">連接器</mark>。子選單的 <mark style="color:blue;">已連接服務</mark> 列出這個對話可用的連接器：已授權的右側是開關，決定這個對話要不要使用；還沒授權的 OAuth 連接器右側是 <mark style="color:blue;">授權</mark> 按鈕。最下方有 <mark style="color:blue;">新增連接器</mark> 與 <mark style="color:blue;">管理我的連接器</mark>。

### 2. 授權你的帳號 <a href="#authorize-account" id="authorize-account"></a>

在子選單點該連接器的 <mark style="color:blue;">授權</mark>（或在 <mark style="color:blue;">管理我的連接器</mark> 選連接器後點 <mark style="color:blue;">授權連接</mark>），會開新視窗到該服務的授權頁，依提示登入並同意即可。部分連接器會先請你 <mark style="color:blue;">選擇授權範圍</mark>；瀏覽器擋下彈出視窗時，請允許後再試一次。

### 3. 開始使用 <a href="#start-using" id="start-using"></a>

連接成功後，直接在對話中提問：

> 「搜尋 Notion 裡關於 Q1 計畫的頁面」
>
> 「查一下 Google Drive 裡的報價單」

連接的服務若提供互動介面，AI 的回覆下方會出現可直接操作的卡片，見 [MCP 互動卡片（MCP Apps）](/build/tools/mcp-apps.md)。

***

## 管理已連接的工具 <a href="#manage-connected-tools" id="manage-connected-tools"></a>

在 ＋ → <mark style="color:blue;">連接器</mark> 點 <mark style="color:blue;">管理我的連接器</mark>，開啟「我的連接器」，左側可依狀態篩選：

| 狀態     | 你可以做的事                                                                             |
| ------ | ---------------------------------------------------------------------------------- |
| 已授權    | <mark style="color:blue;">解除連接</mark>                                              |
| 需要授權   | <mark style="color:blue;">授權連接</mark>；授權失效時為 <mark style="color:blue;">重新授權</mark> |
| 需管理員設定 | 等管理員完成設定                                                                           |
| 角色未開放  | 向管理員申請                                                                             |
| 組織未啟用  | <mark style="color:blue;">申請啟用</mark>                                              |

送出申請後會顯示「已送出申請」，管理員開放後會在 [通知中心](/start/notifications.md) 收到「連接器已啟用」。

點任一個連接器，右側會顯示它的詳情：

| 區塊                                        | 內容                                                                                                                                                                  |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 狀態說明                                      | 例如「尚未授權」「授權已失效」「{服務} 未開放給你的角色」「{服務} 尚未由組織啟用」「{服務} 需要管理員完成設定」，下方就是對應的按鈕                                                                                              |
| <mark style="color:blue;">授權資訊</mark>     | <mark style="color:blue;">授權時間</mark>（你完成授權的時間）與 <mark style="color:blue;">憑證效期</mark>（服務核發的憑證何時到期；過期而未能更新時狀態會變成「授權已失效」，按 <mark style="color:blue;">重新授權</mark> 即可） |
| <mark style="color:blue;">將要求的權限範圍</mark> | 授權時會向服務申請的權限清單；只會用在 Agent 代你操作這個服務，管理員可在[啟用連接器](/work/maigpt/connectors/connectors-admin.md)時查看                                                                     |

### 看到「{服務} 連續無法使用：{原因}，請檢查連線設定」？ <a href="#faq-connector-unavailable" id="faq-connector-unavailable"></a>

同一個連接器在對話中連續幾次都呼叫失敗時，畫面會跳出這則提示，工具卡片上也會標示「目前無法使用」。先到 <mark style="color:blue;">管理我的連接器</mark> 看該服務的狀態：顯示需要重新授權就按 <mark style="color:blue;">重新授權</mark>；狀態正常卻仍失敗，通常是服務本身或組織自訂 MCP 伺服器的連線設定有問題，請把提示裡的原因提供給組織管理員（設定位置見 [管理連接器（管理員）](/work/maigpt/connectors/connectors-admin.md)）。不想再看到這則提示，點 <mark style="color:blue;">不再提示</mark>。

***

## Notion <a href="#notion" id="notion"></a>

連接 Notion 後，你可以在 MaiGPT 中直接搜尋 Notion 頁面、查詢資料庫、甚至建立新頁面。

### 連接步驟 <a href="#notion-connection-steps" id="notion-connection-steps"></a>

1. 點輸入框的 ＋ → <mark style="color:blue;">連接器</mark>，找到 Notion
2. 點 <mark style="color:blue;">授權</mark>，跳轉到 Notion 授權頁面
3. 選擇你要授權 MaiGPT 存取的頁面或工作區
4. 點擊「允許」完成授權

### 可以做什麼 <a href="#notion-what-you-can-do" id="notion-what-you-can-do"></a>

連接後，在對話中直接說：

| 你說                         | MaiGPT 做     |
| -------------------------- | ------------ |
| 「搜尋 Notion 裡關於產品規格的頁面」     | 搜尋並列出相關頁面    |
| 「查一下 Notion 專案資料庫中未完成的任務」  | 查詢資料庫並篩選     |
| 「在 Notion 建立一個新頁面，標題是會議紀錄」 | 建立新頁面        |
| 「把這份摘要存到 Notion」           | 將內容寫入 Notion |

### 注意事項 <a href="#notion-notes" id="notion-notes"></a>

{% hint style="warning" %}
**授權範圍**

Notion 授權時可以選擇分享哪些頁面給 MaiGPT。只有你授權的頁面才能被搜尋到。如果找不到某個頁面，請確認是否已授權。
{% endhint %}

***

## Slack <a href="#slack" id="slack"></a>

連接 Slack 後，你可以在 MaiGPT 中搜尋 Slack 訊息和頻道內容，快速找到之前的討論。

### 連接步驟 <a href="#slack-connection-steps" id="slack-connection-steps"></a>

1. 點輸入框的 ＋ → <mark style="color:blue;">連接器</mark>，找到 Slack
2. 點 <mark style="color:blue;">授權</mark>，跳轉到 Slack 授權頁面
3. 確認授權範圍後，點擊「允許」

### 可以做什麼 <a href="#slack-what-you-can-do" id="slack-what-you-can-do"></a>

| 你說                      | MaiGPT 做 |
| ----------------------- | -------- |
| 「搜尋 Slack 裡關於伺服器遷移的討論」  | 搜尋相關訊息   |
| 「查一下 #general 頻道最近在聊什麼」 | 摘要頻道內容   |
| 「找一下 John 上週提到的那個連結」    | 搜尋特定人的訊息 |

***

## Google Drive <a href="#google-drive" id="google-drive"></a>

連接 Google Drive 後，你可以在 MaiGPT 中搜尋和讀取你的 Google Drive 文件。

### 連接步驟 <a href="#google-drive-connection-steps" id="google-drive-connection-steps"></a>

1. 點輸入框的 ＋ → <mark style="color:blue;">連接器</mark>，找到 Google Drive
2. 點 <mark style="color:blue;">授權</mark>，跳轉到 Google 授權頁面
3. 選擇你的 Google 帳號並允許存取

### 可以做什麼 <a href="#google-drive-what-you-can-do" id="google-drive-what-you-can-do"></a>

| 你說                      | MaiGPT 做  |
| ----------------------- | --------- |
| 「搜尋 Google Drive 裡的報價單」 | 搜尋並列出相關文件 |
| 「打開上次的會議紀錄」             | 找到並讀取文件內容 |
| 「幫我摘要 Drive 裡那份市場分析報告」  | 讀取文件並產出摘要 |

### 注意事項 <a href="#google-drive-notes" id="google-drive-notes"></a>

{% hint style="warning" %}
**僅支援 Google 原生格式**

目前只能讀取 Google 文件、試算表、簡報等原生格式。`.pptx`、`.docx`、`.xlsx` 等 Office 格式**無法直接讀取**，請先在 Google Drive 中將其「轉換為 Google 格式」再引用。
{% endhint %}

{% hint style="warning" %}
**Shared Drive 與外部共享限制**

檔案若存放於 Shared Drive、或以捷徑方式存在，授權後仍可能讀取失敗。請確認授權帳號在該 Shared Drive 具備存取權限，捷徑請改用原始檔案連結。
{% endhint %}

***

## GitHub <a href="#github" id="github"></a>

連接 GitHub 後，你可以在 MaiGPT 中查詢 Repository、Issue、Pull Request 等開發相關資訊。

### 連接步驟 <a href="#github-connection-steps" id="github-connection-steps"></a>

1. 點輸入框的 ＋ → <mark style="color:blue;">連接器</mark>，找到 GitHub
2. 點 <mark style="color:blue;">授權</mark>，跳轉到 GitHub 授權頁面
3. 選擇要授權的 Repository 並確認

### 可以做什麼 <a href="#github-what-you-can-do" id="github-what-you-can-do"></a>

| 你說                                 | MaiGPT 做    |
| ---------------------------------- | ----------- |
| 「查一下 main-repo 最近有哪些 open 的 Issue」 | 列出 Issue 清單 |
| 「幫我看 PR #123 的變更摘要」                | 讀取 PR 並摘要   |
| 「搜尋 repo 裡跟 authentication 相關的程式碼」 | 搜尋程式碼       |

***

## 下一步 <a href="#next-steps" id="next-steps"></a>

* [管理連接器（管理員）](/work/maigpt/connectors/connectors-admin.md)
* [MaiGPT 角色使用權限](/org/roles/maigpt-role-permissions.md)
* [回到 MaiGPT 總覽](/work/maigpt.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/work/maigpt/connectors.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.