L'API Reference di AWS Marketplace è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Marketplace API Reference.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Informazioni su Marketplace AWS Server MCP

Marketplace AWS Model Context Protocol (MCP) fornisce AI-powered strumenti per la Marketplace AWS scoperta, la valutazione, la ricerca e la generazione di proposte. MCP è un protocollo standardizzato che consente agli assistenti AI di interagire con sistemi esterni attraverso quanto segue:

Tutti gli strumenti sono stateless: ogni chiamata è indipendente e non prevede lo stato di conversazione sul lato server.

Casi d'uso esemplificativi

Di seguito sono riportati i modi più comuni per utilizzare il server Marketplace AWS MCP:

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

Protocollo: MCP su Streamable HTTP (2.0)JSON-RPC . Tutte le risposte sono payload JSON singoli.

Autenticazione: non richiesta.

Strumenti disponibili

Tutti e 6 gli strumenti sono stateless e non richiedono alcun contesto di conversazione o gestione della sessione. Tutte le definizioni degli strumenti, inclusi input/output gli schemi completi, sono disponibili a livello di codice tramite l'endpoint MCP standard. tools/list Gli schemi restituiti da tools/list sono la fonte di verità canonica e sempre attuale per i nomi, i tipi e i vincoli dei parametri.

La tabella seguente riassume ogni strumento e indica se è di sola lettura.

Guida all'integrazione

È possibile effettuare l'integrazione con il server Marketplace AWS MCP in due modi: tramite un Claude Connector senza codice o tramite un client MCP programmatico.

Claude Connector (consigliato)

Il modo più veloce per utilizzare gli strumenti Marketplace AWS MCP è tramite il Marketplace AWS connettore per Claude. Ciò non richiede alcuna codifica o configurazione del client MCP: Claude gestisce automaticamente l'individuazione e la chiamata degli strumenti.

Configurazione:

Per maggiori dettagli su come funzionano i connettori, consulta Usare i connettori per estendere le funzionalità di Claude.

Suggerimenti di esempio:

Integrazione con client MCP

Per integrazioni programmatiche o framework di agenti personalizzati, connettiti direttamente all'endpoint MCP.

Prerequisiti

Per iniziare, hai bisogno di quanto segue:

Fase 1: Configurare il client MCP

Utilizzate un client MCP standard che supporti il trasporto HTTP.

Endpoint:

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

Sono supportati i seguenti metodi:

Autenticazione: non è richiesta alcuna autenticazione. Ometti le intestazioni di autenticazione nelle richieste HTTP.

Fase 2: Ottenere e registrare gli strumenti (tool discovery)

Tutte le definizioni degli strumenti sono disponibili a livello di codice tramite il metodo tools/list MCP standard. Questo è il metodo consigliato per ottenere input/output gli schemi correnti, in quanto gli schemi degli strumenti possono essere aggiornati indipendentemente dalla presente documentazione. Chiamate tools/list una sola volta durante l'inizializzazione e registrate gli strumenti restituiti nel manifesto degli strumenti dell'agente o nel prompt di sistema.

L'esempio seguente mostra una tools/list richiesta.

Richiesta:

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

Risposta (abbreviata):

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

Ogni voce dello strumento include lo strumentoname, una guida dettagliata description con istruzioni d'uso ed esempi e una completa inputSchema di tipi di parametri, vincoli e regole di convalida.

Fase 3: Configurare la telemetria

Marketplace AWS MCP richiede un identificatore stabile su ogni richiesta di strumento per la correlazione delle richieste e la telemetria. Non si tratta di una credenziale di autenticazione: viene utilizzata solo per la diagnostica e l'analisi.

Passa l'identificatore nell'intestazione HTTP personalizzata:

Mcp-Session-Id: <stable-id>

Trasporto HTTP

Marketplace AWS MCP utilizza il trasporto HTTP, in cui il server funziona come un servizio HTTP indipendente in grado di gestire più connessioni client.

Di seguito sono riportate le principali caratteristiche di trasporto:

Intestazioni HTTP richieste:

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

L'esempio seguente mostra una richiesta e una risposta alla chiamata di uno strumento.

Richiesta di esempio:

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

Esempio di risposta:

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

Dettagli dello strumento

Questa sezione descrive i parametri di input, il formato di output e le linee guida all'utilizzo di ogni strumento.

get_aws_marketplace_report_guidelines

Restituisce le istruzioni sul flusso di lavoro e il modello di formato di output per un determinato tipo di report. Chiamalo prima per qualsiasi flusso di lavoro di raccomandazione, confronto o valutazione.

Questo strumento restituisce prompt diversi a seconda delle funzionalità del client: i clienti con ricerca web nativa ricevono prompt con query di ricerca incorporate anziché riferimenti agli strumenti. research_aws_marketplace_solution

Ingresso:

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

La tabella seguente descrive i parametri di input.

Output:

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

La tabella seguente descrive i campi di output.

Quando utilizzare ogni flusso di lavoro:

search_aws_marketplace_solutions

Esegue una ricerca diretta nell'API del catalogo. Marketplace AWS Restituisce risultati grezzi, non classificati e non filtrati senza elaborazione AI o punteggio di pertinenza. Supporta query in batch (fino a 10) e l'impaginazione basata su cursori per singole query.

