English Français العربية

AppBox

Registre officiel Autres

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http appbox 'https://mcp.appboxapp.com/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "appbox": {
            "type": "http",
            "url": "https://mcp.appboxapp.com/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. 앱박스 AI 플러그인
  2. 구성
  3. 1. 설치
  4. 2. 연결 (앱박스 로그인)
  5. 3. 다른 AI 앱에 연결
  6. 4. 문제 해결
  7. 버전
  8. 배포 규칙 (관리자용)
  9. 문의
  10. 라이선스

앱박스 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/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 앱에 연결

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

앱연결
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)에는 이미 들어 있으니 따로 추가할 필요가 없습니다.

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 ./ 통과.

문의

appbox@appboxapp.com

라이선스

MIT — LICENSE. 앱박스 서비스 이용은 서비스 약관과 개인정보 처리방침을 따릅니다.

Questions fréquentes

Qu'est-ce que AppBox ?

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

Comment installer AppBox ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http appbox 'https://mcp.appboxapp.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour AppBox ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

AppBox est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient AppBox ?

Il est publié par MobilePartnersCo. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.