A referência AWS Partner Central da API foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a [Referência AWS Partner Central da API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).

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á.

# Referência da configuração
<a name="mcp-configuration-reference"></a>

Esta página fornece a referência completa para conexão e configuração do Partner Central Agent MCP Server.

## Endpoint
<a name="mcp-config-endpoint"></a>


| Propriedade | Valor | 
| --- | --- | 
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp | 
| Região | us-east-1Apenas (Norte da Virgínia) | 
| Protocolo | JSON-RPC 2.0 sobre HTTPS | 
| Streaming | Server-Sent Eventos (SSE) | 
| Autenticação | AWS Signature versão 4 | 
| Nome do serviço SigV4 | partnercentral-agents-mcp | 
| Requisito de TLS | TLS 1.2 ou superior | 

## Permissões do IAM
<a name="mcp-config-iam-permissions"></a>

Todas as ações do IAM usam o `partnercentral:` prefixo, salvo indicação em contrário.

### Acesso ao protocolo MCP
<a name="mcp-config-protocol-access"></a>

A maneira mais simples de conceder acesso ao protocolo MCP é anexar a política `AWSMcpServiceActionsFullAccess` gerenciada à sua identidade do IAM. Essa política inclui todas as permissões necessárias para interagir com o servidor MCP. Para um controle refinado, você pode usar a chave de `aws:IsMcpServiceAction` condição em suas políticas do IAM para definir o escopo de permissões especificamente para ações de serviço MCP.


| Ação | Description | 
| --- | --- | 
| partnercentral:UseSession | Crie, atualize e recupere sessões de conversação | 

### Gerenciamento de oportunidades
<a name="mcp-config-opportunity-management"></a>


| Ação | Description | 
| --- | --- | 
| partnercentral:List\* | Listar oportunidades, soluções e outros recursos do Partner Central | 
| partnercentral:Get\* | Recupere detalhes de oportunidades individuais e outros recursos | 
| partnercentral:CreateOpportunity | Crie uma oportunidade | 
| partnercentral:UpdateOpportunity | Modifique os campos de oportunidade (estágio, data de fechamento, receita etc.) | 
| partnercentral:SubmitOpportunity | Envie uma oportunidade para AWS análise | 
| partnercentral:AssignOpportunity | Atribua uma oportunidade a um representante parceiro | 
| partnercentral:AssociateOpportunity | Vincule uma oportunidade a outro recurso (solução etc.) | 
| partnercentral:DisassociateOpportunity | Remover um link entre uma oportunidade e outro recurso | 
| partnercentral:StartEngagementFromOpportunityTask | Envie oportunidades para iniciar um engajamento a partir de uma oportunidade | 

### Programas de financiamento
<a name="mcp-config-funding-programs"></a>


| Ação | Description | 
| --- | --- | 
| partnercentral:ListBenefitAllocations | Liste as alocações de benefícios disponíveis para sua conta | 
| partnercentral:ListBenefitApplications | Listar os pedidos de benefícios enviados | 
| partnercentral:CreateBenefitApplication | Crie um novo aplicativo de benefícios (MAP, POC, WMP) | 
| partnercentral:GetBenefitApplication | Recupere detalhes de um pedido de benefício específico | 
| partnercentral:UpdateBenefitApplication | Atualizar um pedido de benefício pendente | 
| partnercentral:AssociateBenefitApplicationResource | Vincular um recurso a um aplicativo de benefícios | 
| partnercentral:DisassociateBenefitApplicationResource | Remover um link de recurso de um aplicativo de benefícios | 

### Acesso ao Marketplace
<a name="mcp-config-marketplace-access"></a>


| Ação | Description | 
| --- | --- | 
| aws-marketplace:DescribeEntity | Recuperar detalhes de uma entidade de mercado | 
| aws-marketplace:SearchAgreements | Pesquise contratos de mercado | 
| aws-marketplace:ListEntities | Listar entidades do mercado | 

### Agente de integração
<a name="mcp-config-onboarding-agent"></a>

