全部產品
Search
文件中心

Platform For AI:通過MCP將DSW執行個體接入Agent

更新時間:Aug 01, 2026

開啟DSW執行個體的MCP服務後,即可將其接入Agent用戶端,讓Agent直接在執行個體中執行命令、讀寫檔案、運行代碼,實現雲端開發工作單位的智能託管。

前提條件

DSW執行個體或所屬的資源配額已配置VPC及安全性群組。

應用情境

將DSW執行個體接入Agent後,相當於給 Agent 開通了一台隨時可用的雲端開發機。它可以直接在執行個體裡讀寫代碼、執行命令、跑實驗,把您從重複的環境操作中解放出來。典型情境包括:

  • 遠程代碼開發與調試:讓Agent在執行個體中建立、修改代碼並運行,自動定位報錯、修複後重跑,完成一個功能的閉環開發。

  • 環境準備與依賴管理:一句話讓Agent安裝缺失的Python或系統依賴、檢查CUDA與架構版本、校正運行環境,省去逐條敲命令。

  • 訓練與實驗任務託管:Agent啟動訓練指令碼後非同步等待,期間查看日誌、監控輸出,訓練結束自動匯總結果。

  • 資料處理與文檔整理:批量檢索、清洗執行個體內的資料檔案,或把網頁、PDF、Office文檔轉成Markdown供後續分析。

操作步驟

步驟一:建立DSW執行個體並開啟MCP服務

開啟MCP服務共分三步:開啟服務開關、產生訪問憑證、在安全性群組允許存取連接埠。完成後,Agent即可通過MCP協議訪問該執行個體。

  1. 開啟MCP服務開關。以使用公用資源建立執行個體為例,建立DSW時配置以下關鍵參數,其他參數按需配置即可。

    已存在的執行個體可在執行個體列表頁,單擊操作列下的變更配置,重新設定DSW執行個體。
    • 资源类型:選擇公用資源。

    • 专有网络配置:選擇同地區下的Virtual Private Cloud。必須配置VPC才能啟用MCP服務。

    • 安全组:選擇建立的安全性群組。

    • 交换机:選擇建立的交換器。

    • 启用MCP服务:開啟開關。開啟後會出現名稱為MCP的服務,預設監聽執行個體的9806連接埠。

    若要從公網訪問DSW執行個體(例如通過本地Agent串連),還需配置以下參數:

    • 服务访问与端口配置

      • 公网访问:勾選。

      • 公网访问端口:如1078。

    • 从公网访问实例選擇DNAT + EIP

      • NAT网关:選擇建立的NAT Gateway。

      • 弹性公网IP:選擇NAT Gateway關聯的EIP。

    配置完成後,單擊确定建立執行個體。

  2. 產生訪問憑證。DSW執行個體建立完成後,單擊執行個體名稱進入詳情頁面,在访问配置地區,單擊產生訪問憑證。該憑證用於Agent調用MCP服務時的身份鑒權,調用時以Bearer Token形式放入要求標頭。

    至此,您得到了MCP的接入地址訪問憑證

    說明

    憑證有效期間預設為7天,到期後可在同一位置重建;重建後需同步更新Agent側配置中的憑證。

步驟二:安全性群組允許存取連接埠和IP

在DSW詳情頁网络信息地區,單擊安全性群組名稱跳轉至安全性群組詳情頁面。在入方向頁簽單擊增加規則,配置以下參數,其他參數預設即可。

  • 訪問來源:填寫Agent部署位置的IP地址(例如運行Agent的本地電腦公網出口IP)。

  • 訪問目的(本執行個體):填寫9806連接埠。

步驟三:Agent串連到DSW執行個體

DSW MCP服務採用標準Streamable HTTP協議,主流Agent用戶端均可接入。開啟Agent用戶端(如Open Code、Qoder CLI),將以下提示詞發給Agent,替換其中的<MCP接入地址><訪問憑證>為實際值,Agent將自動完成MCP接入。

如果使用本地Agent用戶端串連DSW執行個體,MCP接入地址應該使用公網的接入地址。
幫我添加一個 MCP 伺服器,名稱 dsw-mcp,協議 Streamable HTTP,地址 http://<MCP接入地址>,要求標頭加 Authorization: Bearer <訪問憑證>。請按照你的 MCP 配置方式自動完成設定。

串連完成後,您可以在Agent用戶端中輸入以下命令測試聯通性。

幫我在dsw的/mnt/workspace目錄下建立一個hello_world的python代碼檔案

執行完成後,開啟DSW執行個體,可以看到在工作區產生的hello_world.py檔案。

支援的工具集

DSW MCP服務通過標準Streamable HTTP協議提供一組工具,Agent串連後自動載入工具清單。工具分為Shell、檔案、系統、格式轉換、代碼五類,共16個。

Shell域(5個)

在執行個體內執行命令,連續命令共用工作目錄,適合跑指令碼、裝依賴、啟動訓練。

工具

功能

關鍵參數

shell_exec

執行shell命令

cmd(必填)、cwd、new_session、timeout

shell_view

查看會話累積輸出與狀態

session_id、limit

shell_wait

等待非同步命令執行完成

session_id、seconds

shell_write

向運行中的進程發送輸入

session_id、input、press_enter

shell_kill

終止並清理會話

session_id

檔案域(7個)

讀寫、檢索、編輯執行個體內的檔案。

工具

功能

關鍵參數

file_read

讀取檔案內容(可按行範圍)

path(必填)、start_line、end_line、sudo

file_write

寫入/追加檔案,支援base64二進位

path、content、encoding、append

file_str_replace

檔案內全域替換字串

path、old_str、new_str

file_search

正則搜尋檔案內容

path、regex

file_find

按glob尋找檔案

path、pattern

file_list

列目錄(支援遞迴、按類型過濾)

path、recursive、file_types

file_edit

支援撤銷的編輯器

command(view/create/str_replace/insert/undo_edit)、path等

系統域(2個)

查詢執行個體環境與已安裝依賴。

工具

功能

關鍵參數

system_info

查詢執行個體環境(OS/Python/Node/可用工具)

system_packages

列出已安裝的Python/Node.js包

language

格式轉換域(1個)

工具

功能

關鍵參數

util_to_markdown

將網頁/PDF/Office/圖片等轉為Markdown

uri

代碼域(1個)

工具

功能

關鍵參數

code_run

執行代碼(當前支援Python)

code、language、timeout

開啟MCP服務後,以上工具立即可用,無需額外配置。