// 面向编码智能体的应用发布

在本地构建。通过 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 地址，并按客户端要求调整配置格式。