AIエージェントがステーブルコインでギフトカードを購入する方法

AIエージェントがステーブルコインでギフトカードを購入する方法

ほとんどのAPI統合は、どこかに人間がいることを前提としています。これらはアカウント、OAuthフロー、事前発行されたキー、チェックアウトUIに基づいて構築されており、最近まで、何かを購入する必要があるソフトウェアは自分自身でそれを行うクリーンな方法がありませんでした。

しかし、これは変わりつつあります。人々が「エージェンティックコマース」と呼んでいるのは、自律的なソフトウェアが商品を発見し、価格を設定し、購入することができるパターンであり、人間が各ステップを確認するのを待つ必要がありません。これは、エージェントが事前登録せず、セッショントークンを保持せず、誰も支払い画面にリダイレクトしないという点で、従来のAPI統合とは根本的に異なるモデルです。

ギフトカードはここに自然にフィットします。デジタルであり、即座に発行可能で、購入者側での配送や本人確認を必要としません。この記事では、インフラストラクチャがどのように機能し、どのように接続するかを説明します。
 

理解すべき3つのプロトコル

MCP（モデルコンテキストプロトコル）

MCPは、AIモデルが外部ツールを呼び出すことを可能にするレイヤーです。あなたのコードがAPIに直接アクセスするのではなく、エージェントが名前付きツールを呼び出し、MCPサーバーがそれを適切なリクエストに変換し、結果がモデルが推論できる形式で返されます。ギフトカードの購入においては、エージェントがsearchProducts、getProductPrice、validateOrder、createOrderを生のHTTP呼び出しではなく自然なツール呼び出しとして行えることを意味します。

CryptorefillsのMCPサーバーはapi.cryptorefills.com/mcpで公開されており、/.well-known/mcp.jsonマニフェストを介して自動発見可能です。これにより、ClaudeやChatGPTなどのMCP対応クライアントは、カスタムグルーコードなしで接続できます。詳細はMCP統合ガイドをご覧ください。
 

x402（HTTPネイティブペイメント）

x402は、長い間休眠していたHTTP 402ステータスコードを再活性化するオープンな支払い標準です。フローは次のように機能します：エージェントがリソースにリクエストを行い、サーバーが402 Payment Requiredと価格、受け入れられる資産、ターゲットアドレスを指定した機械可読ペイロードで応答します。エージェントはEIP-712（EVMチェーン上）またはSolanaの同等のものを使用して支払い承認に署名し、次にX-PAYMENTヘッダーを付けてリクエストを再試行します。アカウント作成、OAuth、事前資金提供されたAPIキーは不要です。

特にcryptorefills-x402スキルでは、資産はBase上のUSDCで、支払いはEIP-712署名された転送を介してガスレスです。
 

REST API

MCPツール呼び出しではなく直接統合を希望するビルダー向けに、Cryptorefills REST APIは完全な注文ライフサイクルをカバーします。/v2/brandsおよび/v5/products/countryを介したカタログブラウジング、/v4/products/priceを介したジャストインタイム価格設定、/v5/orders/validationsを介した注文検証、/v5/ordersを介した注文作成、ストリーミングまたはポーリングを介した作成後の追跡が含まれます。

カスタムエージェントフレームワーク、Telegramミニアプリ、またはウォレット埋め込みチェックアウトを構築し、リクエストフローを完全に制御したい場合は、これが正しい道です。完全なエンドポイントドキュメントはapi-docsにあります。
 

ステップバイステップ：AIエージェントがSolana上のUSDCで$50のAmazonギフトカードを購入する

以下は、Cryptorefills MCPサーバーがインストールされたClaude Desktopを使用して、完全な自律購入がどのように見えるかの例です。

ステップ1：MCPサーバーをClaude Desktopに追加

claude_desktop_config.jsonに次を追加します：
 

{  "mcpServers": {    "cryptorefills": {      "url": "https://api.cryptorefills.com/mcp/http",      "transport": "http",      "headers": {        "User-Agent": "Cryptorefills-MCP/1.0"      }    }  }}

transport: "http"フィールドは、ストリーミング可能なHTTPを使用しており、各ツール呼び出しのために新しいプロセスを生成することなく、マルチステップの購入フローを通じて接続がオープンのままになります。カタログおよび価格操作のためにヘッダーにAPIキーは必要ありません。
 

ステップ2：エージェントがsearchProductsを呼び出す

{  "tool": "searchProducts",  "input": {    "query": "Amazon",    "country": "US",    "category": "gift_cards"  }}

サーバーは、ID、利用可能な額面、サポートされている支払いレールを持つ一致する製品のリストを返します。
 

ステップ3：エージェントがgetProductPriceを呼び出す

{  "tool": "getProductPrice",  "input": {    "product_id": "amazon-us-50",    "currency": "USDC",    "network": "solana"  }}

これにより、現在のレートでの$50のUSDC相当額と、見積もりの有効期限が返されます。価格はジャストインタイムで取得されるため、エージェントは古いレートで支払うことはありません。
 

