---
url: https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/mcp-connect.md
description: MCP 連線只要貼一個伺服器位址就能接上，不需要我們為每一家服務另外開發。這篇說明貼什麼網址、OAuth 授權怎麼走，以及探索不到工具時該看哪裡。
---

MCP 是一種讓 AI 存取外部服務的公開協定。Notion、Linear、Sentry 這些服務都有自己的 MCP
伺服器，你把網址貼進來，OakXgen 會自己問對方「你提供哪些工具」，然後把那些工具變成
AI 可以用的動作。

**我們沒有為任何一家寫專屬的接法。** 整段流程是照協定跑的，所以今天名單上沒有的服務，
只要它有 MCP 伺服器，一樣貼網址就能接。

## 步驟

**1. 新增連線，類型選 MCP**

**2. 填伺服器位址**

到那家服務的文件找 MCP 伺服器網址。以 Notion 為例是 `https://mcp.notion.com/mcp`。

**3. 選驗證方式**

託管型的服務(Notion 這類)幾乎都是**OAuth 授權**。選了之後沒有東西要填，憑證由下一步
取得——這類伺服器不收你自己貼的 token。

自架或內部的 MCP 伺服器可能改用**自訂 Header** 或**查詢參數**，那就照對方文件填。

**4. 按連線授權**

會跳出一個視窗到對方的授權頁面，登入並同意之後視窗自動關閉，**授權狀態**變成**已授權**。

**5. 按探索工具**

OakXgen 會問伺服器提供哪些工具，回來會顯示「伺服器目前提供 N 個工具」。清單裡勾選要
開放給 AI 的那些。

**不要全部勾選。** 工具越多，AI 挑錯的機率越高。只勾這個 agent 真正需要的。

**6. 儲存**

## 授權為什麼要跳視窗

因為憑證是你跟那家服務之間的事，OakXgen 不經手你的帳號密碼。授權完成後我們拿到的是
一組只能做你剛剛同意那些事的權杖，而且你隨時可以在那家服務的設定裡收回。

**授權狀態**旁邊會顯示**由誰授權**與**權限範圍**。如果那個人離職了，建議重新授權一次
換成還在職的人——雖然權杖不會因為離職自動失效，但對方服務端撤銷帳號時就會斷掉。

## 常見錯誤訊息

**「這是舊式 SSE 端點，我們只支援 streamable HTTP。試著把結尾的 /sse 換成 /mcp」**

照它說的做通常就對了。MCP 早期用一種舊的連線方式，現在的規範換掉了，多數服務兩種
網址都還開著。

**「無法開始授權，請確認伺服器網址是否支援 OAuth」**

網址打錯，或這台伺服器根本不用 OAuth。回去看對方文件確認驗證方式。

**「授權流程逾時，請重新按一次連線授權」** / **「這條連線沒有進行中的授權流程，請重新按一次連線授權」**

授權視窗開太久沒完成，或中途關掉了。重按一次**連線授權**。

**「對方不支援 PKCE S256，我們不會退回沒有保護的授權流程」**

這台伺服器的授權實作太舊。我們刻意不提供退回舊方式的選項——那會讓授權碼在傳輸過程中
可能被攔截後直接使用。請對方升級，或改用 token 類的驗證方式。

**「MCP 伺服器沒有回傳有效的結果」**

工具呼叫時伺服器回了看不懂的東西。先按一次**測試連線**確認基本連通，還是不行的話
把伺服器網址一起回報給我們。

**「遠端已無這些工具，已從清單移除，儲存後生效」**

不是錯誤，是提醒。對方改版拿掉了某些工具，我們把它們從你的清單移掉了，記得儲存。

## 幾件值得知道的事

**探索是一次性的快照。** 按**探索工具**當下拿到什麼就存什麼。對方之後新增了工具，
要回來重新探索才會出現。

**改了伺服器位址要重新探索。** 畫面會提醒你「網址已經改過，重新探索才會換成新的」，
底下列的還是舊網址探索回來的東西。

**解除授權不會刪掉設定。** 連線與勾選的動作都留著，但 AI 立刻叫不動它們，要重新授權
才會恢復。

## 延伸閱讀

[要串 Notion、Linear 這類工具當 AI 客服的資料來源，需要自己開發串接嗎](/zh-Hant-TW/article/mcp-tool-integration-no-custom-dev)