Ingresso:

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

La tabella seguente descrive i parametri di 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"
}

La tabella seguente descrive i campi di output.

Comportamento in batch: per più query, i risultati vengono combinati e deduplicati da. solution_id Il cursore di impaginazione non viene restituito per le richieste batch.

Impaginazione: se next_cursor viene restituito (solo richieste a query singola), restituiscilo come cursor parametro per recuperare risultati aggiuntivi. Quando next_cursor è cosìnull, tutte le soluzioni corrispondenti sono state recuperate.

get_aws_marketplace_solution

Esegue una chiamata diretta all'API Catalog. Marketplace AWS Recupera i metadati completi della soluzione per ID della soluzione senza elaborazione AI. Supporta richieste batch (fino a 10 ID).

Ingresso:

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

La tabella seguente descrive i parametri di 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://..."
      }
    }
  ]
}

La tabella seguente descrive i campi di output.

La tabella seguente descrive i campi di ogni SolutionOutput oggetto.

get_aws_marketplace_related_solutions

Esegue una chiamata diretta all'API Catalog. Marketplace AWS Restituisce le soluzioni correlate per determinati ID di soluzione identificate da Marketplace AWS, ordinate per punteggio di relazione (decrescente), senza analisi AI o punteggio di pertinenza. Supporta richieste batch (fino a 10 ID).

Ingresso:

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

La tabella seguente descrive i parametri di 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"
        }
      ]
    }
  ]
}

La tabella seguente descrive i campi di output.

research_aws_marketplace_solution

Esegue ricerche approfondite sul web sulle soluzioni. Marketplace AWS Esegue ricerche web per ogni sezione richiesta e restituisce contenuti con link di citazione in linea. Supporta richieste batch (fino a 5 ID).

Visibilità: questo strumento è nascosto ai client con funzionalità di ricerca web native (ad esempio, Anthropic/ClaudeAI). Questi clienti ricevono invece istruzioni sul flusso di lavoro con query di ricerca incorporate.

Ingresso:

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

La tabella seguente descrive i parametri di input.

La tabella seguente descrive ogni sezione di ricerca disponibile.

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

La tabella seguente descrive i campi di output.

Concorrenza: le soluzioni vengono ricercate in parallelo. Le sezioni all'interno di ciascuna soluzione sono sequenziali per evitare sovraccarichi di servizi a valle.

submit_aws_marketplace_feedback

Invia il feedback degli utenti su un rapporto. Marketplace AWS Richiama questo strumento dopo aver completato qualsiasi flusso di lavoro di raccomandazione, confronto o valutazione.

Ingresso:

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

La tabella seguente descrive i parametri di input.

Output:

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

Flussi di lavoro

Il server Marketplace AWS MCP supporta tre flussi di lavoro principali per la ricerca di prodotti e la ricerca diretta nei cataloghi.

Generazione di report (consigli, confronti, valutazioni)

Questo è il flusso di lavoro principale per la ricerca sui AI-assisted prodotti. Viene utilizzato get_aws_marketplace_report_guidelines come punto di ingresso dell'orchestrazione.

Flusso:

Flusso di lavoro dei consigli:

Flusso di lavoro di confronto:

Flusso di lavoro di valutazione:

Ricerca diretta nel catalogo

Per le integrazioni programmatiche o le ricerche rapide che non richiedono l'analisi dell'intelligenza artificiale, puoi chiamare gli strumenti dell'API del catalogo direttamente senza. get_aws_marketplace_report_guidelines

Cerca e poi cerca i dettagli:

Raccolta di feedback

Dopo aver completato qualsiasi flusso di lavoro, l'assistente dovrebbe raccogliere il feedback degli utenti.

End-to-end esempio

L'esempio seguente illustra un flusso di lavoro completo per i consigli, dalla richiesta iniziale all'invio del feedback.

Fase 1: Ottieni le istruzioni sul flusso di lavoro:

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

Fase 2: Ricerca delle soluzioni candidate:

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

Fase 3 — Recupera i metadati dettagliati per i migliori candidati:

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

Fase 4 — Inviare il feedback degli utenti:

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

Gestione degli errori

Gli errori si dividono in tre categorie: errori di protocollo, errori di esecuzione degli strumenti ed errori di convalida.

Errori di protocollo

Gli errori di protocollo vengono restituiti quando la richiesta viola la specifica JSON-RPC o MCP (ad esempio, JSON non valido, campi obbligatori mancanti o metodi sconosciuti).

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

Errori di esecuzione dello strumento

Gli errori di esecuzione dello strumento vengono restituiti quando l'invocazione di uno strumento non riesce in fase di esecuzione (ad esempio, limitazione della velocità, ID di soluzione non validi o errori del servizio upstream). Gli errori dello strumento vengono segnalati all'interno dell'oggetto risultato, non come errori a livello di protocollo MCP, in modo che l'assistente AI possa vedere e gestire l'errore.

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

Errori di convalida

Gli errori di convalida vengono restituiti quando l'input non supera la convalida dello schema (ad esempio, formato ID della soluzione non valido, lunghezza massima dell'array superiore o campi obbligatori mancanti). Questi vengono visualizzati come errori di esecuzione dello strumento con. isError: true