AWS Marketplace API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、AWS Marketplace API リファレンスを参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS Marketplace MCP サーバーについて

AWS Marketplace Model Context Protocol (MCP) は、 AWS Marketplace 検出、評価、研究、提案生成のための AI を活用したツールを提供します。MCP は、AI アシスタントが以下を通じて外部システムとやり取りできるようにする標準化プロトコルです。

すべてのツールはステートレスです。各呼び出しは独立しており、サーバー側の会話状態はありません。

ユースケースの例

AWS Marketplace MCP サーバーを使用する一般的な方法は次のとおりです。

エンドポイント: https://marketplace-mcp.us-east-1.api.aws/mcp

プロトコル: Streamable HTTP (JSON-RPC 2.0) 経由の MCP。すべてのレスポンスは単一の JSON ペイロードです。

認証: 必須ではありません。

使用可能なツール

6 つのツールはすべてステートレスであり、会話コンテキストやセッション管理は必要ありません。完全な入出力スキーマを含むすべてのツール定義は、標準 MCP tools/listエンドポイントを介してプログラムで利用できます。によって返されるスキーマtools/listは、パラメータ名、タイプ、制約の正規の常に最新の信頼できるソースです。

次の表は、各ツールと読み取り専用であるかどうかをまとめたものです。

統合ガイド

AWS Marketplace MCP サーバーと統合するには、ノーコード Claude Connector を使用するか、プログラムによる MCP クライアントを使用するかの 2 つの方法があります。

Claude Connector (推奨)

AWS Marketplace MCP ツールを使用する最も簡単な方法は、 AWS Marketplace Claude の コネクタを使用することです。これにはコーディングや MCP クライアントのセットアップは必要ありません — Claude はツールの検出と呼び出しを自動的に処理します。

セットアップ:

コネクタの動作の詳細については、「コネクタを使用して Claude の機能を拡張する」を参照してください。

プロンプトの例:

MCP クライアント統合

プログラムによる統合またはカスタムエージェントフレームワークの場合は、MCP エンドポイントに直接接続します。

前提条件

開始するには、以下が必要です。

ステップ 1: MCP クライアントを設定する

HTTP トランスポートをサポートする標準 MCP クライアントを使用します。

エンドポイント

https://marketplace-mcp.us-east-1.api.aws/mcp

以下のメソッドがサポートされています。

認証: 認証は必要ありません。HTTP リクエストの認証ヘッダーを省略します。

ステップ 2: ツールを取得して登録する (ツール検出)

すべてのツール定義は、標準の MCP tools/listメソッドを通じてプログラムで利用できます。ツールスキーマは、このドキュメントとは無関係に更新される可能性があるため、これは現在の入出力スキーマを取得するために推奨される方法です。初期化中に を 1 tools/list回呼び出し、返されたツールをエージェントのツールマニフェストまたはシステムプロンプトに登録します。

次の例は、 tools/list リクエストを示しています。

リクエスト:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

レスポンス (省略):

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "get_aws_marketplace_report_guidelines",
        "description": "...",
        "inputSchema": { ... }
      },
      {
        "name": "search_aws_marketplace_solutions",
        "description": "...",
        "inputSchema": { ... }
      },
      {
        "name": "get_aws_marketplace_solution",
        "description": "...",
        "inputSchema": { ... }
      },
      {
        "name": "get_aws_marketplace_related_solutions",
        "description": "...",
        "inputSchema": { ... }
      },
      {
        "name": "research_aws_marketplace_solution",
        "description": "...",
        "inputSchema": { ... }
      },
      {
        "name": "submit_aws_marketplace_feedback",
        "description": "...",
        "inputSchema": { ... }
      }
    ]
  }
}

各ツールエントリにはname、ツール 、使用ガイダンスと例descriptionの詳細、パラメータタイプ、制約、検証ルールinputSchemaの完全な が含まれます。

ステップ 3: テレメトリを設定する

