加入 MCP 伺服器與 Skills

Agent 需要額外工具或服務連線時，可加入 MCP 伺服器；想重複使用某類工作的指示與資源時，可加入 Skill。Noea 集中管理這些擴充功能，供不同 Agent 的一般對話使用。

擴充功能為選用，開始時不需要。解釋與整理任務不使用此處加入的擴充功能。

選擇所需擴充功能

伺服器是否可用，也取決於 Agent 是否支援其連線方式。Skill 命令請以對話實際顯示的清單為準。

加入 MCP 伺服器

開啟設定 → MCP 伺服器，新增伺服器、輸入名稱並選擇連線方式。

• stdio：在本機啟動服務。輸入命令、參數及必要環境變數，每行一個參數。
• HTTP：透過 URL 連接服務。輸入伺服器位址及必要標頭。

若服務提供相容 JSON 設定，可用貼上 JSON填入表單。儲存前確認命令、位址及驗證欄位。

名稱不得重複，且不區分大小寫。以 noea 開頭的名稱為保留名稱。第一列是 Noea 內建伺服器，固定啟用且不可刪除。

測試連線

編輯面板的測試連線使用目前表單值，從清單測試則使用已儲存設定。

成功時顯示工具名稱與數量；失敗時指出階段，例如找不到命令、程序結束、逾時、請求遭拒或交握失敗。HTTP 服務若需授權，請依所選 Agent 的授權流程操作。

測試成功只表示這組設定能連線，不保證每個 Agent 都支援，也不會自動為對話啟用伺服器。

為對話啟用伺服器

伺服器清單的「新對話預設啟用」設定決定初始選取。也可在特定對話的設定選單選擇 MCP 伺服器。

選擇隨對話儲存。已連線 Agent 不會立刻重新載入變更，需下次連線才生效。要使用新設定，請建立新對話並確認伺服器選取。

選單會說明伺服器不可用的原因，例如缺少環境變數或不支援連線方式。

使用環境變數

環境變數及標頭值支援 ${VAR}，引用 Noea 執行環境的變數，於連線時讀取。設定後請測試連線。在某個終端機執行 export，不保證已執行中的 Noea 程序取得該值。

欄位預設隱藏值，點選可顯示。隱藏只影響畫面呈現，不改變設定的儲存或使用方式。

加入 Skill

開啟設定 → Skill，選擇新增，再選取包含 SKILL.md 的資料夾。格式有問題時，應用程式會說明。

Skill 會加入 Noea 的 Skill 庫，新增或移除在新對話生效。可在檔案管理員顯示位置。刪除只移除 Skill 庫中的副本，不刪除最初選取的資料夾。

同一頁也顯示從 Agent 目錄找到的使用者層級與專案層級 Skills，這些為唯讀。可查看位置或選擇複製到 Noea。此清單不包含所有 Agent 內建或外掛提供的 Skills。

在對話使用擴充功能

開啟新對話，在輸入框開頭輸入 /，瀏覽 Noea Skills 與 Agent 命令。選擇可用項目，補上目前任務需求並傳送。

找不到擴充功能時，先確認已建立新對話且 Agent 支援，再參閱疑難排解。