AppBox

AppBox AI プラグイン

AppBox のリモート MCP サーバーを Claude Code · Codex に接続するプラグインと、そのプラグインを含むマーケットプレイスリポジトリです。 接続には**AppBox アカウントでログイン（OAuth）**し、トークンを直接扱う必要はありません。

ユーザー向けの案内（Claude · Claude Code · Codex · Cursor との接続、接続画面の見方、トラブルシューティング）は AppBox ガイド › 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 がブラウザーで AppBox のログイン・許可画面を開きます。トークンは 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. 接続（AppBox にログイン）

1. Claude Code のセッションで /mcp → plugin:appbox:appbox サーバーを選択し、Authenticate をクリックします。
2. ブラウザーで AppBox コンソールが開いたらログインします（すでにログイン済みの場合はスキップされます）。
3. 許可画面で権限と許可するアプリ（すべてまたは選択したもの）を確認し、外部 AI への送信に関する告知に同意してから、許可をクリックします。
   • アプリ名の下にある識別表示を確認してください — 「claude.ai で確認済みのアプリ」 · 「AppBox に登録済みのアプリ」 · 「確認されていないアプリ」。「確認されていないアプリ」で、自分で開始した接続でない場合は拒否してください。
4. ブラウザーに完了画面が表示されたら、Claude Code に戻ります。/mcp で connected に変わります。

以降はスキルを使います。

こんなとき	スキル
「AppBox からプッシュを送信したいです」「何から始めればよいですか」	/appbox:onboarding [アプリコード]
「FCM の登録方法を教えてください」	/appbox:setup-fcm [アプリコード]
「プッシュが届きません」	/appbox:check-setup [アプリコード]

ツールの完全な名前は mcp__plugin_appbox_appbox__appbox_list_apps の形式です（権限ルールで使う場合はこの名前を使用します）。

• 接続の確認・解除：AppBox コンソールのアカウント設定 › MCP 接続。解除するとすぐに切断され、再び使うには手順 2 をやり直します。
• AI アプリで AppBox サーバー（コネクター）だけを削除しても、AppBox 側の接続は残ります。切断するにはコンソールで解除してください。
• 許可するアプリ：接続時にチェックしたアプリのみ参照できます（「すべてのアプリ」は、その時点の一覧からすべて選択する設定です）。接続後に作成したアプリを使うには、コンソールのアカウント設定 › MCP 接続にある「許可するアプリを変更」でそのアプリにチェックを入れて保存します — 再接続する必要はなく、次のリクエストから適用されます。
• パスワードを変更またはリセットすると、すべての MCP 接続が解除されます（コンソールの通知でお知らせします）。
• 30 日間使用されていない接続は自動的に解除されます。再び使うには、もう一度ログインします。

3. ほかの AI アプリに接続

どのアプリでもアドレスだけを入力すれば、初めて使うときに AppBox のログイン画面が開きます。トークンは入力しないでください。アプリごとの画面案内はガイドをご覧ください。

アプリ	接続
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

ログインせずにガイドだけを利用（ドキュメントの入口）

AppBox アカウントがなくても、公開ガイド・例・サーバー API 仕様を検索できます（ドキュメントツールのみで、ログイン画面は表示されません）。AppBox にログインして接続する場合（/api/mcp）にはすでに含まれているため、別途追加する必要はありません。

claude mcp add --transport http appbox-docs https://mcp.appboxapp.com/docs

• 呼び出し回数の制限：IP あたり毎分 60 回、1 回につきメッセージ 1 つ（バッチ不可）。
• codex mcp add の実行時に Codex がログイン画面を表示することがあります（閉じても動作します）。表示させたくない場合は、~/.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（その他）	アカウント停止など — appbox カスタマーサポートにお問い合わせください
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 にマージ · 3 つのマニフェスト（.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。appbox サービスの利用には、サービス利用規約およびプライバシーポリシーが適用されます。