AWS Marketplace MCP では、リクエストの相関とテレメトリのために、ツール呼び出しごとに安定した識別子が必要です。これは認証情報ではなく、診断と分析にのみ使用されます。

カスタム HTTP ヘッダーに識別子を渡します。

Mcp-Session-Id: <stable-id>

HTTP トランスポート

AWS Marketplace MCP は HTTP トランスポートを使用します。このトランスポートでは、サーバーは複数のクライアント接続を処理できる独立した HTTP サービスとして動作します。

主なトランスポート特性は次のとおりです。

必要な HTTP ヘッダー:

Content-Type: application/json
Mcp-Session-Id: <stable-uuid>
MCP-Protocol-Version: 2025-06-18

次の例は、ツール呼び出しのリクエストとレスポンスを示しています。

リクエストの例:

POST /mcp HTTP/1.1
Content-Type: application/json
Mcp-Session-Id: 1868a90c-5b12-4e8a-9f3d-2a1b3c4d5e6f
MCP-Protocol-Version: 2025-06-18

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_aws_marketplace_solutions",
    "arguments": {
      "queries": ["SIEM solutions"]
    }
  }
}

レスポンスの例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"results\":[...],\"next_cursor\":null}"
      }
    ],
    "isError": false
  }
}

ツールの詳細

このセクションでは、各ツールの入力パラメータ、出力形式、使用ガイダンスについて説明します。

get_aws_marketplace_report_guidelines

特定のレポートタイプのワークフロー手順と出力形式テンプレートを返します。レコメンデーション、比較、または評価ワークフローの場合は、最初にこれを呼び出します。

このツールは、クライアント機能に応じて異なるプロンプトを返します。ネイティブウェブ検索を使用するクライアントは、research_aws_marketplace_solutionツールリファレンスではなく、検索クエリが埋め込まれたプロンプトを取得します。

入力:

{
  "workflow_type": "recommendations" | "comparison" | "evaluation"
}

次の表に、入力パラメータを示します。

出力:

{
  "workflow_type": "recommendations",
  "guidelines": "# AWS Marketplace Recommendations Workflow\n\n..."
}

次の表に、出力フィールドを示します。

各ワークフローを使用するタイミング:

search_aws_marketplace_solutions

Catalog AWS Marketplace API の直接検索を実行します。AI 処理や関連性スコアリングなしで、未加工、ランク付けされていない、フィルタリングされていない結果を返します。単一クエリのバッチクエリ (最大 10) とカーソルベースのページ分割をサポートします。

入力:

{
  "queries": ["Drata compliance", "Vanta compliance"],
  "max_results": 5,
  "cursor": null
}

次の表に、入力パラメータを示します。

出力:

