AppBox

AppBox AI 插件

这是一个将 AppBox 远程 MCP 服务连接到 Claude Code · Codex 的插件，以及包含该插件的市场仓库。 通过 AppBox 账号登录（OAuth） 进行连接，无需直接处理令牌。

面向用户的指南（连接 Claude · Claude Code · Codex · Cursor、阅读连接界面、问题排查）请参阅 AppBox 指南 › AI 连接（MCP）。此 README 主要介绍安装命令和仓库结构。

结构

.claude-plugin/marketplace.json            Claude 마켓플레이스 매니페스트 (이름: appbox-ai)
.agents/plugins/marketplace.json           Codex 마켓플레이스 매니페스트 (이름: appbox-ai)
plugins/appbox/.claude-plugin/plugin.json  Claude 플러그인 매니페스트 (이름: appbox)
plugins/appbox/.codex-plugin/plugin.json   Codex 플러그인 매니페스트 (표시 이름·설명·카테고리 포함)
plugins/appbox/.mcp.json                    원격 MCP 서버 설정 (Streamable HTTP, 주소만 — 토큰 없음)
plugins/appbox/skills/onboarding/SKILL.md   스킬: 시작 안내 — 지금 상태 진단 → 다음 한 단계
plugins/appbox/skills/setup-fcm/SKILL.md    스킬: FCM 발급·등록 단계 안내 (키 파일은 다루지 않음)
plugins/appbox/skills/check-setup/SKILL.md  스킬: 푸시 연동 점검 절차
plugins/appbox/assets/                      아이콘(로고 · 작은 아이콘) — Codex 목록 표시용

• 服务：https://mcp.appboxapp.com/mcp（Streamable HTTP，仅 POST）
• 身份验证：OAuth — 首次使用时，Claude Code 会在浏览器中打开 AppBox 登录和授权页面。令牌由 Claude Code 获取、保存并自动续期（用户不会看到令牌）
• 查询工具：appbox_get_onboarding_status · appbox_list_apps · appbox_check_app_setup · appbox_get_build_status
• 其他权限工具（仅在连接时启用的情况下可用）：appbox_create_app · appbox_set_tester · appbox_send_test_push · appbox_send_test_inapp · appbox_list_inapp_campaigns · appbox_get_delivery_result · appbox_create_event_type · appbox_create_topic · appbox_create_segment · appbox_create_support_contact
• 设备工具：appbox_find_device（查询）
• 文档工具（默认包含在登录连接中，且需由服务端启用）：appbox_get_overview · appbox_search_docs · appbox_get_doc（指南） · appbox_list_examples · appbox_get_example（公开示例源码） · appbox_get_api_spec（服务端 API 规范）
• 此仓库仅包含清单和技能。不包含服务端代码或凭据。

1. 安装

claude plugin marketplace add MobilePartnersCo/appbox-ai   # 마켓플레이스 등록 (이름: appbox-ai)
claude plugin install appbox@appbox-ai                   # 플러그인 설치
claude plugin list                                       # appbox@appbox-ai 가 enabled 인지 확인

• 若要自动接收更新，请在 Claude Code 的 /plugin → 市场 appbox-ai 中启用自动更新（第三方市场默认关闭）。
• 也可以在下载此仓库的位置运行 claude plugin marketplace add ./ 进行本地注册。若只想暂时试用插件，请使用 claude --plugin-dir ./plugins/appbox。

卸载：claude plugin marketplace remove appbox-ai（同时移除市场及其插件）

2. 连接（AppBox 登录）

1. 在 Claude Code 会话中选择 /mcp → plugin:appbox:appbox 服务，然后点击 Authenticate。
2. 浏览器打开 AppBox 控制台后，登录（如果已经登录则跳过）。
3. 在授权页面确认权限和允许访问的应用（全部或选择），阅读并同意向外部 AI 传输数据的提示，然后点击允许。
   • 请确认应用名称下方的身份标识 — 「已在 claude.ai 验证的应用」 · 「已在 AppBox 注册的应用」 · 「未验证的应用」。如果显示「未验证的应用」，且此连接不是由你主动发起的，请拒绝。
4. 浏览器显示完成后，返回 Claude Code。/mcp 中的状态会变为 connected。

之后即可使用技能。

使用场景	技能
“我想通过 AppBox 发送推送”“我应该从哪里开始？”	/appbox:onboarding [앱 코드]
“如何注册 FCM？”	/appbox:setup-fcm [앱 코드]
“收不到推送”	/appbox:check-setup [앱 코드]

工具的完整名称格式为 mcp__plugin_appbox_appbox__appbox_list_apps（在权限规则中使用此名称）。

