AppBox

com.appboxapp由 appboxapp.com 发布官方发布者v1.0.0更新于 Nov 6, 2026

Set up and check AppBox apps: setup status, builds, devices, guides, tester-only test pushes.

已验证Streamable HTTP可网页运行开发者工具沟通与协作商业与电商

概览

AI 生成的概览

AppBox 远程 MCP 服务器，让助手查看应用配置状态、构建、设备与推送活动，并发送仅面向测试人员的测试推送。

可以做什么
  • 查看接入引导状态、列出应用、检查应用配置并读取构建状态
  • 查找设备；在获得额外权限时可查看推送活动、看板、最佳发送时间、应用内表现、账单与受众
  • 开启额外权限后可创建应用、设置测试人员、发送测试推送与应用内测试消息，创建事件类型、主题、分群与客服联系人
  • 搜索并阅读 AppBox 指南、公开示例与服务器 API 规范
适用场景
适合在 AppBox 中工作时使用：让助手排查推送收不到的原因、指导 FCM 配置、汇总每周推送表现或预测额度消耗，无需离开对话。
运行要求
远程 Streamable HTTP 端点 mcp.appboxapp.com/mcp，无需本地安装包。需要 AppBox 账号，并通过浏览器完成 OAuth 登录，在授权页选择允许访问的应用。另有免登录的纯文档端点。
安装前请注意
登录后助手可访问你在授权页勾选的 AppBox 应用，授权提示中说明数据会发送给外部 AI。部分工具会创建应用、设置测试人员、发送测试推送与应用内消息、创建分群与主题，仅在需要写入时开启这些权限。若应用显示为未验证且并非你主动发起的连接，应拒绝。在 AI 应用中删除连接器不会解除 AppBox 侧的连接，需在控制台撤销。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AppBox，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.appboxapp%2Fappbox/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "appbox": {
      "type": "http",
      "url": "https://mcp.appboxapp.com/mcp"
    }
  }
}

README

앱박스 AI 플러그인

앱박스(AppBox) 원격 MCP 서버를 Claude Code · Codex 에 연결하는 플러그인과, 그 플러그인을 담은 마켓플레이스 저장소입니다. 연결은 앱박스 계정 로그인(OAuth) 으로 하며, 토큰을 직접 다루지 않습니다.

사용자용 안내(Claude · Claude Code · Codex · Cursor 연결, 연결 화면 읽는 법, 문제 해결)는 앱박스 가이드 › 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/skills/weekly-report/SKILL.md    스킬: 주간 성과 보고(운영 현황 조회 권한)plugins/appbox/skills/campaign-review/SKILL.md  스킬: 캠페인 회고(운영 현황 조회 권한)plugins/appbox/skills/credit-forecast/SKILL.md  스킬: 크레딧 소진 예측(운영 현황 조회 권한)plugins/appbox/assets/                      아이콘(로고 · 작은 아이콘) — Codex 목록 표시용
  • 서버: https://mcp.appboxapp.com/mcp (Streamable HTTP, POST 전용)
  • 인증: OAuth — 처음 쓸 때 Claude Code 가 브라우저로 앱박스 로그인·허용 화면을 연다. 토큰은 Claude Code 가 받아 보관하고 자동으로 갱신한다(사용자는 토큰을 보지 않는다)
  • 조회 도구: appbox_get_onboarding_status · appbox_list_apps · appbox_check_app_setup · appbox_get_build_status
  • 운영 현황 조회 도구(연결할 때 받은 경우): appbox_list_push_campaigns, appbox_get_push_campaign, appbox_get_dashboard, appbox_get_best_send_time, appbox_get_inapp_performance, appbox_get_billing, appbox_list_audiences
  • 추가 권한 도구(연결할 때 켠 경우만): 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. 설치

bash
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. 연결 (앱박스 로그인)

  1. Claude Code 세션에서 /mcp → plugin:appbox:appbox 서버를 고르고 Authenticate.
  2. 브라우저에 앱박스 콘솔이 열리면 로그인합니다(이미 로그인돼 있으면 건너뜀).
  3. 허용 화면에서 권한·허용할 앱(전체 또는 선택)을 확인하고, 외부 AI 전송 고지에 동의한 뒤 허용.
    • 앱 이름 아래 신원 표시를 확인하세요 — 「claude.ai 에서 확인된 앱」 · 「앱박스에 등록된 앱」 · 「확인되지 않은 앱」. 「확인되지 않은 앱」 인데 직접 시작한 연결이 아니라면 거부하세요.
  4. 브라우저에 완료가 뜨면 Claude Code 로 돌아옵니다. /mcp 에서 connected 로 바뀝니다.

이후 스킬을 씁니다.

이럴 때스킬
"앱박스로 푸시 보내고 싶어요", "뭐부터 해야 하나요"/appbox:onboarding [앱 코드]
"FCM 등록 어떻게 해요"/appbox:setup-fcm [앱 코드]
"푸시가 안 와요"/appbox:check-setup [앱 코드]
"지난주 푸시 성과 정리해 줘"/appbox:weekly-report [앱 코드]
"어제 보낸 캠페인 어땠어?"/appbox:campaign-review [앱 코드] [캠페인 코드]
"크레딧 언제 떨어져?"/appbox:credit-forecast [앱 코드]

도구의 전체 이름은 mcp__plugin_appbox_appbox__appbox_list_apps 형식입니다(권한 규칙에 쓸 때 이 이름 사용).

  • 연결 확인·해제: 앱박스 콘솔 계정 설정 › MCP 연결. 해제하면 즉시 끊기고, 다시 쓰려면 2번을 다시 합니다.
  • AI 앱에서 앱박스 서버(커넥터)만 삭제하면 앱박스 쪽 연결은 남습니다. 끊으려면 콘솔에서 해제하세요.
  • 허용할 앱: 연결할 때 체크한 앱만 볼 수 있습니다('전체 앱'은 그때 목록의 전체 선택). 연결한 뒤 만든 앱을 쓰려면 콘솔 계정 설정 › MCP 연결의 「허용 앱 변경」에서 그 앱을 체크하고 저장합니다 — 다시 연결할 필요 없이 다음 요청부터 적용됩니다.
  • 비밀번호를 바꾸거나 재설정하면 모든 MCP 연결이 해제됩니다(콘솔 알림으로 알려 줍니다).
  • 30일 동안 쓰지 않은 연결은 자동으로 해제됩니다. 다시 쓰려면 다시 로그인합니다.

3. 다른 AI 앱에 연결

모두 주소만 넣으면 처음 쓸 때 앱박스 로그인이 열립니다. 토큰을 넣지 마세요. 앱별 화면 안내는 가이드.

앱연결
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

로그인 없이 가이드만 (문서 입구)

앱박스 계정이 없어도 공개 가이드·예제·서버 API 명세를 찾아볼 수 있습니다(문서 도구만, 로그인 화면 없음). 앱박스 로그인 연결(/api/mcp)에는 이미 들어 있으니 따로 추가할 필요가 없습니다.

bash
claude mcp add --transport http appbox-docs https://mcp.appboxapp.com/docs
  • 호출 수 제한: IP 당 분당 60회, 한 번에 메시지 하나(배치 불가).
  • Codex 는 codex mcp add 때 로그인 화면을 띄울 수 있습니다(닫아도 동작). 띄우지 않으려면 ~/.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 (그 밖)계정 정지 등 — 앱박스 고객지원 문의
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. 앱박스 서비스 이용은 서비스 약관과 개인정보 처리방침을 따릅니다.

来源：README.md，提交 c5c65f4

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v1.0.0最新Oct 30, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分