La référence de l'API AWS Marketplace a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez le manuel AWS Marketplace API Reference.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

À propos de AWS Marketplace serveur MCP

AWS Marketplace Le protocole MCP (Model Context Protocol) fournit des AI-powered outils de AWS Marketplace découverte, d'évaluation, de recherche et de génération de propositions. Le MCP est un protocole standardisé qui permet aux assistants d'intelligence artificielle d'interagir avec des systèmes externes de la manière suivante :

Tous les outils sont apatrides : chaque appel est indépendant, sans état de conversation côté serveur.

Exemples de cas d'utilisation

Les méthodes les plus courantes pour utiliser le serveur AWS Marketplace MCP sont les suivantes :

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

Protocole : MCP sur HTTP streamable (JSON-RPC 2.0). Toutes les réponses sont des charges utiles JSON uniques.

Authentification : aucune n'est requise.

Outils disponibles

Les 6 outils sont apatrides et ne nécessitent aucun contexte de conversation ni aucune gestion de session. Toutes les définitions d'outils, y compris les input/output schémas complets, sont disponibles par programmation via le point de terminaison MCP standard. tools/list Les schémas renvoyés par tools/list constituent la source de vérité canonique et toujours actuelle pour les noms, les types et les contraintes des paramètres.

Le tableau suivant récapitule chaque outil et indique s'il est en lecture seule.

Guide d'intégration

Vous pouvez intégrer le serveur AWS Marketplace MCP de deux manières : via un connecteur Claude sans code ou via un client MCP programmatique.

Claude Connector (recommandé)

Le moyen le plus rapide d'utiliser les outils AWS Marketplace MCP est d'utiliser le AWS Marketplace connecteur pour Claude. Cela ne nécessite aucun codage ni aucune configuration du client MCP. Claude gère automatiquement la découverte et l'invocation des outils.

Configuration :

Pour plus de détails sur le fonctionnement des connecteurs, voir Utiliser des connecteurs pour étendre les capacités de Claude.

Exemples d'instructions :

Intégration du client MCP

Pour les intégrations programmatiques ou les frameworks d'agents personnalisés, connectez-vous directement au point de terminaison MCP.

Conditions préalables

Pour commencer, vous avez besoin des éléments suivants :

Étape 1 : Configuration du client MCP

Utilisez un client MCP standard qui prend en charge le transport HTTP.

Point de terminaison :

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

Les méthodes suivantes sont prises en charge :

Authentification : aucune authentification n'est requise. Omettez les en-têtes d'authentification dans les requêtes HTTP.

Étape 2 : Obtenir et enregistrer des outils (découverte d'outils)

Toutes les définitions d'outils sont disponibles par programmation via la méthode tools/list MCP standard. Il s'agit de la méthode recommandée pour obtenir les input/output schémas actuels, car les schémas d'outils peuvent être mis à jour indépendamment de cette documentation. Appelez tools/list une fois pendant l'initialisation et enregistrez les outils renvoyés dans le manifeste d'outils ou dans l'invite système de votre agent.

L'exemple suivant montre une tools/list demande.

Requête :

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

Réponse (abrégée) :

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

Chaque entrée d'outil inclut l'outilname, une description détaillée description avec des conseils d'utilisation et des exemples, ainsi qu'une liste complète inputSchema des types de paramètres, des contraintes et des règles de validation.

Étape 3 : Configuration de la télémétrie

AWS Marketplace MCP nécessite un identifiant stable pour chaque appel d'outil pour la corrélation des demandes et la télémétrie. Il ne s'agit pas d'un identifiant d'authentification ; il est utilisé uniquement à des fins de diagnostic et d'analyse.

Transmettez l'identifiant dans l'en-tête HTTP personnalisé :

Mcp-Session-Id: <stable-id>

Transport HTTP

AWS Marketplace MCP utilise le transport HTTP, où le serveur fonctionne comme un service HTTP indépendant capable de gérer plusieurs connexions client.

Les principales caractéristiques du transport sont les suivantes :

En-têtes HTTP obligatoires :

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

L'exemple suivant montre une demande et une réponse à un appel d'outil.

Exemple de demande :

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

Exemple de réponse :

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

Détails de l'outil

Cette section décrit les paramètres d'entrée, le format de sortie et les conseils d'utilisation de chaque outil.

get_aws_marketplace_report_guidelines

Renvoie les instructions de flux de travail et le modèle de format de sortie pour un type de rapport donné. Appelez-le d'abord pour tout flux de travail de recommandation, de comparaison ou d'évaluation.

Cet outil renvoie des instructions différentes en fonction des capacités du client : les clients utilisant la recherche native sur le Web reçoivent des invites contenant des requêtes de recherche intégrées au lieu de références à des research_aws_marketplace_solution outils.

Entrée :

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

Le tableau suivant décrit les paramètres d'entrée.

Sortie :

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

Le tableau suivant décrit les champs de sortie.

Quand utiliser chaque flux de travail :

search_aws_marketplace_solutions

Effectue une recherche directe dans l'API AWS Marketplace Catalog. Renvoie des résultats bruts, non classés et non filtrés sans traitement par IA ni notation de pertinence. Supporte les requêtes par lots (jusqu'à 10) et la pagination par curseur pour les requêtes uniques.

Entrée :

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

