Appbox

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

LLM Mart 0 views 23 listing impressions

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

  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 [앱 코드]

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

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

3. 다른 AI 앱에 연결

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

From the project's README.