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 分