View a markdown version of this page

Sobre o AWS Marketplace Servidor MCP - AWS Marketplace

A referência da API do AWS Marketplace foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a Referência de API do AWS Marketplace.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Sobre o AWS Marketplace Servidor MCP

AWS Marketplace O Model Context Protocol (MCP) fornece AI-powered ferramentas para AWS Marketplace descoberta, avaliação, pesquisa e geração de propostas. O MCP é um protocolo padronizado que permite que assistentes de IA interajam com sistemas externos por meio do seguinte:

  • Ferramentas: funções que os modelos de IA podem invocar para realizar ações.

  • Recursos: dados e contexto que podem ser compartilhados com modelos de IA.

Todas as ferramentas não têm estado — cada chamada é independente, sem nenhum estado de conversação do lado do servidor.

Exemplos de casos de uso

Veja a seguir formas comuns de usar o servidor AWS Marketplace MCP:

  • Encontre produtos que atendam às necessidades comerciais usando consultas em linguagem natural.

  • Avalie vários fornecedores rapidamente com relatórios de AI-generated comparação.

  • Crie propostas de compra abrangentes adaptadas às necessidades da empresa.

  • Obtenha análises lado a lado de soluções concorrentes.

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

Protocolo: MCP sobre HTTP Streamable (JSON-RPC 2.0). Todas as respostas são cargas JSON únicas.

Autenticação: Não é necessária.

Ferramentas disponíveis

Todas as 6 ferramentas não têm estado e não exigem contexto de conversação. Todas as definições de ferramentas, incluindo input/output esquemas completos, estão disponíveis programaticamente por meio do endpoint MCP padrão. tools/list Os esquemas tools/list retornados por são a fonte de verdade canônica e sempre atual para nomes, tipos e restrições de parâmetros.

A tabela a seguir resume cada ferramenta e se ela é somente para leitura.

Nome da ferramenta Description Read-only
get_aws_marketplace_report_guidelines Retorna instruções do fluxo de trabalho e modelos de formato de relatório para recomendações, comparações ou avaliações. Ligue primeiro para qualquer fluxo de trabalho de relatório. Sim
search_aws_marketplace_solutions Pesquisa o AWS Marketplace catálogo por meio de consultas. Suporta consultas em lote (até 10) e paginação baseada em cursor. Sim
get_aws_marketplace_solution Obtém metadados detalhados da solução por IDs de solução (avaliações, preços, opiniões, classificações, CTAs). Sim
get_aws_marketplace_related_solutions Obtém soluções relacionadas para determinados IDs de solução, classificadas por pontuação de relação. Sim
research_aws_marketplace_solution Realiza pesquisas profundas na web sobre soluções (recursos, análises, limitações, concorrentes, preços, integrações, estudos de caso). Escondido de clientes com pesquisa nativa na web. Sim
submit_aws_marketplace_feedback Envia feedback do usuário (positive/negative) sobre a qualidade do relatório. Não

Guia de integração

Você pode se integrar ao servidor AWS Marketplace MCP de duas maneiras: por meio de um conector Claude sem código ou por meio de um cliente MCP programático.

Conector Claude (recomendado)

A maneira mais rápida de usar as ferramentas AWS Marketplace MCP é por meio do AWS Marketplace conector para Claude. Isso não requer codificação ou configuração do cliente MCP — Claude lida com a descoberta e a invocação de ferramentas automaticamente.

Configuração:

  1. Abra o AWS Marketplace conector no Diretório de Conectores Claude.

  2. Escolha Connect para habilitá-lo.

  3. Em qualquer conversa de Claude, escolha o botão + (canto inferior esquerdo) ou digite/para abrir o menu.

  4. Passe o mouse sobre Conectores e ative. AWS Marketplace

  5. Peça a Claude para encontrar, comparar ou avaliar AWS Marketplace produtos — ele usa automaticamente as ferramentas MCP.

Para obter mais detalhes sobre como os conectores funcionam, consulte Usar conectores para ampliar os recursos de Claude.