**Gerenciamento de contas de parceiros (`partnercentral`):**


| Ação | Description | 
| --- | --- | 
| partnercentral:ListPartners | Listar registros de parceiros para a conta | 
| partnercentral:GetPartner | Recupere o registro do parceiro e os detalhes do perfil | 
| partnercentral:GetProfileVisibility | Recuperar a visibilidade do perfil atual () PUBLIC/PRIVATE | 
| partnercentral:GetAllianceLeadContact | Recupere as informações de contato do líder da aliança | 
| partnercentral:GetProfileUpdateTask | Verifique o status de uma atualização pendente do perfil assíncrono | 
| partnercentral:StartProfileUpdateTask | Enviar uma atualização do perfil do parceiro (assíncrona) | 
| partnercentral:CancelProfileUpdateTask | Cancelar uma tarefa pendente de atualização de perfil | 
| partnercentral:PutProfileVisibility | Alterar a visibilidade do perfil para PÚBLICO ou PRIVADO | 
| partnercentral:PutAllianceLeadContact | Atualizar contato do líder da aliança (nome, cargo, e-mail) | 
| partnercentral:SendEmailVerificationCode | Envie um código de verificação para alterações baseadas em e-mail domain/contact  | 
| partnercentral:AssociateAwsTrainingCertificationEmailDomain | Vincule um domínio de e-mail para acompanhamento de certificações de treinamento | 
| partnercentral:DisassociateAwsTrainingCertificationEmailDomain | Remover um domínio de e-mail de certificação de treinamento vinculado | 
| partnercentral:GetAccountConnections | Listar conexões de contas ativas (por exemplo, links subsidiários) | 
| partnercentral:GetConnectionInvitations | Listar convites de conexão enviados e recebidos pendentes | 
| partnercentral:CreateConnectionInvitation | Enviar um convite de conexão para outra AWS conta | 
| partnercentral:CancelConnectionInvitation | Cancelar um convite de conexão de saída pendente | 
| partnercentral:RespondConnectionInvitation | Aceitar ou rejeitar um convite de conexão recebido | 
| partnercentral:CancelConnection | Cancelar uma conexão de conta ativa | 
| partnercentral:ManageConnectionPreferences | Obtenha ou atualize as preferências de compartilhamento entre contas conectadas | 

**Configuração do vendedor do Marketplace (`aws-marketplace`):**


| Ação | Description | 
| --- | --- | 
| aws-marketplace:ListEntities | Listar entidades do Marketplace (por exemplo, entidades vendedoras) | 
| aws-marketplace:DescribeEntity | Recupere todos os detalhes de uma entidade do Marketplace | 
| aws-marketplace:DescribeChangeSet | Verifique o status de um conjunto de alterações enviado | 
| aws-marketplace:StartChangeSet | Envie um conjunto de alterações do Marketplace (por exemplo, atualização do perfil do vendedor) | 

**IAM — função vinculada ao serviço ()`iam`:**


| Ação | Description | 
| --- | --- | 
| iam:GetRole | Verifique se a função vinculada ao serviço Marketplace Resale Authorization existe | 
| iam:CreateServiceLinkedRole | Criar o perfil do AWSServiceRoleForMarketplaceResaleAuthorization | 

## Ambientes de catálogo
<a name="mcp-config-catalog-environments"></a>


| Catálogo | Description | 
| --- | --- | 
| "AWS" | Ambiente de produção. Todas as operações afetam os dados ativos do parceiro. | 
| "Sandbox" | Ambiente de teste isolado. Sem impacto nos dados de produção. Use para desenvolvimento e validação. | 

## Gerenciamento de sessões
<a name="mcp-config-session-management"></a>


| Propriedade | Valor | 
| --- | --- | 
| Formato de ID da sessão | UUID v4 com session- prefixo (por exemplo,) session-550e8400-e29b-41d4-a716-446655440000 | 
| Criação de sessão | Automático na primeira sendMessage chamada sem um sessionId | 
| Expiração da sessão | 48 horas a partir da criação da sessão (expiração absoluta, não baseada em inatividade) | 

