使用說明 使用說明
API 使用介紹

連接外部 MCP 伺服器

把外部的 MCP 伺服器連進來,讓 AI Agent 可以使用它提供的工具、誰可以做什麼,以及伺服器的「基本」與「權限」分頁。

本頁內容 10

MCP 伺服器是一個提供工具給 AI 使用的外部服務。連上一台 MCP 伺服器之後,它的「權限」清單開放給的 AI Agent 就可以在對話中使用它的工具。

網站只會去連外部的 MCP 伺服器。網站本身不是 MCP 伺服器,外部的 AI 工具不能用 MCP 連進這個網站。

誰可以做什麼

MCP 伺服器在 AI Agent 頁的「MCP」分頁。每一個登入的人,都可以新增 MCP 伺服器,不需要任何角色權限,也不用先加入專案。新增的人是它的擁有者,伺服器放在它「權限」分頁的「專案」寫的地方,請看下面的「新增 MCP 伺服器的「權限」分頁」。

一個人只能透過伺服器的擁有者和它的「權限」清單用到一台伺服器,請看下面的權限分頁。擁有者什麼都可以做。伺服器的擁有者,是新增它的人,或是擁有者在「權限」分頁把它交給的人,請看權限分頁。清單上的每一個人、專案角色或「所有專案成員」,拿到「檢視」、「編輯」或「刪除」其中一項。「編輯」與「刪除」都包含「檢視」,但「編輯」不包含「刪除」,「刪除」也不包含「編輯」:

  • 「檢視」:在「MCP」分頁的清單上看得到這台伺服器,也打得開它的「基本」分頁,但只能看、不能改,沒有「儲存」。「HTTP Headers」的每一個值都是空白。
  • 「編輯」:包含「檢視」,還可以改「基本」分頁的內容並按「儲存」,也可以填一組新的「Service Token」;看得到「HTTP Headers」的值,也看得到「權限」分頁。
  • 「刪除」:包含「檢視」,還看得到「刪除」,可以刪除這台伺服器;但沒有「儲存」,「HTTP Headers」的值也是空白,也看不到「權限」分頁。

給一個專案角色,拿到的是在這台伺服器所在專案持有那個角色的成員;給「所有專案成員」,拿到的是那個專案現在和以後的每一個成員。一個人在清單上拿到好幾項時,每一項都算:例如點名給他「編輯」,他拿著的專案角色拿到「刪除」,他就可以修改這台伺服器,也可以刪除它。

是這台伺服器所在專案的成員,本身什麼都打不開,除非清單上有「所有專案成員」。沒有任何角色權限可以打開、修改或刪除伺服器,新增伺服器也不需要任何角色權限:專案擁有者和網站的管理者,都只拿得到清單給他的權限;擁有者離開專案以後,專案擁有者也不會代替他。打不開一台伺服器的人,網站會當作它不存在。

「MCP」分頁列出你打得開的每一台 MCP 伺服器,不論它在哪一個專案;打開它不會換掉你目前的專案。

「Service Token」存好之後,誰都看不到,擁有者也一樣。

新增 MCP 伺服器的「權限」分頁。 按「新增 MCP 伺服器」打開表單時,網站馬上就會讀取它的「權限」分頁,不用先打開這個分頁。分頁上由上到下是:

  • 「擁有者」:你自己,只顯示名字,不能換。
  • 「專案」:一開始是「私人」。下拉選單先列「私人」,再依名字列出你所在的每一個專案,下面寫著「換專案會把權限清單換成新位置的預設清單。」
  • 「權限管理」與權限清單:和擁有者看到的一樣,請看下面的權限分頁。「專案」是「私人」時,沒有「專案成員」與「專案角色」,所以也沒有「所有專案成員」;「AI Agent」與「工作流」的最前面一樣是「所有 AI Agent」與「所有工作流」,接著是你所在的每一個專案裡、你看得到的 AI Agent 與你打得開的工作流,名字後面寫著它所在的專案,後面接著你自己的私人 AI Agent 與私人工作流,名字後面寫著「私人」。

權限清單一開始是「專案」選的地方的預設清單,每一項都是「編輯」:放在「私人」時,是「所有 AI Agent」和「所有工作流」;放在一個專案時,最前面還有「所有專案成員」。選了另一個「專案」,權限清單就會換成那個地方的預設清單,「權限管理」可以選的對象也會換成那個地方的;再選回「私人」,清單會回到「私人」的預設清單。

