Die AWS Marketplace-API-Referenz wurde umstrukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Marketplace-API-Referenz.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Über den AWS Marketplace MCP-Server

AWS Marketplace Das Model Context Protocol (MCP) bietet AI-powered Tools für die AWS Marketplace Entdeckung, Bewertung, Recherche und Angebotserstellung. MCP ist ein standardisiertes Protokoll, das es KI-Assistenten ermöglicht, wie folgt mit externen Systemen zu interagieren:

Alle Tools sind zustandslos — jeder Anruf ist unabhängig und hat keinen serverseitigen Konversationsstatus.

Beispiele für Anwendungsfälle

Im Folgenden finden Sie gängige Verwendungsmöglichkeiten für den AWS Marketplace MCP-Server:

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

Protokoll: MCP über Streamable HTTP (JSON-RPC 2.0). Alle Antworten sind einzelne JSON-Payloads.

Authentifizierung: Keine erforderlich.

Verfügbare Tools

Alle 6 Tools sind zustandslos und benötigen weder Konversationskontext noch Sitzungsmanagement. Alle Tooldefinitionen, einschließlich vollständiger input/output Schemas, sind programmgesteuert über den Standard-MCP-Endpunkt verfügbar. tools/list Die von zurückgegebenen Schemas tools/list sind die kanonische, stets aktuelle Informationsquelle für Parameternamen, Typen und Einschränkungen.

In der folgenden Tabelle werden die einzelnen Tools zusammengefasst und angegeben, ob sie schreibgeschützt sind.

Leitfaden zur Integration

Sie können die Integration mit dem AWS Marketplace MCP-Server auf zwei Arten durchführen: über einen Claude Connector ohne Code oder über einen programmgesteuerten MCP-Client.

Claude Connector (empfohlen)

Der schnellste Weg, AWS Marketplace MCP-Tools zu verwenden, ist der AWS Marketplace Connector für Claude. Dies erfordert keine Codierung oder Einrichtung des MCP-Clients — Claude kümmert sich automatisch um die Erkennung und den Aufruf der Tools.

Einrichtung:

Weitere Informationen zur Funktionsweise von Konnektoren finden Sie unter Verwenden von Konnektoren, um die Funktionen von Claude zu erweitern.

Beispiel-Eingabeaufforderungen:

MCP-Client-Integration

Stellen Sie für programmatische Integrationen oder benutzerdefinierte Agenten-Frameworks eine direkte Verbindung zum MCP-Endpunkt her.

Voraussetzungen

Für den Einstieg benötigen Sie Folgendes:

Schritt 1: MCP-Client einrichten

Verwenden Sie einen Standard-MCP-Client, der HTTP-Transport unterstützt.

Endpunkt:

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

Die folgenden Methoden werden unterstützt:

Authentifizierung: Es ist keine Authentifizierung erforderlich. Lassen Sie Auth-Header in HTTP-Anfragen weg.

Schritt 2: Tools beschaffen und registrieren (Tool-Discovery)

Alle Werkzeugdefinitionen sind programmgesteuert über die tools/list Standard-MCP-Methode verfügbar. Dies ist die empfohlene Methode, um aktuelle input/output Schemas zu erhalten, da Werkzeugschemas unabhängig von dieser Dokumentation aktualisiert werden können. Rufen Sie während der Initialisierung tools/list einmal auf und registrieren Sie die zurückgegebenen Tools im Tool-Manifest oder in der Systemeingabeaufforderung Ihres Agenten.

Das folgende Beispiel zeigt eine tools/list Anfrage.

Anfrage:

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

Antwort (abgekürzt):

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

Jeder Werkzeugeintrag enthält das Werkzeugname, eine ausführliche Beschreibung description mit Anleitungen zur Verwendung und Beispielen sowie eine vollständige Liste inputSchema mit Parametertypen, Einschränkungen und Validierungsregeln.

Schritt 3: Telemetrie konfigurieren

AWS Marketplace MCP benötigt bei jedem Toolaufruf eine stabile Kennung für die Korrelation von Anfragen und Telemetrie. Dies ist kein Authentifizierungsnachweis — er wird nur für Diagnose und Analyse verwendet.

