A referência Central de Parceiros da AWS da API foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a Referência Central de Parceiros da AWS da API.
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
Esta página fornece a referência completa para conexão e configuração do servidor MCP do Partner Central Agent.
Endpoint
| Propriedade | Valor |
|---|---|
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp |
| Região | us-east-1(Norte da Virgínia) somente |
| Protocolo | JSON-RPC 2.0 por HTTPS |
| Streaming | Server-Sent Eventos (SSE) |
| Autenticação | AWS Assinatura versão 4 |
| Nome do serviço SigV4 | partnercentral-agents-mcp |
| Requisito de TLS | TLS 1.2 ou superior |
Permissões do IAM
Todas as ações do IAM usam o partnercentral: prefixo, a menos que indicado de outra forma.
Acesso ao protocolo MCP
Como uma AWS identidade autenticada, você tem acesso de protocolo ao servidor MCP por padrão. Você não precisa de uma permissão de IAM explícita para acesso ao protocolo.
Para a autenticação OAuth, as seguintes permissões de login são necessárias:
| Ação | Description |
|---|---|
signin:AuthorizeOAuth2Access |
Autoriza o fluxo OAuth baseado em navegador |
signin:CreateOAuth2Token |
Emite e atualiza tokens de acesso OAuth |
Para restringir o acesso ao MCP, aplique uma negação explícita ativada. partnercentral:InvokeMcp
Gestão de oportunidades
| Ação | Description |
|---|---|
partnercentral:List* |
Liste 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 |
Atribuir uma oportunidade a um representante do parceiro |
partnercentral:AssociateOpportunity |
Vincular 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çã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 |
Recuperar 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çã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
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 atual do perfil () 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 de perfil assíncrona pendente |
partnercentral:StartProfileUpdateTask |
Enviar uma atualização de perfil de parceiro (assíncrona) |
partnercentral:CancelProfileUpdateTask |
Cancelar uma tarefa pendente de atualização de perfil |
partnercentral:PutProfileVisibility |
Alterar a visibilidade do perfil para PÚBLICA ou PRIVADA |
partnercentral:PutAllianceLeadContact |
Atualize o contato principal da aliança (nome, título, e-mail) |
partnercentral:SendEmailVerificationCode |
Envie um código de verificação para alterações por e-mail domain/contact |
partnercentral:AssociateAwsTrainingCertificationEmailDomain |
Vincule um domínio de e-mail para rastreamento de certificação 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 |
Verificar 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 de Autorização de Revenda do Marketplace existe |
iam:CreateServiceLinkedRole |
Criar o perfil do AWSServiceRoleForMarketplaceResaleAuthorization |
Ambientes de catálogo
| 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
| 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
| 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-escrever somente arquivos |
| 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
Faça o upload do arquivo para o bucket apropriado do S3 com o prefixo de ID AWS da sua conta.
Observe o URI do S3, incluindo o
versionIdretornado pelo upload.Inclua o arquivo como um bloco de
documentconteúdo em suasendMessagechamada.
Exemplo de formato URI do S3:
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
Códigos de erro
| 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. Novas tentativas com 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
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)
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 stream estabelecida |
assistant-response.start |
O agente começou a gerar uma resposta |
assistant-response.delta |
Parte incremental do texto 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 da invocação de uma 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
Referência de ferramentas — documentação detalhada para
sendMessageegetSessionferramentas