Exemplos de solicitações:

  • “Encontre as melhores soluções de SIEM AWS Marketplace para uma empresa de médio porte”

  • “Compare o Datadog com o New Relic em” AWS Marketplace

  • “Crie um relatório de avaliação para o Terraform Cloud on AWS Marketplace”

Integração de clientes MCP

Para integrações programáticas ou estruturas de agentes personalizadas, conecte-se diretamente ao endpoint MCP.

Pré-requisitos

Você precisa do seguinte para começar:

  1. Uma estrutura de MCP-compatible agente ou cliente.

  2. Um cliente HTTP capaz de fazer solicitações JSON-RPC 2.0.

Etapa 1: Configurar o cliente MCP

Use um cliente MCP padrão que ofereça suporte ao transporte HTTP.

Endpoint:

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

Há suporte para os seguintes métodos:

  • POSTcom method: "initialize" — Inicialize a sessão e obtenhaMcp-Session-Id.

  • POSTcom method: "tools/list" — Descubra as ferramentas disponíveis e seus esquemas.

  • POSTcom method: "tools/call" — Invoque uma ferramenta.

Identificador de sessão: este servidor usa sessões MCP, conforme definido pelo transporte HTTP Streamable na especificação MCP, versão 2025-06-18. A resposta a initialize inclui um Mcp-Session-Id cabeçalho, e os clientes MCP o enviam a cada solicitação posterior. Se você mesmo criar solicitações, também deverá enviá-las. Solicitações sem o cabeçalho falham com HTTP 400. As solicitações falharão com HTTP 404 se o identificador não tiver sido emitido pelo servidor ou se tiver expirado. Se você receber um 404, ligue initialize novamente.

Mcp-Session-Id: <stable-id>

Autenticação: Nenhuma autenticação é necessária. Omita os cabeçalhos de autenticação nas solicitações HTTP.

Etapa 2: Obter e registrar ferramentas (descoberta de ferramentas)

Todas as definições de ferramentas estão disponíveis programaticamente por meio do método tools/list MCP padrão. Essa é a forma recomendada de obter os input/output esquemas atuais, pois os esquemas das ferramentas podem ser atualizados independentemente dessa documentação. Ligue tools/list uma vez durante a inicialização e registre as ferramentas devolvidas no manifesto de ferramentas do seu agente ou no prompt do sistema.

O exemplo a seguir mostra uma tools/list solicitação.

Solicitação:

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

Resposta (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 da ferramenta inclui a ferramentaname, uma detalhada description com orientações de uso e exemplos e uma completa inputSchema com tipos de parâmetros, restrições e regras de validação.

Transporte HTTP

AWS Marketplace O MCP usa transporte HTTP, em que o servidor opera como um serviço HTTP independente que pode lidar com várias conexões de clientes.

A seguir estão as principais características de transporte:

  • HTTP POST para solicitações: cada mensagem do cliente é enviada como uma nova solicitação HTTP POST.

  • Respostas JSON: todas as ferramentas retornam respostas JSON ()Content-Type: application/json.

  • Gerenciamento de sessão: o servidor emite um identificador na resposta initialize a. Envie-o no Mcp-Session-Id cabeçalho em cada solicitação posterior.

  • Versão do protocolo: O servidor suporta a versão 2025-06-18 da especificação MCP.

Cabeçalhos HTTP necessários:

Content-Type: application/json Accept: application/json, text/event-stream Mcp-Session-Id: <stable-id> MCP-Protocol-Version: 2025-06-18

O exemplo a seguir mostra uma solicitação e resposta de chamada de ferramenta.

Exemplo de solicitação:

POST /mcp HTTP/1.1 Content-Type: application/json Accept: application/json, text/event-stream Mcp-Session-Id: 00000000-0000-0000-0000-000000000000 MCP-Protocol-Version: 2025-06-18 { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "search_aws_marketplace_solutions", "arguments": { "queries": ["SIEM solutions"] } } }

Exemplo de resposta:

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

Detalhes da ferramenta