第一次「儲存」之前,你可以加入、修改或移除清單上的對象。按表單最下面的「儲存」,伺服器就會放在「專案」選的地方,權限清單就是畫面上的那一份;清單是空的時,只有你自己用得到這台伺服器。

  • 清單還在讀取時,「儲存」是灰的,按不下去。讀不到時,「儲存」一直是灰的,「基本」分頁的最上面寫著「讀不到權限清單,請重新開啟。」;「權限」分頁寫著同一句,打開它時網站會再讀一次清單,讀到了,「儲存」就按得下去。
  • 「專案」選的地方不是「私人」,也不是你所在的專案時,網站會拒絕儲存,表單最上面寫著「只能在你所在的專案或「私人」新增 MCP 伺服器。」
  • 網站拒絕儲存時,原因寫在表單最上面,你選的「專案」和改好的清單都會留著。

新增一台伺服器

  1. 在「MCP」分頁按「新增 MCP 伺服器」。它在左側清單右下角,是一個圓形的「+」按鈕;右邊還沒有選伺服器時,也會有一個「新增 MCP 伺服器」按鈕。
  2. 表單的「基本」分頁有「基本」和「HTTP 設定」兩個部分。先填好「基本」。
  3. 在「HTTP 設定」填「伺服器網址」,需要時再填「Service Token」與「HTTP Headers」。新增中的伺服器有「基本」和「權限」兩個分頁。
  4. 在「權限」確認「專案」和權限清單。「專案」一開始是「私人」。
  5. 按「儲存」。

基本

  • 名稱:一定要填,最多 100 個字。名稱在整個網站上不能重複,不只是在你的專案裡:別的專案已經用過的名稱,會被擋下來,就算你的清單上看不到它。打開「工具名稱加伺服器前綴」時,AI 看到的工具名稱前面會加上這個名稱,但英文字母、數字與 _ 以外的字(包括中文、空白與 -)都會變成 _。所以名稱最好只用英文字母、數字與 _。
  • 啟用:預設打開。關掉之後,網站不會連這台伺服器,它的工具也不會出現在 AI Agent 的工具清單裡。
  • 逾時(秒):網站每一次向這台伺服器發出請求時,最多等幾秒。要填 1 到 120 秒的整數,預設 30 秒。
  • 工具名稱加伺服器前綴:預設打開,請保持打開。打開時,AI 看到的每一個工具名稱前面,都會加上伺服器的名稱(照上面「名稱」說的方式整理過),外部的工具就幾乎不會和網站自己的工具同名。只有網站的全域管理員可以把它存成關閉,其他人關掉之後按「儲存」,會被擋下來。

HTTP 設定

  • 伺服器網址:填 MCP 伺服器給你的完整網址。伺服器用特別的通訊埠時(例如 :8443),要寫上去;沒有的話不用寫。網址必須是從網路上連得到的位址。指向網站自己內部網路的網址會被擋下來,訊息是「這個網址指向我們自己的網路裡面,不能用。MCP 伺服器要是一個從外面連得到的位址。」
  • Service Token:伺服器需要驗證時才填。網站會把它放在每一次請求的 Authorization: Bearer … 標頭裡送出。存好之後不會再顯示;留白就保留原本那一組,要換的時候才填新的。
  • HTTP Headers:每一次請求都要額外帶上的標頭。名稱以 Mcp- 開頭的標頭不會被送出,請不要用。

連線只支援固定的 Service Token,不支援 OAuth 登入。

不能自己設的標頭

下面這些標頭,不能在「HTTP Headers」裡設,名稱不分大小寫:Authorization、Accept、Mcp-Session-Id、Mcp-Protocol-Version、X-Mcp-User-Email、X-Mcp-Conversation-Id、Host、Cookie、X-Forwarded-For、X-Forwarded-Host、X-Forwarded-Proto 與 X-Real-IP。填了會存不起來,訊息的開頭是「「…」這個 header 不能自己設」。要帶 Token,請用「Service Token」。

換伺服器網址時

已經存了 Service Token 的伺服器,改「伺服器網址」時,要一起填新的 Service Token,不然存不起來,訊息是「換了伺服器網址,就要一起填新的 Service Token。原本那組是為舊網址發的,把它送去新的地方等於把專案的憑證交給別人。」