ステップ4：エージェントがvalidateOrderを呼び出し、その後createOrderを呼び出す

検証が最初に実行されるため、エージェントはコミットする前に配送先住所や製品の可用性の問題をキャッチできます。成功した場合：
 

{  "tool": "createOrder",  "input": {    "product_id": "amazon-us-50",    "currency": "USDC",    "network": "solana",    "delivery_email": "user@example.com"  }}

ステップ5：注文応答

{  "order_id": "cr_ord_9f3a12b",  "status": "awaiting_payment",  "payment": {    "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA7SjTBRet7vQ9z",    "amount": "50.23",    "currency": "USDC",    "network": "solana",    "expires_at": "2026-04-23T14:35:00Z"  },  "product": {    "name": "Amazon Gift Card",    "denomination": 50,    "currency": "USD"  }}

支払いが有効期限内にアドレスに到着すると、注文のステータスは完了に移行し、バウチャーが配信されます。エージェントは/track-order-streamエンドポイントを介してステータス更新をストリーミングするか、ポーリングにフォールバックできます。
 

エージェントが実際にこれを使用している理由

ウォレットマーケットプレイスボット。ユーザーがボットに希望するブランドを伝えます。ボットはUSDC価格を見積もり、実行し、配信状況をウォレットインターフェース内でストリーミングします。

Telegramミニアプリアシスタント。エージェントがブランド検索、額面選択、支払い検証を処理する会話型購入フローで、二重注文を防ぐためのガードレールがあります。

DAO報酬エージェント。オンチェーンガバナンスへの参加、コミュニティ貢献、またはバウンティの完了が、財務ウォレットから自律的に発行されたギフトカードバウチャーで報酬されます。

財務支出ヘルパー。共有のステーブルコイン財務から支出するチームは、手動のフィアットオフランプステップなしで、制御された監査可能なギフトカード調達を自動化できます。

エージェントが人間に報酬を発行するインセンティブロジックについての詳細は、AIがギフトカードを購入し始めるときをご覧ください。
 

なぜ自分で支払いレイヤーを構築しないのか

魅力的な代替案は、支払いプロセッサ、ギフトカードAPI、フィアットオフランプを自分で組み合わせることです。実際には、第三者プロバイダーとの事前資金提供された残高を管理し、ギフトカードの可用性に関する地理的制限をナビゲートし、フィアットレールの遅延と複雑さを吸収し、自分自身のカタログ同期を維持することを意味します。

Cryptorefillsはそれらすべてを取り除きます。事前資金提供は不要で、重要な経路でのフィアット変換はなく、カタログは6,600以上のブランドを180以上の国でカバーしており、エージェントがsearchProductsを呼び出す瞬間に利用可能です。AIエージェントページには、利用可能なスキルと接続オプションの完全な概要があります。
 

よくある質問

Claudeはギフトカードを購入できますか？

はい。ClaudeはClaude DesktopおよびClaude Codeを介してMCPをネイティブにサポートしています。設定にCryptorefills MCPサーバーを追加すれば（上記のスニペットを参照）、Claudeはカタログを検索し、ライブ価格を取得し、単一の会話で注文を検証し作成できます。カタログアクセスと価格設定には別途APIキーやアカウントは必要ありません。
 

x402とは何ですか？

x402は、サーバーが価格と受け入れられる支払い方法を宣言できるようにHTTP 402ステータスコードを再利用するオープンなHTTP支払い標準です。自律エージェントにとって、これは事前登録されたアカウントやOAuthトークンなしで購入を行うことを意味します。cryptorefills-x402スキルは、完全自律的な購入のためにこれを実装しています。
 

AIエージェントはどのようにお金を使いますか？

エージェントには3つのものが必要です：資金提供されたウォレット（通常はUSDCやUSDTなどのステーブルコインを保持）、外部サービスを呼び出す方法（MCPツール呼び出しまたは直接API呼び出し）、および取引時に人間を必要としない支払いメカニズムです。x402は、HTTP内に支払いハンドシェイクを埋め込むことで最後の部分を処理します。x402やMCPのようなものがなければ、エージェントは注文を準備できますが、自分自身で支払いを完了することはできません。
 

ギフトカード用のMCPサーバーはありますか？

はい。Cryptorefillsは、カタログ検索、価格設定、注文検証、注文作成、配信追跡のためのツールを処理するMCPサーバーを公開しています。これは、ClaudeやChatGPTなどのMCP対応クライアントと連携して機能します。
 

始める

6,600以上のギフトカードブランドに接続し、180以上の国で利用可能です。KYC不要。事前資金提供不要。

MCPサーバーをClaude Desktop、Claude Code、または任意のMCP対応エージェントランタイムに直接追加します。
 

npx skills add cryptorefills/agents

AIエージェントページを開いて、3つのスキル、x402スキルの設定、およびサポートされている支払いネットワークの完全なリストを確認してください。