{
  "results": [
    {
      "solution_id": "prodview-abc123",
      "solution_name": "Drata",
      "vendor_name": "Drata Inc",
      "vendor_url": "https://aws.amazon.com/marketplace/seller-profile?id=...",
      "solution_description": "Continuous compliance automation...",
      "solution_url": "https://aws.amazon.com/marketplace/pp/prodview-abc123",
      "reviews_summary": {
        "reviews_count": 150,
        "average_rating": 4.7
      }
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjEwLCJwYWdlU2l6ZSI6MTB9"
}

次の表に、出力フィールドを示します。

バッチ動作: 複数のクエリの場合、結果は によって結合および重複排除されますsolution_id。ページ分割カーソルはバッチリクエストには返されません。

ページ分割: next_cursorが返された場合 (単一クエリリクエストのみ）、パラメータとして返して追加の結果cursorを取得します。next_cursor が の場合null、一致するすべてのソリューションが取得されます。

get_aws_marketplace_solution

Catalog AWS Marketplace API の直接呼び出しを実行します。AI 処理なしでソリューション ID 別に包括的なソリューションメタデータを取得します。バッチリクエスト (最大 10 IDs) をサポートします。

入力:

{
  "solution_ids": ["prodview-abc123", "prodview-xyz789"]
}

次の表に、入力パラメータを示します。

出力:

{
  "solutions": [
    {
      "solution_id": "prodview-abc123",
      "solution_name": "Datadog",
      "solution_description": "Comprehensive monitoring and analytics...",
      "solution_url": "https://aws.amazon.com/marketplace/pp/prodview-abc123?ref_=...",
      "vendor_name": "Datadog, Inc.",
      "vendor_url": "https://aws.amazon.com/marketplace/seller-profile?id=...&ref_=...",
      "highlights": ["Real-time monitoring", "700+ integrations"],
      "reviews_summary": {
        "reviews_count": 245,
        "average_rating": 4.6
      },
      "review_sentiments": [
        {
          "sentiment_category": "functionality",
          "overall_polarity": "positive",
          "positive_score": "85%",
          "negative_score": "5%",
          "mixed_score": "10%",
          "sample_reviews": [
            {
              "review_text": "Excellent monitoring capabilities...",
              "rating": 5,
              "source_name": "G2"
            }
          ]
        }
      ],
      "free_trial_available": true,
      "pricing_options": [
        {
          "name": "Infrastructure Monitoring",
          "description": "$15 per host per month"
        }
      ],
      "fulfillment_options_types": ["SaaS"],
      "categories": ["Monitoring & Observability"],
      "security_certificates": ["SOC 2 Type II", "ISO 27001"],
      "rankings": [{ "category": "Monitoring", "rank": 3 }],
      "has_standard_contract": true,
      "call_to_action": {
        "procurement_url": "https://...",
        "request_for_demo_url": "https://...",
        "request_for_private_offer_url": "https://...",
        "procure_free_trial_url": "https://..."
      }
    }
  ]
}

次の表に、出力フィールドを示します。

次の表に、各SolutionOutputオブジェクトのフィールドを示します。

get_aws_marketplace_related_solutions

Catalog AWS Marketplace API の直接呼び出しを実行します。AI 分析や関連性スコアリングなしで AWS Marketplace、リレーションスコア (降順) でソートされた特定のソリューション IDs に関連するソリューションを返します。バッチリクエスト (最大 10 IDs) をサポートします。

入力:

{
  "solution_ids": ["prodview-abc123"]
}

次の表に、入力パラメータを示します。

出力:

{
  "results": [
    {
      "solution_id": "prodview-abc123",
      "related_solutions": [
        {
          "solution_id": "prodview-xyz789",
          "solution_name": "New Relic",
          "vendor_name": "New Relic, Inc.",
          "vendor_url": "https://aws.amazon.com/marketplace/seller-profile?id=...",
          "solution_description": "Full-stack observability platform...",
          "solution_url": "https://aws.amazon.com/marketplace/pp/prodview-xyz789"
        }
      ]
    }
  ]
}

次の表に、出力フィールドを示します。

research_aws_marketplace_solution

AWS Marketplace ソリューションに関する詳細なウェブ調査を実行します。リクエストされた各セクションに対してウェブ検索を実行し、インライン引用リンクを含むコンテンツを返します。バッチリクエスト (最大 5 IDs) をサポートします。

可視性: このツールは、ネイティブのウェブ検索機能 (Anthropic/ClaudeAI など) を持つクライアントからは非表示になります。これらのクライアントは、代わりに検索クエリが埋め込まれたワークフロープロンプトを取得します。

入力:

{
  "solution_ids": ["prodview-abc123", "prodview-xyz789"],
  "sections": ["features", "integrations"]
}

次の表に、入力パラメータを示します。

次の表は、利用可能な各研究セクションを示しています。

出力:

{
  "results": [
    {
      "solution_id": "prodview-abc123",
      "solution_name": "Datadog",
      "research": {
        "features": {
          "content": "Datadog provides 700+ integrations...",
          "citations": [
            {
              "index": "1",
              "title": "Datadog Integrations",
              "url": "https://docs.datadoghq.com/integrations/"
            }
          ]
        }
      }
    }
  ]
}

次の表に、出力フィールドを示します。

同時実行: ソリューションは並行して調査されます。各ソリューション内のセクションは、圧倒的なダウンストリームサービスを避けるためにシーケンシャルです。

submit_aws_marketplace_feedback

AWS Marketplace レポートに関するユーザーフィードバックを送信します。レコメンデーション、比較、または評価ワークフローを完了したら、このツールを呼び出します。

入力:

{
  "sentiment": "negative",
  "categories": ["incomplete", "other"],
  "feedback_text": "Missing pricing details"
}

次の表に、入力パラメータを示します。

出力:

{
  "success": true,
  "message": "Thank you for your feedback. We'll use it to improve."
}

ワークフロー

AWS Marketplace MCP サーバーは、製品調査と直接カタログ検索のための 3 つの主要なワークフローをサポートしています。

レポートの生成 (推奨事項、比較、評価)

これは、AI 支援製品研究の主要なワークフローです。オーケストレーションエントリポイントget_aws_marketplace_report_guidelinesとして を使用します。

フロー:

レコメンデーションワークフロー:

比較ワークフロー:

評価ワークフロー:

カタログの直接検索

AI 分析を必要としないプログラムによる統合やクイックルックアップの場合は、 を使用せずにカタログ API ツールを直接呼び出すことができますget_aws_marketplace_report_guidelines。

検索と詳細検索:

フィードバック収集

ワークフローが完了したら、アシスタントはユーザーのフィードバックを収集する必要があります。

エンドツーエンドの例

次の例は、最初のクエリからフィードバック送信までの完全なレコメンデーションワークフローを示しています。

ステップ 1 — ワークフロー手順を取得する:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_aws_marketplace_report_guidelines",
    "arguments": {
      "workflow_type": "recommendations"
    }
  }
}

ステップ 2 — 候補ソリューションを検索します。

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_aws_marketplace_solutions",
    "arguments": {
      "queries": ["SIEM security monitoring", "log management SIEM"],
      "max_results": 10
    }
  }
}

