Se reestructuró la referencia de la API de AWS Marketplace. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia de API de AWS Marketplace.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Acerca del AWS Marketplace Servidor MCP

AWS Marketplace El Model Context Protocol (MCP) proporciona AI-powered herramientas para el AWS Marketplace descubrimiento, la evaluación, la investigación y la generación de propuestas. El MCP es un protocolo estandarizado que permite a los asistentes de IA interactuar con sistemas externos de la siguiente manera:

Todas las herramientas no tienen estado: cada llamada es independiente y no hay ningún estado de conversación del lado del servidor.

Ejemplos de casos de uso

Las siguientes son formas habituales de utilizar el servidor AWS Marketplace MCP:

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

Protocolo: MCP sobre HTTP transmisible (JSON-RPC 2.0). Todas las respuestas son cargas útiles JSON únicas.

Autenticación: no es necesaria.

Herramientas disponibles

Las 6 herramientas no tienen estado y no requieren el contexto de la conversación ni la administración de la sesión. Todas las definiciones de herramientas, incluidos los input/output esquemas completos, están disponibles mediante programación a través del punto final MCP estándar. tools/list Los esquemas devueltos por tools/list son la fuente de información canónica y siempre actualizada para los nombres, tipos y restricciones de los parámetros.

En la siguiente tabla se resume cada herramienta y si es de solo lectura.

Guía de integración

Puede integrarse con el servidor AWS Marketplace MCP de dos maneras: mediante un conector Claude sin código o mediante un cliente MCP programático.

Claude Connector (recomendado)

La forma más rápida de utilizar las herramientas AWS Marketplace MCP es a través del AWS Marketplace conector Claude. Esto no requiere codificación ni configuración de un cliente MCP: Claude se encarga de descubrir e invocar las herramientas automáticamente.

Configuración:

Para obtener más información sobre el funcionamiento de los conectores, consulte Uso de conectores para ampliar las capacidades de Claude.

Ejemplos de indicaciones:

Integración de clientes MCP

Para integraciones programáticas o marcos de agentes personalizados, conéctese directamente al punto final MCP.

Requisitos previos

Para empezar, necesita lo siguiente:

Paso 1: Configurar el cliente MCP

Utilice un cliente MCP estándar que admita el transporte HTTP.

Punto de conexión:

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

Se admiten los siguientes métodos:

Autenticación: no se requiere autenticación. Omita los encabezados de autenticación en las solicitudes HTTP.

Paso 2: Obtenga y registre las herramientas (descubrimiento de herramientas)

Todas las definiciones de herramientas están disponibles mediante programación mediante el método tools/list MCP estándar. Esta es la forma recomendada de obtener los esquemas actuales, ya que input/output los esquemas de las herramientas se pueden actualizar independientemente de esta documentación. Llame tools/list una vez durante la inicialización y registre las herramientas devueltas en el manifiesto de herramientas de su agente o en el indicador del sistema.

El siguiente ejemplo muestra una tools/list solicitud.

Solicitud:

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

Respuesta (abreviada):

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

Cada entrada de la herramienta incluye la herramientaname, una guía de uso detallada description y ejemplos, y una completa inputSchema con los tipos de parámetros, las restricciones y las reglas de validación.

Paso 3: Configurar la telemetría

AWS Marketplace El MCP requiere un identificador estable en cada llamada a la herramienta para solicitar correlación y telemetría. No se trata de una credencial de autenticación, sino que se utiliza únicamente para el diagnóstico y el análisis.

Pase el identificador en el encabezado HTTP personalizado:

Mcp-Session-Id: <stable-id>

Transporte HTTP

AWS Marketplace MCP utiliza el transporte HTTP, en el que el servidor funciona como un servicio HTTP independiente que puede gestionar múltiples conexiones de clientes.

Las características clave del transporte son las siguientes:

Encabezados HTTP necesarios:

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

El siguiente ejemplo muestra una solicitud y una respuesta a una llamada a una herramienta.

Ejemplo de solicitud:

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

Ejemplo de respuesta:

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

Detalles de la herramienta

En esta sección se describen los parámetros de entrada, el formato de salida y la guía de uso de cada herramienta.

get_aws_marketplace_report_guidelines

Devuelve las instrucciones del flujo de trabajo y la plantilla de formato de salida para un tipo de informe determinado. Llame primero a esta opción para cualquier flujo de trabajo de recomendación, comparación o evaluación.

Esta herramienta devuelve diferentes solicitudes en función de las capacidades del cliente: los clientes con búsquedas web nativas reciben solicitudes con consultas de búsqueda integradas en lugar de referencias a research_aws_marketplace_solution herramientas.

Entrada:

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

En la siguiente tabla se describen los parámetros de entrada.

Salida:

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

En la siguiente tabla se describen los campos de salida.

Cuándo usar cada flujo de trabajo:

search_aws_marketplace_solutions

Realiza una búsqueda directa en la API del catálogo. AWS Marketplace Devuelve resultados sin procesar, sin clasificar ni filtrar sin procesamiento de IA ni puntuación de relevancia. Admite consultas por lotes (hasta 10) y paginación basada en cursores para consultas individuales.

Entrada:

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