Le tableau suivant décrit les paramètres d'entrée.

Sortie :

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

Le tableau suivant décrit les champs de sortie.

Comportement par lots : pour les requêtes multiples, les résultats sont combinés et dédupliqués par. solution_id Le curseur de pagination n'est pas renvoyé pour les demandes par lots.

Pagination : s'il next_cursor est renvoyé (demandes à requête unique uniquement), renvoyez-le en tant que cursor paramètre pour récupérer des résultats supplémentaires. Dans next_cursor ce casnull, toutes les solutions correspondantes ont été récupérées.

get_aws_marketplace_solution

Exécute un appel direct de l'API AWS Marketplace Catalog. Récupère les métadonnées complètes de la solution par identifiant de solution sans traitement par IA. Prend en charge les demandes par lots (jusqu'à 10 identifiants).

Entrée :

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

Le tableau suivant décrit les paramètres d'entrée.

Sortie :

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

Le tableau suivant décrit les champs de sortie.

Le tableau suivant décrit les champs de chaque SolutionOutput objet.

Solutions liées au marché get_aws_marketplace

Exécute un appel direct de l'API AWS Marketplace Catalog. Renvoie les solutions associées pour des identifiants de solution donnés tels qu'identifiés par AWS Marketplace, triés par score de relation (décroissant), sans analyse d'IA ni score de pertinence. Prend en charge les demandes par lots (jusqu'à 10 identifiants).

Entrée :

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

Le tableau suivant décrit les paramètres d'entrée.

Sortie :

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

Le tableau suivant décrit les champs de sortie.

Research_aws_marketplace_solution

Effectue des recherches approfondies sur le Web sur AWS Marketplace les solutions. Lance des recherches sur le Web pour chaque section demandée et renvoie le contenu avec des liens de citation intégrés. Prend en charge les demandes par lots (jusqu'à 5 identifiants).

Visibilité : Cet outil est caché aux clients grâce à une fonctionnalité de recherche Web native (par exemple, Anthropic/ClaudeAI). Ces clients reçoivent plutôt des instructions de flux de travail avec des requêtes de recherche intégrées.

Entrée :

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

Le tableau suivant décrit les paramètres d'entrée.

Le tableau suivant décrit chaque section de recherche disponible.

Sortie :

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

Le tableau suivant décrit les champs de sortie.

Concurrence : les solutions sont recherchées en parallèle. Les sections de chaque solution sont séquentielles afin d'éviter de surcharger les services en aval.

soumet_aws_marketplace_feedback

Soumet les commentaires des utilisateurs à propos d'un AWS Marketplace rapport. Appelez cet outil après avoir terminé un flux de travail de recommandation, de comparaison ou d'évaluation.

Entrée :

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

Le tableau suivant décrit les paramètres d'entrée.

Sortie :

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

Flux de travail

Le serveur AWS Marketplace MCP prend en charge trois flux de travail principaux pour la recherche de produits et la consultation directe de catalogues.

Génération de rapports (recommandations, comparaisons, évaluations)

Il s'agit du flux de travail principal pour la recherche de AI-assisted produits. Il est utilisé get_aws_marketplace_report_guidelines comme point d'entrée de l'orchestration.

Débit :

Flux de travail des recommandations :

Flux de travail de comparaison :

Flux de travail d'évaluation :

Recherche directe dans le catalogue

Pour les intégrations programmatiques ou les recherches rapides qui ne nécessitent pas d'analyse basée sur l'IA, vous pouvez appeler les outils de l'API du catalogue directement sans. get_aws_marketplace_report_guidelines

Recherche puis recherche détaillée :

Collecte de commentaires

Après avoir terminé un flux de travail, l'assistant doit recueillir les commentaires des utilisateurs.

End-to-end exemple

L'exemple suivant illustre un flux de travail de recommandations complet, de la requête initiale à l'envoi des commentaires.

Étape 1 — Obtenez les instructions relatives au flux de travail :

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

Étape 2 — Recherche de solutions candidates :

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

Étape 3 — Récupérez les métadonnées détaillées des meilleurs candidats :

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

Étape 4 — Soumettre les commentaires des utilisateurs :

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

Gestion des erreurs

Les erreurs se répartissent en trois catégories : les erreurs de protocole, les erreurs d'exécution des outils et les erreurs de validation.

Erreurs de protocole

Des erreurs de protocole sont renvoyées lorsque la demande ne respecte pas la JSON-RPC spécification MCP (par exemple, un JSON mal formé, des champs obligatoires manquants ou des méthodes inconnues).

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

Erreurs d'exécution de l'outil

Des erreurs d'exécution d'un outil sont renvoyées lorsqu'un appel d'outil échoue au moment de l'exécution (par exemple, limitation du débit, ID de solution non valides ou erreurs de service en amont). Les erreurs d'outil sont signalées dans l'objet de résultat, et non comme des erreurs au niveau du protocole MCP, afin que l'assistant AI puisse voir et gérer l'erreur.

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

Erreurs de validation

Des erreurs de validation sont renvoyées lorsque la saisie échoue à la validation du schéma (par exemple, format d'identifiant de solution non valide, longueur de tableau supérieure ou champs obligatoires manquants). Elles apparaissent sous forme d'erreurs d'exécution de l'outil avecisError: true.