ステップ 3 — 上位候補の詳細メタデータを取得する:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_aws_marketplace_solution",
    "arguments": {
      "solution_ids": ["prodview-abc123", "prodview-def456", "prodview-ghi789"]
    }
  }
}

ステップ 4 — ユーザーフィードバックを送信する:

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "submit_aws_marketplace_feedback",
    "arguments": {
      "sentiment": "positive",
      "feedback_text": "Recommendations were relevant and well-structured"
    }
  }
}

エラー処理

エラーは、プロトコルエラー、ツール実行エラー、検証エラーの 3 つのカテゴリに分類されます。

プロトコルエラー

プロトコルエラーは、リクエストが JSON-RPC または MCP 仕様 (不正な形式の JSON、必須フィールドの欠落、不明なメソッドなど) に違反した場合に返されます。

{
  "jsonrpc": "2.0",
  "id": 10,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": {
      "details": "Missing required field: queries"
    }
  }
}

ツール実行エラー

ツール実行エラーは、実行時にツール呼び出しが失敗すると返されます (レート制限、無効なソリューション IDs、アップストリームサービスエラーなど）。ツールエラーは MCP プロトコルレベルのエラーとしてではなく、結果オブジェクト内で報告されるため、AI アシスタントはエラーを確認して処理できます。

{
  "jsonrpc": "2.0",
  "id": 11,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Failed to search listings: Rate limit exceeded"
      }
    ],
    "isError": true
  }
}

検証エラー

検証エラーは、入力がスキーマ検証に失敗した場合 (無効なソリューション ID 形式、最大配列長の超過、必須フィールドの欠落など) に返されます。これらは、 でツール実行エラーとして表示されますisError: true。