有些 MCP 伺服器會被告知正在對話的人是誰(他的 Email)與是哪一段對話;這個設定只有網站的全域管理員能在資料庫裡打開,畫面上看不到,也改不了。這種伺服器的「伺服器網址」只有全域管理員可以改;其他人改了「伺服器網址」之後按「儲存」,會存不起來,訊息是「這台伺服器會告訴對方是誰在聊天,只有全域管理員可以改它的網址。」其他欄位照樣可以改。

最多幾台

一個專案最多可以有 20 個 MCP 伺服器,每一個人的「私人」也最多可以有 20 個 MCP 伺服器。關掉「啟用」的伺服器也算在內,所以到了上限時,要刪掉用不到的伺服器,才能再新增。「專案」選的地方已經有 20 台時按「儲存」,放在一個專案時會寫著「這個專案的 MCP 伺服器已經到上限了(20 台)。先刪掉用不到的那幾台,才能再新增。」,放在「私人」時會寫著「你的私人 MCP 伺服器已經到上限了(20 台)。先刪掉用不到的那幾台,才能再新增。」把伺服器移到一個已經有 20 台的地方,也會被拒絕,請看權限分頁的「把 MCP 伺服器移到別的地方」。

在 AI Agent 使用它的工具

  1. 打開一個 AI Agent 的「工具」。
  2. 在「可用工具」下面,找到用伺服器名稱命名的那一組。
  3. 這一組的第一個是「(伺服器名稱):全部工具」,代表這台伺服器現在與以後提供的每一個工具。你也可以只加入其中幾個工具。
  4. 按「+ 加入」。

一個 AI Agent 可以加入每一台開著、而且「權限」清單開放給它的伺服器的工具,點名給它或經由「所有 AI Agent」都算,不論伺服器在哪一個專案或是「私人」,也不論你是不是那個專案的成員。這些工具只有在伺服器開著、清單還開放給這個 AI Agent 時才會生效,不論和它對話的人在哪一個專案工作,請看MCP 伺服器的工具。替伺服器改名,AI Agent 上的工具都還在;刪除伺服器,它的工具會從每一個 AI Agent 拿掉。

伺服器沒有回應時,工具清單上方會出現「有工具伺服器沒有回應」,這台伺服器的工具這次不會列出來。AI Agent 已經在用的工具還在,不會被取消。

權限分頁

存好的伺服器,表單左邊有兩個分頁:「基本」和「權限」。網址會寫著打開的是哪一個分頁,例如 /ai-agent/mcp/…/basic 和 /ai-agent/mcp/…/permission。伺服器的網址沒有寫分頁時,會打開「基本」。伺服器沒有「分享」。

只有伺服器的擁有者,以及權限清單給了「編輯」的人,才看得到「權限」分頁。其他人的表單沒有「權限」,網址寫著「權限」時會打開「基本」。

第一次打開「權限」分頁時,網站才會讀取權限清單。分頁從上到下是:

  • 「擁有者」:擁有者的名字。只有擁有者可以換掉它,請看下面的「把 MCP 伺服器交給別人」;其他人看到的只是名字。
  • 「專案」:這台伺服器放在哪一個專案,或「私人」。只有擁有者可以換:擁有者看到的是一個下拉選單,下面寫著「換專案會把權限清單換成新位置的預設清單。」,請看下面的「把 MCP 伺服器移到別的地方」;其他人看到的只是名字。
  • 權限清單:一個表格,三欄是「權限擁有者」、「權限擁有類型」和「擁有權限」。「擁有權限」寫的是「編輯」、「刪除」或「檢視」。以前分享過這台伺服器的人或專案角色,會列成「檢視」。

清單是空的時,會寫「還沒有加入任何對象。只有擁有者能使用這個 MCP 伺服器。」讀取時會寫「讀取中…」,讀不到時會寫「讀不到權限清單,請重新開啟。」

