トラブルシューティング

API、CLI、MCPで共通して発生するGMCのエラーレスポンス、その原因、解決方法です。

GMCのREST API、CLI、MCPの各サーフェスは、同じエラー形式とエラーコードを共有 しています。このページでは、遭遇する可能性が最も高いコードと、それぞれの解 決方法を説明します。

エラーレスポンスの形

REST APIとMCPプロキシから返されるすべてのエラーレスポンスは、同じJSON形式に 従います。

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Human-readable description",
    "param": "optional_field_name",
    "requestId": "req_..."
  }
}

paramは、エラーを特定のリクエストフィールドに紐づけられる場合に含まれま す。requestIdは常に含まれ、サポートへの問い合わせ時にはこれを伝えること で、サーバー側のログからリクエストを特定できます。

エラーコード

QUOTA_EXCEEDEDとRATE_LIMITEDはどちらもHTTP 429ですが、意味する問題は異 なります。前者は月間クレジット枠が尽きたことを、後者は残りクレジットとは 無関係な短時間バーストのガードであることを示します。

一覧のページングより集計を優先する

個々のゲームレコードではなく、件数、合計、分布が必要な場合は、一覧エンドポ イントで全件をページングするのではなく、集計または件数取得系のエンドポイ ントを使ってください。集計はクレジット消費が少なく、母集団に忠実な回答が 得られます。一方、大きな一覧を最後までページングするのは、同じ質問に対し てより遅く、より高コストです。

CLI: gmcエイリアスがzshのgitプラグインと衝突する

一部のzsh設定(例えば特定のoh-my-zshのgitプラグイン)は、GMC CLIバイナリを覆 い隠すgmcという名前のシェルエイリアスを定義します。gmcの実行結果が想定 と異なる場合は、type gmcやwhich gmcで既存のエイリアスの有無を確認して ください。CLIはgmcpというエイリアスでもインストールされており、こちらは 衝突を避けられます。お使いのシェルで短い名前が既に使われている場合は、 gmcの代わりにgmcpを使ってください。

CLI: gmc loginが非JSONレスポンスで失敗する

gmc loginはブラウザベースのOAuthフローを開き、コールバック時にJSONレスポ ンスを期待します。代わりに非JSONまたはHTMLレスポンスで失敗する場合は、企業 のプロキシやネットワークアクセスゲートウェイがコールバックリクエストを横取 りまたは書き換えている可能性があります。そうした介入のないネットワーク (例えば社内VPNやプロキシの外)からログインフローを試すか、コールバックドメ インを変更せず通過させるようネットワーク管理者に相談してください。

サポートを受ける

上記のいずれでも解決しない場合は、 gamemarketcopilot.com/contactから お問い合わせください。その際、エラーレスポンスに含まれるrequestIdを添え ていただくと、リクエストを追跡できます。