Esta seção descreve os parâmetros de entrada, o formato de saída e as diretrizes de uso de cada ferramenta.

get_aws_marketplace_report_guidelines

Retorna instruções de fluxo de trabalho e modelo de formato de saída para um determinado tipo de relatório. Ligue primeiro para qualquer fluxo de trabalho de recomendação, comparação ou avaliação.

Essa ferramenta retorna solicitações diferentes, dependendo dos recursos do cliente — clientes com pesquisa nativa na Web recebem solicitações com consultas de pesquisa incorporadas em vez de referências de research_aws_marketplace_solution ferramentas.

Entrada:

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

A tabela a seguir descreve os parâmetros de entrada.

Campo Tipo Obrigatório Description
workflow_type enum Sim "recommendations"para descoberta de produtos classificados, "comparison" para análise lado a lado, "evaluation" para avaliação de um único produto.

Saída:

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

A tabela a seguir descreve os campos de saída.

Campo Tipo Description
workflow_type string O tipo de fluxo de trabalho solicitado.
guidelines string Instruções de fluxo de trabalho combinadas e modelo de formato markdown.

Quando usar cada fluxo de trabalho:

  • recomendações — “encontre ferramentas de monitoramento”, “Preciso de uma CI/CD solução”, “escaneamento SOC2-compliant de segurança abaixo de $5k/month”.

  • comparação — “compare Datadog com New Relic”, “Splunk vs Elastic para gerenciamento de logs”.

  • avaliação — “criar relatório de avaliação para o Terraform Cloud”, “justificar a compra da New Relic para meu CTO”.

search_aws_marketplace_solutions

Pesquisa AWS Marketplace e retorna uma lista de soluções relevantes com base nas consultas do usuário. Suporta consultas em lote (até 10) e paginação baseada em cursor para consultas únicas.

Entrada:

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

A tabela a seguir descreve os parâmetros de entrada.

Campo Tipo Obrigatório Description
queries string[] Sim Conjunto de consultas de pesquisa (1-10). Também aceita legado query (string única, convertida automaticamente em matriz).
max_results número Não Máximo de resultados por consulta (1-100, padrão: 10).
cursor string Não Cursor de paginação (funciona apenas para uma única consulta, ignorado para lote).

Saída:

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

A tabela a seguir descreve os campos de saída.

Campo Tipo Description
results MinimalSolutionMetadata[] Conjunto de soluções correspondentes.
next_cursor string | nulo Cursor de paginação para a próxima página (somente consulta única). nullquando não há mais resultados.

Comportamento em lote: para várias consultas, os resultados são combinados e desduplicados por. solution_id O cursor de paginação não é retornado para solicitações em lote.

Paginação: se next_cursor for retornada (somente solicitações de consulta única), passe-a de volta como cursor parâmetro para recuperar resultados adicionais. Quando next_cursor estivernull, todas as soluções correspondentes foram recuperadas.

solução get_aws_marketplace_

Recupera metadados abrangentes da solução por ID da solução, incluindo avaliações, opções de preços e links de call to action. Suporta solicitações em lote (até 10 IDs).

Entrada:

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

A tabela a seguir descreve os parâmetros de entrada.

Campo Tipo Obrigatório Description
solution_ids string[] Sim Conjunto de IDs de solução (1-10). Os IDs começam comprodview-. Também aceita legado solution_id (string única, convertida automaticamente).

Saída:

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

A tabela a seguir descreve os campos de saída.

Campo Tipo Description
solutions SolutionOutput[] Conjunto de detalhes da solução (sempre matriz, mesmo para ID única).

A tabela a seguir descreve os campos em cada SolutionOutput objeto.

