// 面向程式設計智慧代理的應用發布

在本機建置。透過 MCP 發布。

為程式設計智慧代理提供受控發布路徑：封裝成品、部署至現有 OrbitMesh 節點、檢查狀態與日誌，並回復版本。

查看智慧代理工具開啟主控台

// 智慧代理工具

選擇智慧代理的連線方式

Hosted MCP 服務遠端智慧代理，stdio 處理本機封裝，Skill 提供可重用的發布工作流程。

01 / HOSTED 建議

Hosted MCP

連接支援 OAuth 的 MCP 用戶端。存取僅限你選擇的組織，並會在每次請求時重新驗證。

Streamable HTTPOAuth 2.1 + PKCE免安裝

https://mcp.agent-deploy.ai/mcp

將此 URL 新增為遠端 MCP Server，登入 OrbitMesh，再選擇允許用戶端存取的組織。

02 / LOCAL

stdio MCP

當用戶端不支援託管 OAuth，或智慧代理需要直接封裝本機建置目錄時，執行輕量本機二進位檔。

LinuxmacOSWindowsamd64 + arm64

curl -fsSL https://install.agent-deploy.ai/mcp | sh

irm https://install.agent-deploy.ai/mcp.ps1 | iex

在 MCP 用戶端的處理程序環境中設定組織 UUID、私有 API Token 檔案，以及可選的工作區範圍。

03 / WORKFLOW

Agent Skill

安裝可重用的發布指引，讓程式設計智慧代理知道何時建置、呼叫哪些 MCP 工具、如何上傳，以及何時完成部署。

SKILL.md靜態與 Worker 成品封裝器可重用

curl -fsSL https://install.agent-deploy.ai/skill/orbitmesh-publish | sh

irm https://install.agent-deploy.ai/skill/orbitmesh-publish.ps1 | iex

安裝程式會寫入完整的 Skill 目錄。如需使用其他相容 Agent Skills 的位置，請設定 ORBITMESH_SKILLS_DIR。

// DEVELOPMENT

開發、預覽與晉級

本機開發，在獨立 Preview 驗證，再經明確授權將驗收過的不可變 Release 晉級至正式環境。

靜態 HTML／前端建置產物

平台發佈已接通

static

TypeScript Fetch Worker

平台發佈已接通

worker

OCI HTTP 容器

平台發佈已接通

oci

Next.js／vinext（固定版本候選）

本機驗收候選，尚未發佈

worker

JavaScript Worker＋WebAssembly 模組

平台發佈已接通

worker

Python 框架（僅執行階段驗收）

僅執行階段支援，尚無法發佈

worker

查看即時技術堆疊目錄

// 用戶端指南

串接你正在使用的代理程式

依照已核對的步驟串接主流程式設計與辦公代理程式。所有指南共用 OrbitMesh MCP 入口與同一份發佈 Skill。

程式設計代理程式

OpenAI CodexHosted OAuthAgent Skill

01 / 新增 MCP Server

codex mcp add orbitmesh --url https://mcp.agent-deploy.ai/mcp

02 / 授權 OrbitMesh

codex mcp login orbitmesh

03 / 安裝發佈 Skill

curl -fsSL https://install.agent-deploy.ai/skill/orbitmesh-publish | sh

04 / 驗證連線

codex mcp list

用戶端官方文件 ↗

Claude CodeHosted OAuthAgent Skill

01 / 新增 MCP Server

claude mcp add --transport http --scope user orbitmesh https://mcp.agent-deploy.ai/mcp

02 / 授權 OrbitMesh

/mcp

03 / 安裝發佈 Skill

curl -fsSL https://install.agent-deploy.ai/skill/orbitmesh-publish | sh -s -- --skills-dir "$HOME/.claude/skills"

04 / 驗證連線

claude mcp get orbitmesh

用戶端官方文件 ↗

OpenCodeHosted OAuthAgent Skill

01 / 新增 MCP Server

opencode mcp add orbitmesh --global --url https://mcp.agent-deploy.ai/mcp

02 / 授權 OrbitMesh

opencode mcp auth orbitmesh

03 / 安裝發佈 Skill

curl -fsSL https://install.agent-deploy.ai/skill/orbitmesh-publish | sh -s -- --skills-dir "$HOME/.config/opencode/skills"

04 / 驗證連線

opencode mcp list

用戶端官方文件 ↗

CursorHosted OAuthRemote MCP

01 / 新增 MCP Server

~/.cursor/mcp.json

{
  "mcpServers": {
    "orbitmesh": {
      "url": "https://mcp.agent-deploy.ai/mcp"
    }
  }
}

02 / 授權 OrbitMesh

cursor-agent mcp login orbitmesh

03 / 驗證連線

cursor-agent mcp list-tools orbitmesh

用戶端官方文件 ↗

VS Code / GitHub CopilotHosted OAuthRemote MCP

01 / 新增 MCP Server

Command Palette → MCP: Add Server → HTTP → https://mcp.agent-deploy.ai/mcp → orbitmesh → Global

02 / 設定檔方式

{
  "servers": {
    "orbitmesh": {
      "type": "http",
      "url": "https://mcp.agent-deploy.ai/mcp"
    }
  }
}

03 / 授權 OrbitMesh

Chat → Configure Tools → orbitmesh → Start

用戶端官方文件 ↗

Gemini CLIHosted OAuthRemote MCP

01 / 新增 MCP Server

~/.gemini/settings.json

{
  "mcpServers": {
    "orbitmesh": {
      "httpUrl": "https://mcp.agent-deploy.ai/mcp",
      "oauth": { "enabled": true }
    }
  }
}

02 / 授權 OrbitMesh

