Appbox
Set up and check AppBox apps: setup status, builds, devices, guides, tester-only test pushes.
앱박스(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/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_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. 연결 (앱박스 로그인)
- Claude Code 세션에서
/mcp→plugin:appbox:appbox서버를 고르고 Authenticate. - 브라우저에 앱박스 콘솔이 열리면 로그인합니다(이미 로그인돼 있으면 건너뜀).
- 허용 화면에서 권한·허용할 앱(전체 또는 선택)을 확인하고, 외부 AI 전송 고지에 동의한 뒤 허용.
- 앱 이름 아래 신원 표시를 확인하세요 — 「claude.ai 에서 확인된 앱」 · 「앱박스에 등록된 앱」 · 「확인되지 않은 앱」. 「확인되지 않은 앱」 인데 직접 시작한 연결이 아니라면 거부하세요.
- 브라우저에 완료가 뜨면 Claude Code 로 돌아옵니다.
/mcp에서 connected 로 바뀝니다.
이후 스킬을 씁니다.
| 이럴 때 | 스킬 |
|---|---|
| "앱박스로 푸시 보내고 싶어요", "뭐부터 해야 하나요" | /appbox:onboarding [앱 코드] |
| "FCM 등록 어떻게 해요" | /appbox:setup-fcm [앱 코드] |
| "푸시가 안 와요" | /appbox:check-setup [앱 코드] |
도구의 전체 이름은 mcp__plugin_appbox_appbox__appbox_list_apps 형식입니다(권한 규칙에 쓸 때 이 이름 사용).
- 연결 확인·해제: 앱박스 콘솔 계정 설정 › MCP 연결. 해제하면 즉시 끊기고, 다시 쓰려면 2번을 다시 합니다.
- AI 앱에서 앱박스 서버(커넥터)만 삭제하면 앱박스 쪽 연결은 남습니다. 끊으려면 콘솔에서 해제하세요.
- 허용할 앱: 연결할 때 체크한 앱만 볼 수 있습니다('전체 앱'은 그때 목록의 전체 선택). 연결한 뒤 만든 앱을 쓰려면 콘솔 계정 설정 › MCP 연결의 「허용 앱 변경」에서 그 앱을 체크하고 저장합니다 — 다시 연결할 필요 없이 다음 요청부터 적용됩니다.
- 비밀번호를 바꾸거나 재설정하면 모든 MCP 연결이 해제됩니다(콘솔 알림으로 알려 줍니다).
- 30일 동안 쓰지 않은 연결은 자동으로 해제됩니다. 다시 쓰려면 다시 로그인합니다.
3. 다른 AI 앱에 연결
모두 주소만 넣으면 처음 쓸 때 앱박스 로그인이 열립니다. 토큰을 넣지 마세요. 앱별 화면 안내는 가이드.
From the project's README.