Campo Tipo Description
solution_idstringAWS Marketplace ID da solução.
solution_namestringNome do produto
solution_descriptionstringDescrição longa ou curta.
solution_urlstringURL do Marketplace com tags ref.
vendor_namestringNome de exibição do fornecedor.
vendor_urlstringURL do perfil do fornecedor com tags ref.
highlightsstring[]Destaques do produto.
reviews_summaryobjeto{ reviews_count, average_rating }
review_sentimentsReviewSentiment[]Sentimento por categoria (funcionalidade, facilidade de uso, atendimento ao cliente, custo_efetividade) com pontuações de polaridade e análises de amostras.
free_trial_availablebooleano?Se um teste gratuito está disponível.
pricing_optionsPricingOption[]{ name, description }pares.
fulfillment_options_typesstring []?Tipos de atendimento, como SaaS, Container ou AMI.
categoriesstring []?Categorias como “Monitoramento e observabilidade”.
security_certificatesstring []?Certificações como “SOC 2 Tipo II” ou “ISO 27001".
rankingsClassificação []?{ category, rank }— classificação dentro da categoria (1-100).
has_standard_contractbooleano?Se o produto é compatível com o contrato AWS padrão.
call_to_actionCallToAction{ procurement_url, request_for_demo_url, request_for_private_offer_url, procure_free_trial_url }

Retorna soluções relacionadas para determinados IDs de solução, conforme identificados por AWS Marketplace, classificados por pontuação de relação (decrescente). Suporta solicitações em lote (até 10 IDs).

Entrada:

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

A tabela a seguir descreve os parâmetros de entrada.

Campo Tipo Obrigatório Description
solution_ids string[] Sim Conjunto de IDs de solução (1-10). Também aceita legado solution_id (string única, convertida automaticamente).

Saída:

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

A tabela a seguir descreve os campos de saída.

Campo Tipo Description
resultsSingleRelatedSolutionsResult[]Uma entrada por ID da solução de entrada.
results[].solution_idstringO ID da solução de entrada.
results[].related_solutionsMinimalSolutionMetadata[]Soluções relacionadas classificadas por pontuação de relação (decrescente).

Se um ID de solução não tiver soluções relacionadas, sua related_solutions matriz estará vazia. As soluções relacionadas que não estão mais listadas são omitidas.

Research_aws_marketplace_solution

Realiza pesquisas profundas na web sobre AWS Marketplace soluções. Executa pesquisas na web para cada seção solicitada e retorna conteúdo com links de citação embutidos. Suporta solicitações em lote (até 5 IDs).

Visibilidade: Essa ferramenta está oculta para clientes com capacidade nativa de pesquisa na web (por exemplo, Anthropic/ClaudeAI). Em vez disso, esses clientes recebem solicitações de fluxo de trabalho com consultas de pesquisa incorporadas.

Entrada:

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

A tabela a seguir descreve os parâmetros de entrada.

Campo Tipo Obrigatório Description
solution_ids string[] Sim Matriz de IDs de solução no prodview-* formato (1-5).
sections ResearchSection[] Não Seções para pesquisar. Padrão: todas as 7 seções.

A tabela a seguir descreve cada seção de pesquisa disponível.

Seção O que ele retorna
featuresDocumentação oficial, capacidades e especificações
reviewsG2 e avaliações de PeerSpot clientes
limitationsProblemas conhecidos, desvantagens, críticas
competitorsPosicionamento competitivo, alternativas
pricingInformações de custo, modelos de preços, níveis
integrationsAWS ecossistema, APIs, ferramentas de terceiros
case_studiesHistórias de sucesso de clientes, depoimentos, ROI

Saída:

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

A tabela a seguir descreve os campos de saída.

Campo Tipo Description
resultsSingleResearchResult[]Uma entrada por ID da solução de entrada.
results[].solution_idstringO ID da solução pesquisada.
results[].solution_namestringNome do produto resolvido a partir do ID da solução.
results[].researchobjetoObjeto com chaves para cada seção solicitada.
results[].research[section].contentstringPesquise conteúdo com links de citação embutidos.
results[].research[section].citationsCitação []{ index, title, url }para cada citação.

Concorrência: as soluções são pesquisadas paralelamente. As seções de cada solução são sequenciais para evitar sobrecarregar os serviços posteriores.

submit_aws_marketplace_feedback

Envia feedback do usuário sobre um AWS Marketplace relatório. Ligue para essa ferramenta depois de concluir qualquer fluxo de trabalho de recomendação, comparação ou avaliação.