/mcp auth orbitmesh

03 / 驗證連線

gemini mcp list

用戶端官方文件 ↗

Qoder CLIHosted OAuthAgent Skill

01 / 新增 MCP Server

~/.qoder/settings.json

{
  "mcpServers": {
    "orbitmesh": {
      "type": "http",
      "url": "https://mcp.agent-deploy.ai/mcp",
      "oauth": { "enabled": true }
    }
  }
}

02 / 授權 OrbitMesh

qoder mcp auth orbitmesh

03 / 安裝發佈 Skill

curl -fsSL https://install.agent-deploy.ai/skill/orbitmesh-publish | sh -s -- --skills-dir "$HOME/.qoder/skills"

04 / 驗證連線

qoder mcp list

用戶端官方文件 ↗

辦公與通用代理程式

ChatGPTHosted OAuthRemote MCP

01 / 新增 MCP Server

ChatGPT web → Plugins → + → Add custom MCP server

02 / 設定檔方式

Name: OrbitMesh
Server URL: https://mcp.agent-deploy.ai/mcp
Authentication: OAuth

03 / 授權 OrbitMesh

Create as a plugin → review discovered tools → authorize OrbitMesh

04 / 驗證連線

Install the plugin → open a new Work chat → @OrbitMesh

用戶端官方文件 ↗

WorkBuddyHosted OAuthMCP + Skill

01 / 新增 MCP Server

mcp.json

{
  "mcpServers": {
    "orbitmesh": {
      "type": "streamableHttp",
      "url": "https://mcp.agent-deploy.ai/mcp",
      "timeout": 30000
    }
  }
}

02 / 授權 OrbitMesh

Connectors → OrbitMesh → Connect → authorize in browser

03 / 安裝發佈 Skill

Include skills/orbitmesh-publish in the connector package. Keep auth_mode unset to use the standard MCP OAuth flow.

用戶端官方文件 ↗

豆包工作 / Doubao WorkHosted OAuthRemote MCP

01 / 新增 MCP Server

開啟豆包工作桌面用戶端，進入「插件·技能·夥伴 → 插件 → + 新增 → 新建自訂插件」。伺服器名稱填寫 OrbitMesh，傳輸類型選擇 HTTP，驗證方式選擇 OAuth，伺服器 URL 貼上下方位址。

https://mcp.agent-deploy.ai/mcp

02 / 授權 OrbitMesh

儲存插件並連線，在瀏覽器開啟的 OrbitMesh 頁面登入，選擇允許存取的一個或多個組織並完成授權，然後返回豆包工作。

03 / 驗證連線

儲存插件後，建立工作任務，透過 @ 或「插件」選單選取 OrbitMesh。傳送下方提示，先驗證存取權限並查看可部署節點，再確認目標節點。

使用 OrbitMesh 列出已授權的組織及支援 Static 的部署節點。先顯示候選節點，等我確認節點後再部署。

用戶端官方文件 ↗

千问办公 / QwenWorkRemote MCPstdioAgent Skill

01 / 新增 MCP Server

扩展 / Extensions → 连接器 / Connectors → + 添加 / Add → 粘贴 JSON 配置 / Paste JSON

02 / 設定檔方式

{
  "mcpServers": {
    "orbitmesh": {
      "type": "streamable-http",
      "url": "https://mcp.agent-deploy.ai/mcp"
    }
  }
}

03 / 本機 stdio 備用方案

curl -fsSL https://install.agent-deploy.ai/mcp | sh
# Windows PowerShell: irm https://install.agent-deploy.ai/mcp.ps1 | iex

{
  "mcpServers": {
    "orbitmesh": {
      "type": "stdio",
      "command": "orbitmesh-mcp",
      "env": {
        "ORBITMESH_TENANT_ID": "YOUR_ORGANIZATION_UUID",
        "ORBITMESH_API_TOKEN_FILE": "/absolute/private/token-file",
        "ORBITMESH_WORKSPACE": "/absolute/project/path"
      }
    }
  }
}

04 / 安裝發佈 Skill

curl -fsSL https://install.agent-deploy.ai/skill/orbitmesh-publish | sh -s -- --skills-dir "$HOME/.qwenworkcn/skills"

用戶端官方文件 ↗

// 發布流程

本機與遠端智慧代理共用一套工作流程

兩種傳輸方式使用相同的不可變成品、Release、Deployment 與就緒狀態模型。

01探索

選擇已授權的組織與現有節點。

02建置

產生靜態目錄、選擇鎖定 Digest 的 OCI 映像，或封裝 Worker 模組。

03準備

上傳或匯入依內容定址的不可變成品。

04部署

提交含 Generation 檢查的部署，並視需要啟用公開存取。

05觀測

輪詢狀態、讀取有限日誌，並可停止、啟動或回復。

// 常見問題

MCP、Skill 與授權

應該使用 Hosted MCP 還是 stdio？

優先使用 Hosted MCP，透過 OAuth 即可連線。代理程式需直接封裝本機建置目錄，或用戶端無法完成 Hosted OAuth 時使用 stdio。

Agent Skill 有什麼作用？

Skill 告訴代理程式 OrbitMesh 的發佈流程與工具呼叫順序。它不儲存憑證，也不取代 MCP 授權。

一次授權可以涵蓋多個組織嗎？

可以。在 OAuth 同意頁選擇一個或多個組織。OrbitMesh 會在每次請求時重新檢查所選組織及目前權限。

其他 MCP 用戶端能否串接？

通常可以，只要支援含 OAuth 2.1 與 PKCE 的 Streamable HTTP，或本機 stdio。使用相同 MCP 位址並依用戶端需求調整設定格式。