擁有者修改權限清單。「權限管理」是並排的三個欄位,後面是「新增」按鈕:

  1. 第一個下拉選單選對象的類型:
    • 「專案成員」:最前面是「所有專案成員」,接著是這台伺服器所在專案的每一個成員,擁有者除外。
    • 「專案角色」:這台伺服器所在專案的角色。
    • 「所有用戶」:在旁邊的框裡輸入完整的 email,找到在網站上註冊的人。只輸入一部分的 email 找不到人。擁有者不能加進清單,找到擁有者時會寫著「擁有者不用加進清單。」
    • 「AI Agent」:最前面是「所有 AI Agent」,接著是這台伺服器所在專案裡、你看得到的 AI Agent,後面接著你自己的私人 AI Agent,名字後面寫著「私人」。
    • 「工作流」:最前面是「所有工作流」,接著是這台伺服器所在專案裡、你打得開的工作流,後面接著你自己的私人工作流,名字後面寫著「私人」。
  2. 第二個欄位輸入名稱來搜尋,再從清單選一個對象。
  3. 第三個下拉選單選權限:「編輯」、「刪除」或「檢視」,請看誰可以做什麼。一開始是「檢視」。

按「新增」,這個對象就加到權限清單的最後。加完之後,第二個欄位會清空,類型和權限保持不變。已經在清單上的對象再加一次,只會換成新選的權限,清單上不會出現兩列。

在擁有者看到的權限清單上:

  • 每一列的「擁有權限」是一個下拉選單,可以直接換成「編輯」、「刪除」或「檢視」。
  • 每一列的最後有一個移除按鈕,按下去就把這一列拿掉。
  • 專案角色、AI Agent 或工作流不在「權限管理」可以選的對象裡時,例如放進垃圾桶的 AI Agent,或是你看不到的 AI Agent,它的權限只顯示文字,例如「檢視」,不能修改,只能移除。

讀不到可以加入的對象時,不會出現「權限管理」,而是寫著「讀不到可以加入的對象,請重新開啟。」

權限清單跟著表單最下面的「儲存」一起存。 不論在「基本」還是「權限」分頁,按一次「儲存」,就會把「基本」的改動和整份權限清單一起存好。網站拒絕儲存時,表單最上面會寫出網站說的原因,例如「這個對象不在可以加入的名單裡。」,改好的清單會留著。改了清單還沒存時,要離開這台伺服器,網站會先問「設定還沒儲存,確定要離開嗎?」

有「編輯」、但不是擁有者的人,看到的分頁只能看:沒有「權限管理」,清單上沒有權限的下拉選單和移除按鈕。他按「儲存」,只會存「基本」,不會存權限清單。

把 MCP 伺服器交給別人。 擁有者看到的「擁有者」是連在一起的兩格:前面的下拉選單選「專案成員」或「所有用戶」,後面的框選人。你不是這台伺服器所在專案的成員時,沒有「專案成員」,只有「所有用戶」。

  • 「專案成員」列出這台伺服器所在專案的成員。
  • 「所有用戶」要在框裡輸入完整的 email,找到在網站上註冊的人。
  • 接手的人不一定要是這個專案的成員。
  • 選了一個人,這個人在權限清單上的那一列就會被拿掉,不論它是哪一項權限,因為擁有者不用任何權限。原來的擁有者不會自動加進清單。
  • 按表單最下面的「儲存」,新的擁有者會和「基本」的改動、權限清單一起存起來。再選回原來的擁有者,就不會交接,但第一次選的那個人在清單上的那一列不會回來。網站找不到選的人時,會拒絕儲存,寫著「找不到這位使用者。」

存好之後:

  • 原來的擁有者只有在權限清單上還有他時(點名給他、給他在這台伺服器所在專案拿著的專案角色,或給「所有專案成員」),才用得到這台伺服器。清單上沒有他時,這台伺服器會從他的「MCP」清單上拿掉,也打不開了;清單上有他時,伺服器還是開著,照清單給他的權限,只有「檢視」的人看到的「HTTP Headers」的值是空白。
  • 專案、「名稱」、「伺服器網址」、Service Token、「HTTP Headers」、「啟用」、「逾時(秒)」、「工具名稱加伺服器前綴」、清單上的其他對象,以及每一個 AI Agent 加入的這台伺服器的工具,都不會變。這些工具還算不算數,請看在 AI Agent 使用它的工具:「私人」的伺服器交給別人以後,清單上的「所有 AI Agent」換成新擁有者的範圍。
  • 把專案裡的伺服器交給別人,不會因為任何人已經有幾台 MCP 伺服器而被拒絕。「私人」的 MCP 伺服器,不能交給已經有 20 台「私人」MCP 伺服器的人,按「儲存」會寫著「新的擁有者的私人 MCP 伺服器已經到上限了(20 台),不能轉讓。」,什麼都不會改變;專案裡的 MCP 伺服器交給別人時,不受這個限制。
  • 新的擁有者不是伺服器所在專案的成員時,它會出現在他「MCP」分頁的「分享」裡,請看清單與分組。

