Referensi API AWS Marketplace direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi API AWS Marketplace.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tentang AWS Marketplace Server MCP

AWS Marketplace Model Context Protocol (MCP) menyediakan AI-powered alat untuk AWS Marketplace penemuan, evaluasi, penelitian, dan pembuatan proposal. MCP adalah protokol standar yang memungkinkan asisten AI berinteraksi dengan sistem eksternal melalui hal-hal berikut:

Semua alat bersifat stateless - setiap panggilan independen tanpa status percakapan sisi server.

Contoh kasus penggunaan

Berikut ini adalah cara umum untuk menggunakan server AWS Marketplace MCP:

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

Protokol: MCP melalui Streamable HTTP (JSON-RPC 2.0). Semua tanggapan adalah muatan JSON tunggal.

Otentikasi: Tidak diperlukan.

Alat yang tersedia

Semua 6 alat tidak memiliki kewarganegaraan dan tidak memerlukan konteks percakapan atau manajemen sesi. Semua definisi alat, termasuk input/output skema lengkap, tersedia secara terprogram melalui titik akhir MCP standar. tools/list Skema yang dikembalikan oleh tools/list adalah sumber kebenaran kanonik yang selalu ada untuk nama parameter, tipe, dan batasan.

Tabel berikut merangkum setiap alat dan apakah itu read-only.

Panduan integrasi

Anda dapat berintegrasi dengan server AWS Marketplace MCP dalam dua cara: melalui Konektor Claude tanpa kode atau melalui klien MCP terprogram.

Konektor Claude (disarankan)

Cara tercepat untuk menggunakan alat AWS Marketplace MCP adalah melalui AWS Marketplace konektor untuk Claude. Ini tidak memerlukan pengkodean atau pengaturan klien MCP - Claude menangani penemuan dan pemanggilan alat secara otomatis.

Pengaturan:

Untuk detail selengkapnya tentang cara kerja konektor, lihat Menggunakan konektor untuk memperluas kemampuan Claude.

Contoh petunjuk:

Integrasi klien MCP

Untuk integrasi terprogram atau kerangka kerja agen kustom, sambungkan langsung ke titik akhir MCP.

Prasyarat

Anda memerlukan yang berikut ini untuk memulai:

Langkah 1: Siapkan klien MCP

Gunakan klien MCP standar yang mendukung transportasi HTTP.

Titik akhir:

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

Metode berikut didukung:

Otentikasi: Tidak diperlukan otentikasi. Hilangkan header autentikasi dalam permintaan HTTP.

Langkah 2: Dapatkan dan daftarkan alat (penemuan alat)

Semua definisi alat tersedia secara terprogram melalui metode tools/list MCP standar. Ini adalah cara yang disarankan untuk mendapatkan input/output skema saat ini, karena skema alat dapat diperbarui secara independen dari dokumentasi ini. Panggil tools/list sekali selama inisialisasi dan daftarkan alat yang dikembalikan dalam manifes alat atau prompt sistem agen Anda.

Contoh berikut menunjukkan tools/list permintaan.

Permintaan:

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

Tanggapan (disingkat):

{
  "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": { ... }
      }
    ]
  }
}

Setiap entri alat mencakup alatname, detail description dengan panduan penggunaan dan contoh, dan lengkap inputSchema dengan jenis parameter, kendala, dan aturan validasi.

Langkah 3: Konfigurasikan telemetri

AWS Marketplace MCP membutuhkan pengidentifikasi yang stabil pada setiap panggilan alat untuk korelasi permintaan dan telemetri. Ini bukan kredensi otentikasi — ini hanya digunakan untuk diagnostik dan analitik.

Lulus pengenal di header HTTP kustom:

Mcp-Session-Id: <stable-id>

Transportasi HTTP

AWS Marketplace MCP menggunakan transportasi HTTP, di mana server beroperasi sebagai layanan HTTP independen yang dapat menangani beberapa koneksi klien.

Berikut ini adalah karakteristik transportasi utama:

Header HTTP yang diperlukan:

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

Contoh berikut menunjukkan permintaan dan respons panggilan alat.

Contoh permintaan:

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"]
    }
  }
}

Contoh respon:

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

Detail alat

Bagian ini menjelaskan parameter input, format output, dan panduan penggunaan masing-masing alat.

get_aws_marketplace_report_guidelines

Mengembalikan instruksi alur kerja dan template format output untuk jenis laporan tertentu. Hubungi ini terlebih dahulu untuk setiap rekomendasi, perbandingan, atau alur kerja evaluasi.

Alat ini mengembalikan permintaan yang berbeda tergantung pada kemampuan klien — klien dengan pencarian web asli mendapatkan petunjuk dengan kueri penelusuran tertanam alih-alih research_aws_marketplace_solution referensi alat.

Masukan:

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

Tabel berikut menjelaskan parameter input.

Output:

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

Tabel berikut menjelaskan bidang output.

Kapan menggunakan setiap alur kerja:

search_aws_marketplace_solutions

Melakukan pencarian API AWS Marketplace Katalog langsung. Mengembalikan hasil mentah, tidak berperingkat, tanpa filter tanpa pemrosesan AI atau penilaian relevansi. Mendukung kueri batch (hingga 10) dan pagination berbasis kursor untuk kueri tunggal.

Masukan:

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

Tabel berikut menjelaskan parameter input.

Output:

