Skip to content

接上 MCP 伺服器(Notion、Linear 等)

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 客服的資料來源,需要自己開發串接嗎