MCP 経由で Payhip を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Payhip をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Payhip + Gemini

AI エージェントから Payhip ストアのクーポンコードを管理し、ソフトウェアのライセンスキーを確認します。クーポンの一覧表示と詳細確認、あなたの承認による新規作成、購入者のライセンスキーの検証に加え、許可すればキーの無効化、再有効化、アクティベーション数の管理もできます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

PAYHIP_API_KEY

ステップ 1 — 認証情報を取得

セットアップは約 2 分です。Payhip ストアとその API キーが必要です。ライセンスキーを扱うには、ライセンスキーを有効にした商品も必要です。

1. Payhip で Settings → Developer を開き、API key をコピーします。
2. キーだけを PAYHIP_API_KEY に貼り付けます。クーポン関連のツールがこれを使います。
3. 任意（ライセンスキー用）: Payhip で商品を開き、まだオンでなければ Generate unique license keys にチェックを入れ、そのチェックボックスの下に表示される product secret key を PAYHIP_PRODUCT_SECRET_KEY にコピーします。
4. コネクターをインストールし、payhip_list_coupons を実行します。クーポンコードが一覧表示され、API キーが有効であることを確認できます。product secret key を設定した場合は、購入者が受け取ったキーで payhip_verify_license を実行し、ライセンス側も確認してください。

インストールごとにライセンス商品は 1 つ: product secret key は 1 つの商品に属します。複数の商品のキーを確認するには、商品ごとにコネクターをインストールし、それぞれに商品名を付けてください。クーポンはストアの API キーを使うため、どのインストールでも使えます。

読み取れるデータ: ストアのクーポンコード（コード、種類（1 商品、全商品、1 コレクション）、割引率または割引額、開始日と終了日、最低購入額、利用上限、メモ）。そして設定した商品について、ライセンスキーの状態（有効かどうか、購入者のメールアドレス、商品とバリエーション、使用回数、発行日時）です。

クーポンとライセンスキーだけ: 現在の Payhip API が対応しているのはこの 2 つの領域だけです。商品、売上、顧客、入金は API から取得できません。

データの読み方: 金額（割引額、最低購入額）はセント単位で、割引率はパーセントです。payhip_verify_license が空の結果を返した場合、そのキーはこの商品に存在しません。購入が返金されると、Payhip はキーを自動的に無効にします。キーの使用回数はあなたのソフトウェアが増減させるカウンターで、Payhip は上限を強制しません。上限はソフトウェア側で管理します。

インストール時はオフ: payhip_create_coupon、payhip_disable_license、payhip_enable_license、payhip_increase_license_usage、payhip_decrease_license_usage。新しいクーポンは作成した瞬間からチェックアウトで使え、無効化したキーは再び有効にするまで購入者がソフトウェアを使えなくなります。サブスクリプション商品には API でクーポンを付けられません。必要なものは管理者が有効にします。

変更の前に必ず確認: 書き込みツールが有効な場合、AI はコード、割引内容、対象範囲、または対象のライセンスキーとそのキーに行う操作を示し、あなたの承認を待ちます。

制限: クーポンの一覧は最大 100 件ずつのページで返ります。クーポンが多いストアでは、AI は一度に全件を求めず、ページごとに取得します。

よくあるエラー: 401 の authentication_fail は、API キーまたは product secret key が間違っているか、設定されていないことを示します。Settings → Developer から PAYHIP_API_KEY をもう一度コピーし、ライセンス関連のツールでは商品ページで PAYHIP_PRODUCT_SECRET_KEY を確認してください。Payhip のファイアウォールはデータセンターのアドレスからのクーポン関連の呼び出しにチャレンジをかけるため、プロキシが設定されている環境（AnythingMCP Cloud など）では、クーポンの呼び出しは AnythingMCP の送信用プロキシを経由します。CONNECTOR_PROXY_URL のないセルフホストのサーバーでは、クーポンの呼び出しが HTML ページ付きの 403 を返すことがあります。

このコネクターは、商品、売上、顧客、入金の読み取りは行わず、返金や新しいライセンスキーの発行も行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Payhip のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「ライセンスキー 7XK2-9QPL-44MZ-H1TR は有効ですか。購入者は誰で、何回使われていますか。」
• 「クーポンコードを割引内容付きで一覧にして、今月で期限が切れるものを教えてください。」
• 「『AUTUMN20』クーポンの条件を教えてください。最低購入額、利用上限、対象商品はどうなっていますか。」
• 「返金のあとでキーが使えなくなったと購入者が言っています。まだ有効かどうかと、どのメールアドレスのキーかを確認してください。」
• 「全商品に使えるクーポンはどれで、1 つの商品やコレクションだけが対象のクーポンはどれですか。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続