• 确认连接或断开连接：AppBox 控制台 账号设置 › MCP 连接。断开后会立即失效；若要再次使用，请重新执行第 2 步。
• 仅在 AI 应用中删除 AppBox 服务（连接器），不会断开 AppBox 端的连接。要断开连接，请在控制台中操作。
• 允许访问的应用：只能查看连接时勾选的应用（“全部应用”表示当时列表中的所有应用）。若要使用连接后创建的应用，请在控制台 账号设置 › MCP 连接中的「更改允许的应用」下勾选该应用并保存 — 无需重新连接，从下次请求起生效。
• 更改或重置密码后，所有 MCP 连接都会断开（控制台会发送通知）。
• 30 天未使用的连接会自动断开。若要再次使用，请重新登录。

3. 连接到其他 AI 应用

只需输入地址，首次使用时就会打开 AppBox 登录页面。请勿输入令牌。各应用的界面说明请参阅指南。

应用	连接方式
Claude（网页 · 桌面 · 移动端）	设置 › 连接器 › 浏览中选择 AppBox → 连接。如果看不到，请将下方地址添加为自定义连接器
Claude Code（不使用插件）	claude mcp add --transport http appbox https://mcp.appboxapp.com/mcp → 在 /mcp 中选择 appbox → Authenticate
Codex（插件）	codex plugin marketplace add MobilePartnersCo/appbox-ai → codex plugin add appbox@appbox-ai → codex mcp login appbox
Codex（不使用插件）	codex mcp add appbox --url https://mcp.appboxapp.com/mcp
Cursor · 其他应用	添加远程 MCP 地址 https://mcp.appboxapp.com/mcp（Cursor 使用 ~/.cursor/mcp.json 中的 mcpServers.appbox.url）。连接界面显示「未验证的应用」是正常情况；仅在连接由你主动发起时才允许

卸载 Codex 插件：codex plugin remove appbox@appbox-ai → codex plugin marketplace remove appbox-ai

无需登录，仅使用指南（文档入口）

即使没有 AppBox 账号，也可以查找公开指南、示例和服务端 API 规范（仅限文档工具，不会显示登录页面）。登录 AppBox 的连接（/api/mcp）已包含这些工具，无需单独添加。

claude mcp add --transport http appbox-docs https://mcp.appboxapp.com/docs

• 调用次数限制：每个 IP 每分钟 60 次，每次只能发送一条消息（不支持批量）。
• 执行 codex mcp add 时，Codex 可能会显示登录页面（关闭后仍可使用）。若不想显示，请直接在 ~/.codex/config.toml 中填写 [mcp_servers.appbox-docs] · url = "https://mcp.appboxapp.com/docs"。

4. 问题排查

症状	检查事项
/mcp 中显示 needs authentication · 401	重新登录：/mcp → appbox → Authenticate。如果在控制台中断开了连接或更改了密码，则需要重新连接
403 insufficient_scope	连接权限不足。请重新连接，并在授权页面中授予权限
403（其他情况）	可能是账户被停用等问题——请联系 Appbox 客户支持
404	地址错误——如果是手动连接，请确认地址为 https://mcp.appboxapp.com/mcp
APP_NOT_ALLOWED	连接时未获准使用的应用（包括连接后创建的应用）。请在控制台的账户设置 › MCP 连接中，通过「更改允许的应用」勾选该应用并保存

版本

• 插件的 version 使用 SemVer，与服务端（MCP appbox）版本无关。变更记录请见 CHANGELOG.md。
• 只有提升 version 后，用户才会收到更新。

发布规则（管理员）

分支	用途
main	面向客户的发布版本——仅包含提升版本并添加标签（v1.0.1 …）的提交
develop	修改与测试。将此分支检出到本地后，以本地路径注册并进行测试（claude plugin marketplace add ./）

• plugins/appbox/.mcp.json 中的地址固定为生产地址。使用测试服务器进行测试时，只在本地副本中更改地址，不要提交（测试方法见内部文档）。
• 先发布服务器，再发布插件——如果技能要使用新的服务器工具，请等该工具部署到生产服务器后，再发布到 main。如果顺序颠倒，客户的插件会调用不存在的工具。
• 发布：将 develop 合并到 main · 同时提升三个清单（.claude-plugin/marketplace.json · plugins/appbox/.claude-plugin/plugin.json · plugins/appbox/.codex-plugin/plugin.json）中的 version · 更新 CHANGELOG.md · 添加标签 · 通过 claude plugin validate --strict ./ 验证。

联系方式

[email protected]

许可证

MIT — LICENSE。使用 Appbox 服务须遵守服务条款和隐私政策。