## Upload de arquivo
<a name="mcp-config-file-upload"></a>


| Propriedade | Valor | 
| --- | --- | 
| Máximo de arquivos por mensagem | 3 | 
| Limite de tamanho de imagem | 3,75 MB | 
| Limite de tamanho de documentos | 4,5 MB | 
| Extensões permitidas | doc, docx, pdf, png, jpeg, xlsx, csv, txt | 
| Caçamba S3 (produção) | aws-partner-central-marketplace-efemeral-writeonly-files | 
| Caminho de upload | s3://{bucket}/{aws-account-id}/ | 
| Requisito de URI do S3 | Deve incluir o parâmetro versionId de consulta | 

### Carregar fluxo de trabalho
<a name="mcp-config-upload-workflow"></a>

1. Faça upload do arquivo no bucket do S3 apropriado com o prefixo de ID AWS da conta.

1. Observe o URI do S3, incluindo o `versionId` retornado pelo upload.

1. Inclua o arquivo como um bloco de `document` conteúdo na sua `sendMessage` chamada.

Exemplo de formato de URI S3:

```
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
```

## Códigos de erro
<a name="mcp-config-error-codes"></a>


| Código | Name (Nome) | Description | 
| --- | --- | --- | 
| -32001 | AUTHENTICATION\_FAILURE | A assinatura SigV4 é inválida ou as credenciais expiraram | 
| -31004 | TOOL\_PERMISSION\_DENIED | A identidade do IAM não tem a partnercentral: ação necessária para essa operação | 
| -32002 | ACCESS\_DENIED | Acesso geral negado (conta não cadastrada, incompatibilidade de região etc.) | 
| -32004 | LIMIT\_EXCEEDED | Limite de taxa ou cota excedido. Tente novamente com um recuo exponencial. | 
| -30001 | RESOURCE\_NOT\_FOUND | O recurso solicitado (sessão, oportunidade etc.) não existe | 
| -32600 | INVALID\_REQUEST |  JSON-RPC Solicitação malformada ou parâmetros inválidos | 
| -32603 | INTERNAL\_ERROR | Server-side erro. Repetir a solicitação . | 

## Limites de taxa
<a name="mcp-config-rate-limits"></a>

O servidor impõe limites de taxa por conta:


| Operation | Taxa sustentada | Intermitência | 
| --- | --- | --- | 
| sendMessage | 2 solicitações por minuto | 10 | 
| Todas as outras operações | 10 solicitações por minuto | 20 | 

Se você exceder esses limites, o servidor retornará o código de erro `-32004` (LIMIT\_EXCEEDED). Implemente um recuo exponencial com instabilidade em seu cliente para lidar com a limitação de taxas com elegância.

## Tipos de eventos de streaming (SSE)
<a name="mcp-config-sse-events"></a>

Quando `stream` definido como `true` em uma `sendMessage` chamada, o servidor retorna Server-Sent Eventos com estes tipos de eventos:


| Tipo de evento | Description | 
| --- | --- | 
| stream\_start | Conexão de transmissão estabelecida | 
| assistant-response.start | O agente começou a gerar uma resposta | 
| assistant-response.delta | Fragmento de texto incremental da resposta do agente | 
| assistant-response.completed | O agente terminou de gerar a resposta | 
| server-tool-use | O agente está invocando uma ferramenta interna (operação de leitura) | 
| server-tool-response | Resultado de uma invocação de ferramenta interna | 
| tool\_approval\_request | O agente está solicitando aprovação humana para uma operação de gravação | 
| stream\_end | Fechamento da conexão de transmissão | 
| done | Evento final indicando que o fluxo SSE foi concluído | 

## Próximas etapas
<a name="mcp-config-next-steps"></a>
+ [https://docs.aws.amazon.com/partner-central/latest/APIReference/mcp-tools-reference.html](https://docs.aws.amazon.com/partner-central/latest/APIReference/mcp-tools-reference.html) — documentação detalhada `sendMessage` e `getSession` ferramentas