En la siguiente tabla se describen los parámetros de entrada.

Salida:

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

En la siguiente tabla se describen los campos de salida.

Comportamiento por lotes: en el caso de consultas múltiples, los resultados se combinan y deduplican mediante. solution_id El cursor de paginación no se devuelve para las solicitudes por lotes.

Paginación: si next_cursor se devuelve (solo solicitudes de consulta única), devuélvalo como cursor parámetro para recuperar resultados adicionales. Cuando next_cursor esnull, se han recuperado todas las soluciones coincidentes.

get_aws_marketplace_solution

Realiza una llamada directa a la API Catalog. AWS Marketplace Recupera metadatos completos de la solución por ID de solución sin procesamiento de IA. Admite solicitudes por lotes (hasta 10 ID).

Entrada:

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

En la siguiente tabla se describen los parámetros de entrada.

Salida:

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

En la siguiente tabla se describen los campos de salida.

En la siguiente tabla se describen los campos de cada SolutionOutput objeto.

get_aws_marketplace_related_solutions

Realiza una llamada directa a la API Catalog. AWS Marketplace Muestra las soluciones relacionadas con determinados identificadores de solución AWS Marketplace, ordenadas por puntuación de relación (descendente), sin análisis de IA ni puntuación de relevancia. Admite solicitudes por lotes (hasta 10 ID).

Entrada:

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

En la siguiente tabla se describen los parámetros de entrada.

Salida:

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

En la siguiente tabla se describen los campos de salida.

research_aws_marketplace_solution

Realiza una investigación profunda sobre las soluciones en la web. AWS Marketplace Realiza búsquedas en la web para cada sección solicitada y devuelve contenido con enlaces de citas en línea. Admite solicitudes por lotes (hasta 5 ID).

Visibilidad: esta herramienta está oculta para los clientes con capacidad de búsqueda web nativa (por ejemplo, Anthropic/ClaudeAI). En su lugar, esos clientes reciben mensajes de flujo de trabajo con consultas de búsqueda integradas.

Entrada:

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

En la siguiente tabla se describen los parámetros de entrada.

En la siguiente tabla se describen todas las secciones de investigación disponibles.

Salida:

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

En la siguiente tabla se describen los campos de salida.

Concurrencia: las soluciones se investigan en paralelo. Las secciones de cada solución son secuenciales para evitar sobrecargar los servicios posteriores.

submit_aws_marketplace_feedback

Envía los comentarios de los usuarios sobre un informe. AWS Marketplace Utilice esta herramienta después de completar cualquier flujo de trabajo de recomendación, comparación o evaluación.

Entrada:

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

En la siguiente tabla se describen los parámetros de entrada.

Salida:

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

Flujos de trabajo

El servidor AWS Marketplace MCP admite tres flujos de trabajo principales para la investigación de productos y las búsquedas directas en el catálogo.

Generación de informes (recomendaciones, comparaciones, evaluaciones)

Este es el flujo de trabajo principal para la investigación de AI-assisted productos. Se utiliza get_aws_marketplace_report_guidelines como punto de entrada a la orquestación.

Flujo:

Flujo de trabajo de recomendaciones:

Flujo de trabajo de comparación:

Flujo de trabajo de evaluación:

Búsqueda directa en el catálogo

Para realizar integraciones programáticas o búsquedas rápidas que no requieran un análisis de IA, puedes utilizar directamente las herramientas de la API del catálogo sin necesidad de recurrir a ellas. get_aws_marketplace_report_guidelines

Búsqueda y, a continuación, búsqueda detallada:

Recopilación de comentarios

Después de completar cualquier flujo de trabajo, el asistente debe recopilar los comentarios de los usuarios.

End-to-end ejemplo

El siguiente ejemplo muestra un flujo de trabajo de recomendaciones completo, desde la consulta inicial hasta el envío de los comentarios.

Paso 1: Obtenga las instrucciones del flujo de trabajo:

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

Paso 2: Busque las soluciones candidatas:

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

Paso 3: Recupere los metadatos detallados de los principales candidatos:

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

Paso 4: Enviar los comentarios de los usuarios:

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

Gestión de errores

Los errores se dividen en tres categorías: errores de protocolo, errores de ejecución de la herramienta y errores de validación.

Errores de protocolo

Los errores de protocolo se devuelven cuando la solicitud infringe la especificación JSON-RPC o la especificación MCP (por ejemplo, JSON con un formato incorrecto, campos obligatorios faltantes o métodos desconocidos).

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

Errores de ejecución de la herramienta

Los errores de ejecución de la herramienta se devuelven cuando la invocación de una herramienta falla en tiempo de ejecución (por ejemplo, cuando se limita la velocidad, si los identificadores de solución no son válidos o si se producen errores en el servicio inicial). Los errores de las herramientas se notifican dentro del objeto de resultado, no como errores a nivel del protocolo MCP, por lo que el asistente de IA puede ver y gestionar el error.

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

Errores de validación

Los errores de validación se devuelven cuando la entrada no supera la validación del esquema (por ejemplo, si el formato del identificador de la solución no es válido, se supera la longitud máxima de la matriz o faltan campos obligatorios). Aparecen como errores de ejecución de la herramienta conisError: true.