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 伺服器。」
- 網站拒絕儲存時,原因寫在表單最上面,你選的「專案」和改好的清單都會留著。
新增一台伺服器
- 在「MCP」分頁按「新增 MCP 伺服器」。它在左側清單右下角,是一個圓形的「+」按鈕;右邊還沒有選伺服器時,也會有一個「新增 MCP 伺服器」按鈕。
- 表單的「基本」分頁有「基本」和「HTTP 設定」兩個部分。先填好「基本」。
- 在「HTTP 設定」填「伺服器網址」,需要時再填「Service Token」與「HTTP Headers」。新增中的伺服器有「基本」和「權限」兩個分頁。
- 在「權限」確認「專案」和權限清單。「專案」一開始是「私人」。
- 按「儲存」。
基本
- 名稱:一定要填,最多 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 使用它的工具
- 打開一個 AI Agent 的「工具」。
- 在「可用工具」下面,找到用伺服器名稱命名的那一組。
- 這一組的第一個是「(伺服器名稱):全部工具」,代表這台伺服器現在與以後提供的每一個工具。你也可以只加入其中幾個工具。
- 按「+ 加入」。
一個 AI Agent 可以加入每一台開著、而且「權限」清單開放給它的伺服器的工具,點名給它或經由「所有 AI Agent」都算,不論伺服器在哪一個專案或是「私人」,也不論你是不是那個專案的成員。這些工具只有在伺服器開著、清單還開放給這個 AI Agent 時才會生效,不論和它對話的人在哪一個專案工作,請看MCP 伺服器的工具。替伺服器改名,AI Agent 上的工具都還在;刪除伺服器,它的工具會從每一個 AI Agent 拿掉。
伺服器沒有回應時,工具清單上方會出現「有工具伺服器沒有回應」,這台伺服器的工具這次不會列出來。AI Agent 已經在用的工具還在,不會被取消。
權限分頁
存好的伺服器,表單左邊有兩個分頁:「基本」和「權限」。網址會寫著打開的是哪一個分頁,例如 /ai-agent/mcp/…/basic 和 /ai-agent/mcp/…/permission。伺服器的網址沒有寫分頁時,會打開「基本」。伺服器沒有「分享」。
只有伺服器的擁有者,以及權限清單給了「編輯」的人,才看得到「權限」分頁。其他人的表單沒有「權限」,網址寫著「權限」時會打開「基本」。
第一次打開「權限」分頁時,網站才會讀取權限清單。分頁從上到下是:
- 「擁有者」:擁有者的名字。只有擁有者可以換掉它,請看下面的「把 MCP 伺服器交給別人」;其他人看到的只是名字。
- 「專案」:這台伺服器放在哪一個專案,或「私人」。只有擁有者可以換:擁有者看到的是一個下拉選單,下面寫著「換專案會把權限清單換成新位置的預設清單。」,請看下面的「把 MCP 伺服器移到別的地方」;其他人看到的只是名字。
- 權限清單:一個表格,三欄是「權限擁有者」、「權限擁有類型」和「擁有權限」。「擁有權限」寫的是「編輯」、「刪除」或「檢視」。以前分享過這台伺服器的人或專案角色,會列成「檢視」。
清單是空的時,會寫「還沒有加入任何對象。只有擁有者能使用這個 MCP 伺服器。」讀取時會寫「讀取中…」,讀不到時會寫「讀不到權限清單,請重新開啟。」
擁有者修改權限清單。「權限管理」是並排的三個欄位,後面是「新增」按鈕:
- 第一個下拉選單選對象的類型:
- 「專案成員」:最前面是「所有專案成員」,接著是這台伺服器所在專案的每一個成員,擁有者除外。
- 「專案角色」:這台伺服器所在專案的角色。
- 「所有用戶」:在旁邊的框裡輸入完整的 email,找到在網站上註冊的人。只輸入一部分的 email 找不到人。擁有者不能加進清單,找到擁有者時會寫著「擁有者不用加進清單。」
- 「AI Agent」:最前面是「所有 AI Agent」,接著是這台伺服器所在專案裡、你看得到的 AI Agent,後面接著你自己的私人 AI Agent,名字後面寫著「私人」。
- 「工作流」:最前面是「所有工作流」,接著是這台伺服器所在專案裡、你打得開的工作流,後面接著你自己的私人工作流,名字後面寫著「私人」。
- 第二個欄位輸入名稱來搜尋,再從清單選一個對象。
- 第三個下拉選單選權限:「編輯」、「刪除」或「檢視」,請看誰可以做什麼。一開始是「檢視」。
按「新增」,這個對象就加到權限清單的最後。加完之後,第二個欄位會清空,類型和權限保持不變。已經在清單上的對象再加一次,只會換成新選的權限,清單上不會出現兩列。
在擁有者看到的權限清單上:
- 每一列的「擁有權限」是一個下拉選單,可以直接換成「編輯」、「刪除」或「檢視」。
- 每一列的最後有一個移除按鈕,按下去就把這一列拿掉。
- 專案角色、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 伺服器。只有網站的全域管理員在資料庫裡打開了這個設定的伺服器,才會收到這兩樣;這種伺服器的網址只有全域管理員可以改,請看換伺服器網址時。