文档 · AI / CLI / MCP

编码 Agent 部署 PocketBay 的三种方式

最便捷从一句话部署开始；完整步骤见 Agent Markdown；需要深度集成时使用 CLI 或 MCP。

最便捷

一句话部署

粘贴到 Cursor、Claude Code、Codex 或任何能读 URL 的 Agent。

请将当前项目部署到 PocketBay，部署手册：https://pocketbay.com/deploy

完整

Agent Markdown

/api/deploy/instructions 机器可读手册——配对、上传、构建、修复循环。

集成

CLI 与 MCP

在 Agent 工具链中使用 pocketbay CLI 或 MCP Server，而非复制粘贴。

pip install pocketbay
cd 你的项目
# framework 由 AI 分析后指定,例如 nextjs:
pocketbay deploy --framework nextjs

pip install "pocketbay[mcp]"
{
  "mcpServers": {
    "pocketbay": {
      "command": "pocketbay-mcp"
    }
  }
}

提供工具: start_deploy → check_authorized → finish_deploy → get_status(失败自愈循环)。

标准 Agent 流程（5 步）

1发送一句指令——将部署指令粘贴到正在处理项目的 AI 编码 Agent。
2AI 识别项目——本地读取 package.json、Dockerfile 与锁文件，选择部署类型。
3AI 读取手册——打开说明、创建配对会话、准备上传包。
4配对页批准——Agent 把授权链接作为单独一条消息发送（对话会展开为页面卡片）。在网页上登录并确认项目，不要在对话中回复。Agent 通过长等待接口检测授权后自动上传。
5AI 部署并修复——打包、上传、构建；失败时读取修复指引，最多重试三次。

支持的 Agent

Cursor · Claude Code · Codex · GitHub Copilot · Windsurf · Trae · 任何能获取公开 URL 的 Agent