{
  "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"
}

Tabel berikut menjelaskan bidang output.

Perilaku Batch: Untuk beberapa kueri, hasil digabungkan dan dideduplikasi oleh. solution_id Kursor pagination tidak dikembalikan untuk permintaan batch.

Pagination: Jika next_cursor dikembalikan (permintaan kueri tunggal saja), berikan kembali sebagai cursor parameter untuk mengambil hasil tambahan. next_cursorKapannull, semua solusi yang cocok telah diambil.

get_aws_marketplace_solution

Melakukan panggilan API AWS Marketplace Katalog langsung. Mengambil metadata solusi komprehensif dengan ID solusi tanpa pemrosesan AI. Mendukung permintaan batch (hingga 10 ID).

Masukan:

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

Tabel berikut menjelaskan parameter input.

Output:

{
  "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://..."
      }
    }
  ]
}

Tabel berikut menjelaskan bidang output.

Tabel berikut menjelaskan bidang di setiap SolutionOutput objek.

get_aws_marketplace_related_solutions

Melakukan panggilan API AWS Marketplace Katalog langsung. Mengembalikan solusi terkait untuk ID solusi yang diberikan seperti yang diidentifikasi oleh AWS Marketplace, diurutkan berdasarkan skor relasi (menurun), tanpa analisis AI atau penilaian relevansi. Mendukung permintaan batch (hingga 10 ID).

Masukan:

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

Tabel berikut menjelaskan parameter input.

Output:

{
  "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"
        }
      ]
    }
  ]
}

Tabel berikut menjelaskan bidang output.

research_aws_marketplace_solution

Melakukan penelitian web mendalam tentang AWS Marketplace solusi. Menjalankan pencarian web untuk setiap bagian yang diminta dan mengembalikan konten dengan tautan kutipan sebaris. Mendukung permintaan batch (hingga 5 ID).

Visibilitas: Alat ini disembunyikan dari klien dengan kemampuan pencarian web asli (misalnya, Anthropic/ClaudeAI). Klien tersebut mendapatkan petunjuk alur kerja dengan kueri penelusuran yang disematkan sebagai gantinya.

Masukan:

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

Tabel berikut menjelaskan parameter input.

Tabel berikut menjelaskan setiap bagian penelitian yang tersedia.

Output:

{
  "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/"
            }
          ]
        }
      }
    }
  ]
}

Tabel berikut menjelaskan bidang output.

Konkurensi: Solusi diteliti secara paralel. Bagian dalam setiap solusi berurutan untuk menghindari layanan hilir yang luar biasa.

submit_aws_marketplace_feedback

Mengirimkan umpan balik pengguna tentang AWS Marketplace laporan. Hubungi alat ini setelah menyelesaikan alur kerja rekomendasi, perbandingan, atau evaluasi apa pun.

Masukan:

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

Tabel berikut menjelaskan parameter input.

Output:

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

Alur kerja

Server AWS Marketplace MCP mendukung tiga alur kerja utama untuk penelitian produk dan pencarian katalog langsung.

Pembuatan laporan (rekomendasi, perbandingan, evaluasi)

Ini adalah alur kerja utama untuk penelitian AI-assisted produk. Ini digunakan get_aws_marketplace_report_guidelines sebagai titik masuk orkestrasi.

Aliran:

Alur kerja rekomendasi:

Alur kerja perbandingan:

Alur kerja evaluasi:

Pencarian katalog langsung

Untuk integrasi terprogram atau pencarian cepat yang tidak memerlukan analisis AI, Anda dapat menghubungi alat API katalog secara langsung tanpa. get_aws_marketplace_report_guidelines

Cari kemudian pencarian detail:

Pengumpulan umpan balik

Setelah menyelesaikan alur kerja apa pun, asisten harus mengumpulkan umpan balik pengguna.

End-to-end contoh

Contoh berikut menunjukkan alur kerja rekomendasi lengkap dari kueri awal hingga pengiriman umpan balik.

Langkah 1 - Dapatkan instruksi alur kerja:

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

Langkah 2 — Cari solusi kandidat:

{
  "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
    }
  }
}

Langkah 3 - Ambil metadata terperinci untuk kandidat teratas:

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

Langkah 4 - Kirim umpan balik pengguna:

{
  "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"
    }
  }
}

Penanganan kesalahan

Kesalahan terbagi dalam tiga kategori: kesalahan protokol, kesalahan eksekusi alat, dan kesalahan validasi.

Kesalahan protokol

Kesalahan protokol dikembalikan ketika permintaan melanggar spesifikasi JSON-RPC atau MCP (misalnya, JSON cacat, bidang wajib yang hilang, atau metode yang tidak diketahui).

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

Kesalahan eksekusi alat

Kesalahan eksekusi alat dikembalikan ketika pemanggilan alat gagal saat runtime (misalnya, pembatasan laju, ID solusi tidak valid, atau kesalahan layanan hulu). Kesalahan alat dilaporkan dalam objek hasil, bukan sebagai kesalahan tingkat protokol MCP, sehingga asisten AI dapat melihat dan menangani kesalahan.

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

Kesalahan validasi

Kesalahan validasi dikembalikan ketika masukan gagal validasi skema (misalnya, format ID solusi tidak valid, melebihi panjang array maks, atau bidang wajib yang hilang). Ini muncul sebagai kesalahan eksekusi alat denganisError: true.