MCP 已連線卻無法使用？依階段排查 Mono 連線問題

MCP 伺服器儲存成功，並不代表工具能用。位址可能是對的，但登入還沒完成；登入可能成功了，但伺服器的工具沒能載入；工具也可能載入了，卻仍然收到錯誤的請求。修改任何設定之前，先找出第一個出問題的環節。

本文介紹 Reunified 的 Mono 中的問題排查。Mono 還沒有正式推出（可以加入候補名單）。如果是第一次連線，請使用 MCP 設定指南。這裡的目標是把含糊的「不能用」變成一個清楚、可重複的觀察結果，同時避免意外重複寫入操作。

1. 記錄現象，停止結果不明的重試

記下伺服器名稱、傳輸方式、裝置、App 版本、你想做的事以及確切的錯誤訊息，並去掉其中的機密內容。註明同樣的設定以前是否能用，以及之後改了什麼。「登入後工具清單是空的」比「MCP 壞了」有用得多。

如果上一次請求可能會建立、傳送或更新內容，重試前先檢查目的地。回應遺失並不代表操作沒有發生。排查時改用一個唯讀的小請求，例如列出一個你能核對的測試專案中的某一項。

私下保存一份最後能用的設定。不要把權杖、授權碼或工具的私密輸出貼到公開的求助文中。

Mono 的 HTTP 連線需要的是 MCP 伺服器位址，而不是一般網站首頁或模型 API 位址。把完整的 URL（包括路徑）和伺服器發布者目前的文件對照。網頁能在瀏覽器中開啟，只代表這個頁面能連上，不代表 MCP 能在那裡運作。

使用「標準輸入/輸出」（stdio）時，在需要啟動它的裝置上檢查指令和參數。重新登入解決不了指令遺失或裝置無法執行的問題。手機和電腦不一樣，不要期待電腦上的指令能在手機上執行。

含有 localhost 的位址指向發出請求的那台裝置本身。請從實際裝置、透過受支援且已登入的途徑測試。不要為了讓測試通過而削弱正常伺服器的存取控制。

檢查你選擇的驗證方式。「Bearer 權杖」需要在對應欄位中填入該服務的正確權杖。OAuth 需要正確的帳號、符合伺服器的要求，並完整地回到 Mono；提早關閉瀏覽器不算登入成功。

Mono 可以在登入完成前就儲存伺服器，所以已儲存的伺服器並不能證明登入成功。即使登入成功，伺服器的工具也可能有一段時間載入失敗。無論是已儲存的項目，還是「已連線到」的提示，都不能證明某個工具已經可用。

如果變更伺服器 URL 或傳輸方式，Mono 會把它當作新的連線，因此你可能需要重新登入。位址確實寫錯就改正，但不要把一再修改能用的 URL 當成通用的重設手段。請依照發布者文件中的用戶端和重新導向設定操作，不要自行猜測數值。

MCP 架構區分了工具、資源和提示。伺服器可能只提供其中一部分，所以只提供資源的伺服器不會給助手任何可呼叫的工具。

對於已安裝的 MCP 技能，開啟它的「設定」部分，查看 Mono 找到了哪些工具。如果是空的，檢查登入狀況以及伺服器是否列出了工具；不要以為服務的所有操作都能用。儲存伺服器並不是完整的健康檢查。

也要檢查聊天使用的模型。並非每個模型都能呼叫工具，你自己接入的部分模型也是如此。一個文字回答得很好的模型，仍可能是已連線的工具從未被使用的原因。自訂端點指南對此有說明。

用一個無害的請求，並把結果和原始服務對照：

text

讀取我指定的現有示範項目標題。
不要建立、編輯、傳送或刪除任何內容。
如果存取失敗，請回報失敗，不要猜測標題。

看到的情況	接著檢查
無法連到位址	位址、傳輸方式、裝置網路以及伺服器是否在運作
登入無法完成	帳號、驗證方式以及發布者的 OAuth 要求
一個工具都沒有出現	伺服器提供什麼、工具是否已載入、模型是否支援工具
某個工具失敗	所需輸入、服務端權限以及回傳的錯誤
能讀取，寫入被阻擋	你原本想給的存取範圍和該工具的權限設定；不要全部開放

工具本身的錯誤，和一個空白但成功的結果是兩回事。把回傳的狀態和相關文字放在一起保存，並去掉機密資訊。

每次只改一項，重複同樣的唯讀測試並記錄結果。如果之後需要寫入，先確認確切的目標，並在服務中核實結果後再嘗試下一次。

簡短記下出問題的環節、版本、所做的變更以及最後一次成功的測試。在 Mono 中刪除連線和在服務供應商那裡撤銷存取權是兩個獨立的步驟。使用過程中的權限決定，請閱讀工具權限審查指南；一再核准並不能修好連線。