Entrada:

{ "sentiment": "negative", "categories": ["Incomplete", "Other"], "feedback_text": "Missing pricing details" }

A tabela a seguir descreve os parâmetros de entrada.

Campo Tipo Obrigatório Description
sentiment enum Sim "positive" ou "negative".
categories string[] Não Para feedback negativo:"Irrelevant","Incomplete","Inaccurate","Other".
feedback_text string Não Free-form texto (máximo de 1000 caracteres).

Saída:

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

Fluxos de trabalho

O servidor AWS Marketplace MCP oferece suporte a três fluxos de trabalho principais para pesquisa de produtos e pesquisas diretas de catálogos.

Geração de relatórios (recomendações, comparações, avaliações)

Esse é o fluxo de trabalho principal para pesquisa de AI-assisted produtos. Ele é usado get_aws_marketplace_report_guidelines como ponto de entrada da orquestração.

Fluxo:

  1. Ligue get_aws_marketplace_report_guidelines com o apropriadoworkflow_type.

  2. A ferramenta retorna instruções de fluxo de trabalho passo a passo e um modelo de formato de saída.

  3. O assistente de IA segue as instruções retornadas, que normalmente envolvem chamar as ferramentas de pesquisa, detalhes da solução e pesquisa para coletar dados.

  4. O assistente gera um relatório formatado seguindo o modelo de saída.

  5. Depois de entregar o relatório, o assistente coleta o feedback do usuário por meio submit_aws_marketplace_feedback de.

Fluxo de trabalho de recomendações:

  1. get_aws_marketplace_report_guidelines({ workflow_type: "recommendations" })

  2. search_aws_marketplace_solutions({ queries: ["Product A", "Product B"], max_results: 3 })

  3. Escreva o relatório seguindo o modelo de formato.

  4. submit_aws_marketplace_feedback({ sentiment: "positive" })

Fluxo de trabalho de comparação:

  1. get_aws_marketplace_report_guidelines({ workflow_type: "comparison" })

  2. get_aws_marketplace_solution({ solution_ids: ["prodview-abc", "prodview-xyz"] })

  3. research_aws_marketplace_solution({ solution_ids: [...], sections: ["features", "integrations"] })

  4. Crie uma matriz de comparação e escreva o relatório seguindo o modelo de formato.

  5. submit_aws_marketplace_feedback({ sentiment: "positive" })

Fluxo de trabalho de avaliação:

  1. get_aws_marketplace_report_guidelines({ workflow_type: "evaluation" })

  2. get_aws_marketplace_solution({ solution_ids: ["prodview-target"] })

  3. research_aws_marketplace_solution({ solution_ids: ["prodview-target"], sections: ["features", "reviews", "limitations", "case_studies"] })

  4. Escreva o relatório de avaliação seguindo o modelo de formato.

  5. submit_aws_marketplace_feedback({ sentiment: "positive" })

Pesquisa direta de catálogo

Para integrações programáticas ou pesquisas rápidas que não exijam análise de IA, você pode ligar diretamente para as ferramentas de pesquisa, detalhes da solução e soluções relacionadas, sem precisar. get_aws_marketplace_report_guidelines

Pesquisa e, em seguida, pesquisa de detalhes:

  1. Ligue search_aws_marketplace_solutions com uma ou mais consultas de palavras-chave.

  2. Use os solution_id valores retornados get_aws_marketplace_solution para solicitar detalhes completos.

  3. Opcionalmente, ligue get_aws_marketplace_related_solutions para descobrir produtos relacionados.

Coleção de feedback

Depois de concluir qualquer fluxo de trabalho, o assistente deve coletar o feedback do usuário.

  1. Pergunte ao usuário se a resposta foi útil.

  2. Se positivo, ligue submit_aws_marketplace_feedback comsentiment: "positive".

  3. Se for negativo, pergunte quais categorias se aplicam (Irrelevant,Incomplete,Inaccurate,Other), opcionalmente, colete feedback em texto livre e envie.