擁有者離開專案或被移除時,那個專案的 MCP 伺服器會轉讓給選的成員,請看先轉讓你的物件;「私人」的 MCP 伺服器不屬於任何專案,不會轉讓,還是擁有者的。

把 MCP 伺服器移到別的地方。 只有擁有者可以換「專案」。下拉選單的第一個是「私人」,後面是你所在的每一個專案,照名稱排;這台伺服器現在放的專案,你不是它的成員時,排在最後。下拉選單下面寫著「換專案會把權限清單換成新位置的預設清單。」

  • 選了另一個地方,權限清單會換成那個地方的預設清單,和在那裡新增的伺服器一樣:放在「私人」時,是「所有 AI Agent」和「所有工作流」;放在一個專案時,最前面還有「所有專案成員」;每一項都是「編輯」。
  • 「權限管理」也會換成那個地方可以加入的對象。按「儲存」之前,可以加入、修改或移除清單上的對象。
  • 選了「私人」時,沒有「專案成員」與「專案角色」,所以也沒有「所有專案成員」;「擁有者」只能在「所有用戶」找人。「AI Agent」與「工作流」的最前面一樣是「所有 AI Agent」與「所有工作流」,接著是你所在的每一個專案裡、你看得到的 AI Agent 與你打得開的工作流,名字後面寫著它所在的專案,後面接著你自己的私人 AI Agent 與私人工作流,名字後面寫著「私人」。
  • 再選回原本的地方,原本存好的清單就會回來。
  • 按「儲存」時,網站會先問「確定要變更專案設定嗎?」,下面寫著「權限清單會換成「目的地」的預設清單。」,接著列出原本存好的清單上一個一個點名的 AI Agent 與工作流,標題是「這些 AI Agent 會不能再使用它:」與「這些工作流會不能再使用它:」。「所有 AI Agent」與「所有工作流」,只有要存的清單上已經沒有它們時,才會列出來。一個都沒有時,寫著「目前沒有 AI Agent 或工作流會受影響。」
  • 按「取消」,什麼都不會存,選的地方和改好的清單都還在;按「變更」,才會和「基本」的改動、權限清單一起存起來。列出來的 AI Agent 與工作流,在這台伺服器上的權限會被拿掉。
  • 選的地方不是「私人」,也不是你所在的專案時,例如你剛離開那個專案,網站會拒絕儲存,寫著「只能移到你所在的專案。」
  • 新的地方已經有 20 個 MCP 伺服器時,網站會拒絕儲存,寫著「「…」的 MCP 伺服器已經到上限了(20 台),不能移過去。」:移到一個專案時,算的是那個專案的伺服器;移到「私人」時,算的是你自己的私人 MCP 伺服器。關掉「啟用」的伺服器也算在內。
  • 同一次存檔移到「私人」又交給別人時,接手的人已經有 20 個私人 MCP 伺服器,網站會拒絕儲存,寫著「新的擁有者的私人 MCP 伺服器已經到上限了(20 台),不能轉讓。」;你自己的私人 MCP 伺服器不會擋住。
  • 網站拒絕儲存時,原因寫在表單最上面,你選的「專案」、改好的清單和「基本」的改動都會留著。

移好之後,這台伺服器在「MCP」分頁的清單上,會換到新地方的那一組,請看清單與分組。移動不會改變這些:擁有者(同一次存檔也把它交給別人時除外)、「名稱」、「伺服器網址」、Service Token、「HTTP Headers」、「啟用」、「逾時(秒)」、「工具名稱加伺服器前綴」,以及每一個 AI Agent 加入的這台伺服器的工具。移好之後這些工具還算不算數,請看在 AI Agent 使用它的工具。

有「編輯」、但不是擁有者的人,看到的「專案」只是名字。

誰看得到、可以修改或刪除伺服器,由這份清單決定,請看上面的誰可以做什麼;哪些 AI Agent 可以用它的工具,照上面「在 AI Agent 使用它的工具」說的。

網站送出去的資料

網站不會把正在對話的人是誰(例如他的 Email),或是哪一段對話,送給一般新增的 MCP 伺服器。只有網站的全域管理員在資料庫裡打開了這個設定的伺服器,才會收到這兩樣;這種伺服器的網址只有全域管理員可以改,請看換伺服器網址時。