Übergeben Sie den Bezeichner im benutzerdefinierten HTTP-Header:

Mcp-Session-Id: <stable-id>

HTTP-Transport

AWS Marketplace MCP verwendet den HTTP-Transport, bei dem der Server als unabhängiger HTTP-Dienst arbeitet, der mehrere Client-Verbindungen verarbeiten kann.

Im Folgenden sind die wichtigsten Transportmerkmale aufgeführt:

Erforderliche HTTP-Header:

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

Das folgende Beispiel zeigt eine Anfrage und Antwort auf einen Tool-Aufruf.

Beispiel für eine Anfrage:

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

Beispiel für eine Antwort:

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

Einzelheiten zum Tool

In diesem Abschnitt werden die Eingabeparameter, das Ausgabeformat und die Nutzungshinweise der einzelnen Werkzeuge beschrieben.

get_aws_marketplace_report_guidelines

Gibt Workflow-Anweisungen und eine Ausgabeformatvorlage für einen bestimmten Berichtstyp zurück. Rufen Sie diese Option zuerst für jeden Empfehlungs-, Vergleichs- oder Bewertungsworkflow auf.

Dieses Tool gibt je nach den Funktionen des Clients unterschiedliche Eingabeaufforderungen zurück. Kunden mit systemeigener Websuche erhalten Eingabeaufforderungen mit eingebetteten Suchanfragen anstelle von research_aws_marketplace_solution Toolreferenzen.

Eingabe:

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

In der folgenden Tabelle werden die Eingabeparameter beschrieben.

Ausgabe:

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

In der folgenden Tabelle werden die Ausgabefelder beschrieben.

Wann sollten die einzelnen Workflows verwendet werden:

search_aws_marketplace_solutions

Führt eine direkte Katalog-API-Suche durch. AWS Marketplace Gibt rohe, ungefilterte Ergebnisse ohne Rangfolge und ohne KI-Verarbeitung oder Relevanzbewertung zurück. Unterstützt Batch-Abfragen (bis zu 10) und cursorbasierte Paginierung für einzelne Abfragen.

Eingabe:

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

In der folgenden Tabelle werden die Eingabeparameter beschrieben.

Ausgabe:

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

In der folgenden Tabelle werden die Ausgabefelder beschrieben.

Batch-Verhalten: Bei mehreren Abfragen werden die Ergebnisse kombiniert und dedupliziert von. solution_id Der Paginierungscursor wird bei Batchanfragen nicht zurückgegeben.

Paginierung: Wenn zurückgegeben next_cursor wird (nur Anfragen mit einer einzigen Abfrage), geben Sie sie als cursor Parameter zurück, um zusätzliche Ergebnisse abzurufen. Wenn dies next_cursor der null Fall ist, wurden alle passenden Lösungen abgerufen.

get_aws_marketplace_solution

Führt einen direkten Aufruf der Katalog-API durch. AWS Marketplace Ruft umfassende Lösungsmetadaten nach Lösungs-ID ohne KI-Verarbeitung ab. Unterstützt Batch-Anfragen (bis zu 10 IDs).

Eingabe:

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

In der folgenden Tabelle werden die Eingabeparameter beschrieben.

Ausgabe:

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

In der folgenden Tabelle werden die Ausgabefelder beschrieben.

In der folgenden Tabelle werden die Felder in den einzelnen SolutionOutput Objekten beschrieben.

get_aws_marketplace_related_solutions

Führt einen direkten Aufruf der Katalog-API durch. AWS Marketplace Gibt verwandte Lösungen für die angegebenen Lösungs-IDs zurück AWS Marketplace, sortiert nach der Beziehungsbewertung (absteigend), ohne KI-Analyse oder Relevanzbewertung. Unterstützt Batch-Anfragen (bis zu 10 IDs).

Eingabe:

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

In der folgenden Tabelle werden die Eingabeparameter beschrieben.

Ausgabe:

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

In der folgenden Tabelle werden die Ausgabefelder beschrieben.

research_aws_marketplace_solution

Führt umfangreiche Webrecherchen zu Lösungen durch. AWS Marketplace Führt Websuchen für jeden angeforderten Abschnitt durch und gibt Inhalte mit Inline-Zitationslinks zurück. Unterstützt Batch-Anfragen (bis zu 5 IDs).

