AppBox

com.appboxappPublished by appboxapp.comOfficial publisherv1.0.0Updated Nov 6, 2026

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

Overview

AI-generated overview

Remote AppBox MCP server that lets an assistant check app setup, builds, devices and push campaigns, and send tester-only test pushes.

What you can do
  • Check onboarding status, list apps, verify app setup and read build status
  • Look up devices and, with extra scopes, review push campaigns, dashboards, best send times, in-app performance, billing and audiences
  • With additional permissions enabled: create apps, set testers, send test pushes and test in-app messages, create event types, topics, segments and support contacts
  • Search and read AppBox guides, public examples and the server API spec
When to use it
Useful when you work in AppBox and want an assistant to diagnose why pushes are not arriving, walk through FCM setup, summarize weekly push performance or forecast credit usage, without leaving the chat.
Requirements
Remote Streamable HTTP endpoint at mcp.appboxapp.com/mcp; no local package. Requires an AppBox account and OAuth sign-in through a browser, with the apps to allow chosen on the consent screen. A separate docs-only endpoint is available without login.
Before you install
Sign-in grants the assistant access to the AppBox apps you tick on the consent screen, and the consent notice mentions sending data to an external AI. Some tools create apps, set testers, send test pushes and in-app messages, or create segments and topics, so enable those scopes only if you want writes. Reject connections you did not start if the app is shown as unverified. Removing the connector in the AI app does not revoke the AppBox-side connection; revoke it in the console.

Installation

In SourceWeft

  1. Open AppBox in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.appboxapp%2Fappbox/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "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. 앱박스 서비스 이용은 서비스 약관과 개인정보 처리방침을 따릅니다.

Source: README.md at commit c5c65f4

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestOct 30, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts