MCP サーバー

Aptoide Connect MCP サーバーは、Claude、Gemini、ChatGPT、またはその他の MCP クライアントといった AI アシスタントを Aptoide Connect アカウントに直接接続します。これにより、API 呼び出しを記述したりコンソールのレポートを操作したりする代わりに、自然な言葉でデータについて質問できます。

• 「先月、私のアプリはどれくらいの収益を上げましたか?」
• 「インストール数が最も多い国はどこですか?」
• 「このウォレットトランザクションが失敗した理由は何ですか?」

対象ユーザー

アプリ統計、ウォレットのアクティビティ、アプリ内商品カタログ、または Aptoide Connect ドキュメントを対話形式で確認したいすべての Aptoide Connect 開発者が対象です。代表的なユースケースは以下のとおりです。

• 「過去 30 日間の [アプリ] の収益はいくらでしたか?」
• 「[アプリ] のインストール数を最も牽引している国はどこですか?」
• 「今月、すべてのアプリを合わせたウォレットの残高はいくらですか?」
• 「トランザクション [id] で何が起きましたか?」
• 「[アプリ] にはどのようなアプリ内商品があり、価格はいくらですか?」
• 「[アプリ] に新しい消費型商品を作成してください。sku、価格、ストアの掲載情報はこちらです。」
• 「[sku] の価格を EUR 1.99 に引き上げてください。」
• 「アプリ内購入が完了しません。Billing SDK のログはこちらです。何が問題ですか?」
• 「このエンドポイントが 402 を返すのはなぜですか?」

前提条件

• 有効なサブスクリプションを持つ Aptoide Connect 開発者アカウント。
• 開発者コンソールの API キーで生成した API キー。必要な認証情報はこれのみで、MCP 専用の登録は別途必要ありません。
• Claude、Gemini、ChatGPT など、OAuth 対応のリモートサーバーをサポートする MCP クライアント。

AI アシスタントの接続

認証は OAuth のみです。リモートサーバーの追加方法は MCP クライアントごとに異なるため、カスタム MCP サーバーやコネクタを設定する場所については、ご利用のクライアントのドキュメントを確認してください。どのクライアントを使用する場合でも、フローは同じです。

1. MCP クライアントで URL を指定してサーバーを追加します: https://mcp.connect.aptoide.com

   ⚠️

   /mcp サブパスを付けずに、そのままの URL を使用してください。https://mcp.connect.aptoide.com/mcp は 404 を返します。

2. クライアントがブラウザを開き、Aptoide Connect がホストする同意ページが表示されます。

3. そのページに Aptoide Connect の API キーを貼り付け、承認をクリックします。
4. キーが受け付けられると、クライアント上で接続が有効として表示されます。

🌏

中国から MCP サーバーを使用する場合

中国本土から接続している場合、MCP サーバーへの到達や OAuth フローの完了が困難なことがあります。その場合は、VPN に接続した状態で接続をお試しください。

以下のタブでは、最も一般的なクライアントについて説明します。OAuth 対応のリモートサーバーをサポートするその他の MCP クライアントも、そのクライアントが MCP サーバー設定を保持している場所で設定すれば、同じ方法で接続できます。

Claude

Claude

1. claude.ai で設定 → コネクタを開き、カスタムコネクタを追加を選択します。
2. URL として https://mcp.connect.aptoide.com を入力し、OAuth クライアント ID とシークレットは空欄のままにします。
3. 接続をクリックし、同意ページを完了します。

Anthropic のリモート MCP を使用したカスタムコネクタに関するガイドを参照してください。

Claude Code

1. サーバーを追加します。

claude mcp add --transport http aptoide-connect https://mcp.connect.aptoide.com

2. セッション内で /mcp を実行し、aptoide-connect を選択して、Authenticate を選択します。

Claude Code の MCP ドキュメントを参照してください。

ChatGPT

ChatGPT

1. 設定 → コネクタ → 詳細設定で、開発者モードを有効にします (カスタム MCP コネクタに必須で、有料プランで利用可能です)。
2. MCP サーバー URL として https://mcp.connect.aptoide.com を、認証方法として OAuth を指定し、新しいコネクタを追加します。
3. 同意ページが開いたら完了します。

OpenAI の ChatGPT のコネクタに関するガイドを参照してください。

Codex

最近のバージョンの Codex は、OAuth 対応のリモート MCP サーバーをサポートしています。

1. ~/.codex/config.toml の mcp_servers セクションに、URL として https://mcp.connect.aptoide.com を指定してサーバーを追加します。
2. CLI から OAuth ログインを完了します。

ご利用のバージョンに応じた正確な設定については、Codex のドキュメントを参照してください。

Gemini

Gemini

Gemini のウェブアプリは現在、カスタム MCP コネクタをサポートしていません。Gemini CLI を使用してください。

Gemini CLI

1. ~/.gemini/settings.json (またはプロジェクトレベルの .gemini/settings.json) にサーバーを追加します。

{
    "mcpServers": {
        "aptoide-connect": {
            "httpUrl": "https://mcp.connect.aptoide.com"
        }
    }
}

2. Gemini CLI セッションで /mcp auth aptoide-connect を実行し、開いた同意ページを完了します。/mcp を実行すると、設定済みのすべてのサーバーの接続状態をいつでも確認できます。

Gemini CLI の MCP ドキュメントを参照してください。

Qwen

Qwen

Qwen のウェブアプリは現在、カスタム MCP コネクタをサポートしていません。Qwen Code を使用してください。

Qwen Code

Qwen Code は Gemini CLI と同じ方法で設定します。

1. ~/.qwen/settings.json にサーバーを追加します。

{
    "mcpServers": {
        "aptoide-connect": {
            "httpUrl": "https://mcp.connect.aptoide.com"
        }
    }
}

2. セッションから認証を行い、同意ページを完了します。

Kimi

Kimi

Kimi のウェブアプリは現在、カスタム MCP コネクタをサポートしていません。Kimi Code を使用してください。

Kimi Code

1. OAuth 認証を指定してサーバーを追加します。

kimi mcp add --transport http --auth oauth aptoide-connect https://mcp.connect.aptoide.com

2. 認証を行います。ブラウザで同意ページが開きます。

kimi mcp auth aptoide-connect

セッション内で /mcp を実行すると、接続済みのサーバーとそのツールが表示されます。Kimi Code CLI の MCP ドキュメントを参照してください。

DeepSeek

DeepSeek

DeepSeek のウェブアプリは現在、カスタム MCP コネクタをサポートしていません。DeepSeek Harness を使用してください。

DeepSeek Harness

DeepSeek のオープンソースエージェントランタイムである DeepSeek Harness (dsh) は、@deepseek-ai/dsh-mcp-client プラグインを通じてリモート MCP サーバーに接続します。ただし、このクライアントは静的なヘッダーを渡すのみで独自の OAuth フローを持たず、本サーバーは OAuth を必須としています。Harness が OAuth をサポートするまでは、DeepSeek のファーストパーティツールから本サーバーに接続することはできません。DeepSeek のモデルで本サーバーを使用するには、OAuth をサポートし、モデルを選択できる MCP クライアントを使用してください。

利用可能なツール

各ツールは 1 つの Aptoide Connect API エンドポイントに対応し、そのエンドポイントのレスポンスをそのまま返します。

ツール	機能	アクセス
search_documentation	製品に関する質問に回答します。パラメーターが受け付ける値、制限値、エラーコードの意味などです。	読み取り専用
list_available_applications	アカウント上のアプリ、その正確なパッケージ名、および各アプリがサポートする統計を一覧表示します。	読み取り専用
get_application_statistics_chart	指定した期間における 1 つのアプリの収益、インストール数、またはダウンロード数を取得します。	読み取り専用
get_application_statistics_top	1 つのアプリの収益、インストール数、またはダウンロード数を、国別またはパートナー別にランク付けします。	読み取り専用
list_application_statistics_reports	1 つのアプリの月次パフォーマンスレポート CSV を取得します。ダウンロードリンク、またはレポートの内容そのもので、1 回の統計呼び出しでは対応できない期間に使用します。	読み取り専用
get_wallet_transactions_totals	指定した期間における、すべてのアプリを合計したウォレット金額 (収益、クレジット、デビット) を取得します。	読み取り専用
list_wallet_transactions	金額、手数料、ステータス、支払い方法、国を含む個々のウォレットトランザクションを一覧表示します。	読み取り専用
get_wallet_transaction_details	特定の 1 つのウォレットトランザクションの詳細を取得します。	読み取り専用
list_wallet_transaction_reports	月次ウォレットトランザクションレポート CSV を取得します。生データのダウンロードリンク、またはその内容です。	読み取り専用
list_application_consumables	アプリのアプリ内商品を、id、sku、ステータス、価格とともに一覧表示します。	読み取り専用
get_application_consumable	1 つのアプリ内商品の詳細を、設定されているすべての価格とロケールを含めて取得します。	読み取り専用
add_application_consumable	新しいアプリ内商品を作成します。	書き込み — 本番の商品を作成します。商品は削除できないため、誤って作成した場合は INACTIVE に設定することしかできず、削除はできません。
update_application_consumable	アプリ内商品を編集します。指定したフィールドのみが変更されます。存在しない id を指定した場合は、何も作成せずに明確に失敗します。	書き込み — 現在販売中の可能性がある本番の商品を変更するため、不注意な価格やロケールの編集は購入者に即時に反映されます。
analyze_billing_sdk_transaction	1 つの Billing SDK トランザクションとそれに関連する購入を照会し、そのステータスの意味と次に行うべきことを説明します。	読み取り専用
analyze_billing_sdk_logs	Billing SDK のログ出力をログアナライザーで処理し、含まれるフローとエラーを特定します。ログはそのまま貼り付けてください。アナライザーは生の行に対してマッチングを行います。	読み取り専用

⚠️

書き込みと表示されたツールは、本番の Aptoide Connect データに実際の変更を加え、その一部は元に戻すことができません。確認する前に、アシスタントが実行しようとしている内容を確認してください。

プライバシー

MCP サーバーは、Aptoide Connect API 上の薄いステートレスなレイヤーです。お客様のデータにとっては以下のことを意味します。

• API キーは保存されません。 API キーは AI クライアントが保持する OAuth トークンに暗号化されて格納され、各リクエストを処理するためにメモリ上でのみ復号されます。データベースへの書き込み、ログへの記録、アシスタントへの公開は一切行われません。
• 会話内容は参照されません。 サーバーが受け取るのは、アシスタントが明示的に行うツール呼び出しのみで、その前後のチャット内容は受け取りません。Billing SDK のログなど、意図的にツールに渡したコンテンツは、その呼び出しに応答するために処理されます。
• API リクエストは、他の API トラフィックと同様にログに記録されます。 各ツール呼び出しは 1 つの Aptoide Connect API リクエストとなり、そのメタデータ (エンドポイント、パラメーター、レスポンスステータス、アカウント) はクォータとサービス指標のために 30 日間保持されます。これは直接の API 呼び出しと同じ扱いです。
• 結果がアシスタントに届いた後の取り扱いは、ご利用の AI プロバイダーのプライバシーポリシーに従います。 これはアシスタントとの会話におけるその他すべての内容と同じです。

Aptoide Connect によるデータの一般的な取り扱いについては、プライバシーポリシーおよび利用規約を参照してください。

FAQ

AI アシスタントが API キーを参照することはありますか? いいえ。キーは同意ページで HTTPS 経由で一度入力するだけで、チャット内で入力することはありません。キーは MCP サーバーのみが開ける暗号化トークンに封印されるため、アシスタントも AI プロバイダーも、使用可能な形式でキーを保持することはありません。

接続を解除したりアクセスを取り消したりするにはどうすればよいですか? 使用した API キーを無効にします。開発者コンソールの API キーページで、該当キーの有効トグルをオフにしてください。そのキーで確立されたすべての接続は即時に停止し、必要になれば後でキーを再度有効にできます。クライアント側でコネクタを削除する方法も有効ですが、確実なのはキーを無効にすることです。

接続後、アシスタントは何を参照できますか? API キーが属するアカウントについて、このページに記載されたツールが公開するもののみです。アカウントのアプリ、その統計とレポート、ウォレットのアクティビティ、アプリ内商品カタログ、Billing SDK トランザクションの照会、およびこのドキュメントです。アカウント上のその他の情報には到達できません。設定、ユーザー、提出物、その他上記に記載のないもののためのツールはなく、他のアカウントに到達する方法もありません。

アカウント上の内容を変更できますか? はい。アプリ内商品の作成と編集が可能で、書き込み操作はこれらのみです。その他はすべて読み取り専用で、何かを削除する方法はありません。MCP クライアントは書き込みツールを実行する前に承認を求めるため、気づかないうちに何かが変更されることはありません。

収益の数値がウォレット残高と一致しないのはなぜですか? 収益ツールはデフォルトで amountType: wallet を使用します。これは VAT と収益分配を差し引いた後の受取額です。amountType: global は VAT を含む消費者の総支出額で、両者の差は購入者の国によって変動します。数値がおかしいと感じた場合は、まずどちらの値が示されているかを確認してください。

どのくらい過去まで質問できますか? 統計は過去 6 か月をカバーし、1 回の質問あたり最大 120 日です。それより長い期間については、アシスタントは期間制限のない月次レポートに切り替えます。ウォレットトランザクションは約 24 か月前まで遡れます。

「Active account subscription required」と表示されるのはなぜですか? API、したがって MCP サーバーは、アカウントに有効なサブスクリプションがあることを必要とします。402 は、サブスクリプションが存在しないか期限切れであることを意味します。

利用制限はありますか? はい。各エンドポイントにはアカウントごとの日次クォータがあります。クォータに達すると 429 が返され、アシスタントにその旨が伝えられます。クォータは UTC の午前 0 時にリセットされます。

---

アシスタントで回答できない内容についてサポートが必要ですか? Connectoide、Billing SDK アナライザー、およびサポートチームへの直接の連絡方法については、サポートツールを参照してください。