Sichtbarkeit: Dieses Tool ist Kunden mit nativer Websuchfunktion nicht zugänglich (z. B. Anthropic/ClaudeAI). Diese Kunden erhalten stattdessen Workflow-Eingabeaufforderungen mit eingebetteten Suchanfragen.

Eingabe:

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

In der folgenden Tabelle werden die Eingabeparameter beschrieben.

In der folgenden Tabelle werden die einzelnen verfügbaren Forschungsabschnitte beschrieben.

Ausgabe:

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

In der folgenden Tabelle werden die Ausgabefelder beschrieben.

Parallelität: Lösungen werden parallel erforscht. Die Abschnitte innerhalb jeder Lösung sind sequentiell, um zu vermeiden, dass die nachgelagerten Dienste überlastet werden.

submit_aws_marketplace_feedback

Sendet Benutzerfeedback zu einem Bericht. AWS Marketplace Rufen Sie dieses Tool auf, nachdem Sie einen Empfehlungs-, Vergleichs- oder Bewertungsworkflow abgeschlossen haben.

Eingabe:

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

In der folgenden Tabelle werden die Eingabeparameter beschrieben.

Ausgabe:

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

Arbeitsabläufe

Der AWS Marketplace MCP-Server unterstützt drei primäre Workflows für die Produktrecherche und die direkte Suche nach Katalogen.

Erstellung von Berichten (Empfehlungen, Vergleiche, Bewertungen)

Dies ist der primäre Arbeitsablauf für die AI-assisted Produktrecherche. Er wird get_aws_marketplace_report_guidelines als Einstiegspunkt für die Orchestrierung verwendet.

Ablauf:

Arbeitsablauf mit Empfehlungen:

Arbeitsablauf für den Vergleich:

Arbeitsablauf bei der Bewertung:

Direkte Katalogsuche

Für programmatische Integrationen oder schnelle Suchvorgänge, für die keine KI-Analyse erforderlich ist, können Sie die Katalog-API-Tools direkt aufrufen, ohne dass dies der Fall ist. get_aws_marketplace_report_guidelines

Suchen und dann nach Details suchen:

Erfassung von Feedback

Nach Abschluss eines Workflows sollte der Assistent Benutzerfeedback sammeln.

End-to-end Beispiel

Das folgende Beispiel zeigt einen vollständigen Empfehlungs-Workflow von der ersten Anfrage bis zur Einreichung des Feedbacks.

Schritt 1 — Holen Sie sich Workflow-Anweisungen:

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

Schritt 2 — Suchen Sie nach geeigneten Lösungen:

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

Schritt 3 — Rufen Sie detaillierte Metadaten für Top-Kandidaten ab:

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

Schritt 4 — Nutzerfeedback einreichen:

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

Fehlerbehandlung

Fehler lassen sich in drei Kategorien einteilen: Protokollfehler, Fehler bei der Ausführung von Tools und Validierungsfehler.

Protokollfehler

Protokollfehler werden zurückgegeben, wenn die Anforderung gegen die JSON-RPC oder MCP-Spezifikation verstößt (z. B. falsch formatiertes JSON, fehlende Pflichtfelder oder unbekannte Methoden).

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

Fehler bei der Ausführung des Tools

Fehler bei der Ausführung von Tools werden zurückgegeben, wenn ein Tool-Aufruf zur Laufzeit fehlschlägt (z. B. Ratenbegrenzung, ungültige Lösungs-IDs oder Upstream-Servicefehler). Werkzeugfehler werden innerhalb des Ergebnisobjekts gemeldet, nicht als Fehler auf MCP-Protokollebene, sodass der KI-Assistent den Fehler erkennen und behandeln kann.

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

Validierungsfehler

Validierungsfehler werden zurückgegeben, wenn die Eingabe bei der Schemavalidierung fehlschlägt (z. B. ungültiges Lösungs-ID-Format, Überschreitung der maximalen Array-Länge oder fehlende Pflichtfelder). Diese werden als Fehler bei der Ausführung von Tools angezeigt. isError: true