← 返回首页

AI 接入方式

三种方式,都不需要你手动复制任何密钥。授权只需在浏览器点一次。

统一入口 · 让 AI 自动选择能力

不确定该使用部署、用户系统还是未来的新能力时，直接发：

请根据我的需求选择并使用 PocketBay 能力，能力目录：https://pocketbay.com/ai

AI 会先查询能力目录，再读取具体执行手册。目录见 /ai。

方式一 · 一句话(零配置,推荐)

把这句话发给你的 AI 编程助手(Cursor / Claude Code / Codex 等):

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

AI 会抓取该链接、读到部署手册,创建配对会话并给你一个授权链接。你点开授权后,它自动打包、上传、构建;失败会读日志和修复建议,在告知你后修改代码并重试,最多尝试 3 次。

可视化引导见 /deploy;机器可读手册见 /api/deploy/instructions。

一句话接入 PocketBay 用户系统

应用需要登录或保存每个用户的数据时，把这句话发给 AI：

请为当前项目接入 PocketBay 用户系统，接入手册：https://pocketbay.com/app-auth

AI 会根据静态或动态项目选择正确的身份接口、修改数据隔离逻辑，并提醒你重新部署和开启项目认证。

可视化入口见 /app-auth。

方式二 · CLI

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

首次运行打印授权链接,点一下即可(同目录以后免授权)。成功后输出访问 URL。AI 也可直接调用它:失败时以非零退出码 + 构建日志结束,便于 AI 修复后重跑。

方式三 · MCP Server

安装后在 AI 客户端的 MCP 配置里加一条 stdio server:

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

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

部署约定