End-to-end exemplo

O exemplo a seguir demonstra um fluxo de trabalho completo de recomendações, desde a consulta inicial até o envio do feedback.

Etapa 1 — Obtenha instruções sobre o fluxo de trabalho:

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

Etapa 2 — Procure soluções 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 } } }

Etapa 3 — Recupere metadados detalhados dos principais candidatos:

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

Etapa 4 — Envie o feedback do usuário:

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

Tratamento de erros

Os erros se enquadram em três categorias: erros de protocolo, erros de validação de entrada e erros de execução de ferramentas.

Erros de protocolo

Os erros de protocolo são retornados como um JSON-RPC error objeto quando a solicitação não pode ser processada como uma solicitação MCP. Eles têm dois tipos de causa: o Mcp-Session-Id cabeçalho e um método não suportado.

Os erros de sessão são retornados antes da execução de qualquer ferramenta. Causas comuns:

  • O Mcp-Session-Id cabeçalho está ausente: HTTP 400.

  • O identificador está incorreto (não é um UUID v4 ou JWT): HTTP 400.

  • O servidor não emitiu o identificador: HTTP 404.

  • O identificador expirou: HTTP 404.

Uma falta Mcp-Session-Id retorna HTTP 400:

{ "jsonrpc": "2.0", "error": { "code": -32600, "message": "Bad Request: mcp-session-id header is required" }, "id": null }

Um identificador desconhecido ou expirado retorna HTTP 404:

{ "jsonrpc": "2.0", "error": { "code": -99999, "message": "Bad Request: Invalid or expired session ID" }, "id": null }

Para resolver um erro de sessão, ligue initialize novamente e repita a solicitação com o novoMcp-Session-Id.

Métodos não suportados retornam HTTP 200 com um JSON-RPC error objeto. O exemplo a seguir mostra um método desconhecido.

{ "jsonrpc": "2.0", "id": 10, "error": { "code": -32601, "message": "Method not found" } }

Erros de validação de entrada

Os erros de validação de entrada são retornados quando os argumentos de uma chamada de ferramenta falham na validação do esquema (por exemplo, um campo obrigatório ausente, um valor inválido ou um tamanho máximo de matriz excedido). Um nome de ferramenta desconhecido é retornado da mesma forma. Esses são erros de ferramenta, não de protocolo: a resposta tem isError: true e o texto começa comMCP error -32602: Input validation error, seguido por uma entrada para cada campo com falha. Cada entrada inclui o path do campo e, para valores de enumeração, o permitidooptions.

O exemplo a seguir mostra uma chamada para search_aws_marketplace_solutions sem o queries campo obrigatório.

{ "jsonrpc": "2.0", "id": 11, "result": { "content": [ { "type": "text", "text": "MCP error -32602: Input validation error: Invalid arguments for tool search_aws_marketplace_solutions: [ { \"code\": \"invalid_type\", \"expected\": \"array\", \"received\": \"undefined\", \"path\": [\"queries\"], \"message\": \"Required\" } ]" } ], "isError": true } }

Erros de execução da ferramenta

Os erros de execução da ferramenta são retornados quando uma invocação da ferramenta falha em tempo de execução (por exemplo, limitação de taxa, IDs de solução inválidos ou erros de serviço upstream). Os erros da ferramenta são relatados no objeto resultante, não como erros no nível do protocolo MCP, para que o assistente de IA possa ver e lidar com o erro.

O exemplo a seguir mostra uma chamada para get_aws_marketplace_solution com um ID de solução que não existe.

{ "jsonrpc": "2.0", "id": 12, "result": { "content": [ { "type": "text", "text": "{\"error\":{\"type\":\"ValidationException\",\"message\":\"Solution not found: prodview-doesnotexist\",\"code\":\"INVALID_FIELD_VALUE\"}}" } ], "structuredContent": { "error": { "type": "ValidationException", "message": "Solution not found: prodview-doesnotexist", "code": "INVALID_FIELD_VALUE" } }, "isError": true } }