MCP：AI アシスタントを接続する
MCP により、AI アシスタントは Fox Store の接続を使ってアプリを照会し、ストア情報を管理し、実装済みのアップロード・公開操作を実行できます。MCP は Engine の業務機能を呼び出し、CLI は CI/CD の公開自動化に使います。同じ内核を使いますが、公開するツールの範囲は異なります。
有効化と準備
- 最新版をインストールし、ライセンスを有効化して Provider 接続を追加します。
- 設定 → MCP で MCP を有効にします。スイッチは即時保存され、再起動後も維持されます。権限やタイムアウトを変更したら保存を押します。
- 権限管理で接続範囲、実行権限、ツールを確認します。
- 接続方法からクライアント設定をコピーし、AI クライアントに追加して MCP を再接続します。
ネイティブ実行ファイルは同梱されており、Node.js や別の MCP プラグインは不要です。クライアントがローカル stdio で独立プロセスを起動します。初期化後はデスクトップを開いたままにする必要はありません。ライセンスリースの期限切れ時はデスクトップで更新します。
AI クライアントの設定
Codex には生成された TOML を使います。Claude Code などのローカルクライアントでは、生成された JSON を参考にそのクライアントの形式で設定します。他人のパスではなく、設定画面に表示された実行ファイルの絶対パス、引数、データディレクトリを使用してください。
フォームでは起動コマンドを別に入力し、--data-dir とディレクトリのパスを別々の引数にします。引用符、カンマ、配列全体を一つの引数に貼り付けないでください。Linux AppImage では --mcp が含まれる場合もあります。生成された設定をすべて保持してください。Provider の秘密情報をクライアント設定に入れる必要はありません。
互換性はクライアントのローカル stdio MCP 対応によります。GLM、DeepSeek、Gemini などのモデルには対応クライアントが必要です。リモート URL のみ受け付ける Web・クラウド製品から本機のプログラムを直接起動することはできません。現在 HTTP サービス URL は提供していません。
権限とツールの範囲
| 権限 | 許可される操作 |
|---|---|
| 読み取り専用（既定） | 接続、アプリ、バージョン、状態などの照会。プラットフォームのデータは変更しません。 |
| コンテンツ管理 | 読み取りと文章・素材の更新。審査提出、公開、削除、アカウント権限変更は含みません。 |
| 公開管理 | コンテンツ管理に加え、対応ツールによる審査提出、公開、削除、価格、配信、アカウント権限などの変更。 |
既定では今後追加する接続を含むすべての接続が許可されます。接続を限定し、接続ごとに既定権限を上書きできます。ツールは既定で選択され、手動で外した選択は保持されます。グループの数値は「有効なツール / 総ツール数」であり、プラットフォームのメニュー数ではありません。展開すると各ツールと必要権限を確認できます。
接続範囲、ツールスイッチ、実行権限、プラットフォームのアカウント権限がすべて適用されます。ツール選択だけでは書き込み権限は得られません。権限を上げても未実装の機能は増えません。呼び出しごとのデスクトップ承認はありませんが、AI クライアントが別途確認する場合があります。結果はクライアントのモデルサービスに送信されることがあります。
質問例
- 「この App Store 接続のアプリ、最新バージョン、中国語の説明を列挙し、不足情報を明示して」
- 「この Google Play アプリのテスト Track と公開状態を調べて」
- 「指定アプリの中国語のストア説明をこの文章に更新して」
- 「このローカルパッケージを事前検証し、指定接続のテストチャネルにアップロードして」
接続、アプリ、言語、チャネルを指定します。アカウントから見えるデータのみ取得でき、未対応機能や権限不足はエラーになります。アップロード成功は審査通過や公開を意味しません。パイプラインは CLI / API を参照してください。
画像とローカルファイル
生成画像を MCP が動くコンピューターに保存し、絶対パスと対象アプリを渡します。クラウドチャットの画像やサンドボックスのパスは本機から読めるとは限りません。ファイルの不存在、アクセス権、形式の問題はエラーに従って修正します。
操作はプラットフォームとツールによって異なります。ストア画像とパッケージ内のアイコンは別物です。Apple のメインアプリアイコンは新しいビルドに含めてアップロードする必要があり、公開済みアプリのアイコンを画像だけで直接置換することはできません。
接続・呼び出しのトラブル対処
- ツールがない・古いツールだけ： スイッチ、選択、保存状態を確認し再接続します。更新後は古い MCP プロセスを終了して再接続します。
- 起動できない： 実行ファイル、引数の分割、古いインストールパスを確認し設定を再コピーします。「プログラム準備完了」はファイルの存在を示し、接続済みを意味しません。
- MCP_POLICY_INVALID： Fox Store を更新し、設定でポリシーを再読込・保存して再接続します。続く場合はエラーを残し、認証情報データベースを削除しないでください。
- 接続・認証情報を利用できない： データディレクトリと接続を確認し、デスクトップで接続と OS の認証情報ストアへのアクセスを確認します。異なる OS ユーザー間で認証情報を直接共有できません。
- ライセンス・権限・タイムアウト： ライセンス更新と必要権限・プラットフォーム権限を確認します。長時間処理ではクライアント側のタイムアウトも調整します。書き込み結果不明の場合は再実行前にプラットフォームの状態を確認します。
最近の呼び出しにはツール、結果、所要時間が表示されます。Provider 接続 と トラブルシューティング も参照してください。