L' AWS Partner Central API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[AWS Partner Central API Reference.](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Informazioni di riferimento sulla configurazione
<a name="mcp-configuration-reference"></a>

Questa pagina fornisce il riferimento completo per la connessione e la configurazione del server MCP Partner Central Agent.

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


| Proprietà | Valore | 
| --- | --- | 
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp | 
| Region | us-east-1(Virginia settentrionale) solo | 
| Protocollo | JSON-RPC 2.0 su HTTPS | 
| Streaming | Server-Sent Eventi (SSE) | 
| Autenticazione | AWS Signature (versione 4) | 
| Nome del servizio SigV4 | partnercentral-agents-mcp | 
| Requisito TLS | TLS 1.2 o versioni successive | 

## autorizzazioni IAM
<a name="mcp-config-iam-permissions"></a>

Tutte le azioni IAM utilizzano il `partnercentral:` prefisso se non diversamente specificato.

### Accesso al protocollo MCP
<a name="mcp-config-protocol-access"></a>

Il modo più semplice per concedere l'accesso al protocollo MCP consiste nell'associare la policy `AWSMcpServiceActionsFullAccess` gestita alla tua identità IAM. Questa policy include tutte le autorizzazioni necessarie per interagire con il server MCP. Per un controllo granulare, puoi utilizzare la chiave `aws:IsMcpServiceAction` condition nelle tue policy IAM per definire le autorizzazioni in modo specifico per le azioni del servizio MCP.


| Azione | Description | 
| --- | --- | 
| partnercentral:UseSession | Crea, aggiorna e recupera sessioni di conversazione | 

### Gestione delle opportunità
<a name="mcp-config-opportunity-management"></a>


| Azione | Description | 
| --- | --- | 
| partnercentral:List\* | Elenca opportunità, soluzioni e altre risorse di Partner Central | 
| partnercentral:Get\* | Recupera i dettagli per opportunità individuali e altre risorse | 
| partnercentral:CreateOpportunity | Crea un'opportunità | 
| partnercentral:UpdateOpportunity | Modifica i campi delle opportunità (fase, data di chiusura, entrate, ecc.) | 
| partnercentral:SubmitOpportunity | Invia un'opportunità di AWS revisione | 
| partnercentral:AssignOpportunity | Assegna un'opportunità a un rappresentante partner | 
| partnercentral:AssociateOpportunity | Collega un'opportunità a un'altra risorsa (soluzione, ecc.) | 
| partnercentral:DisassociateOpportunity | Rimuovi un collegamento tra un'opportunità e un'altra risorsa | 
| partnercentral:StartEngagementFromOpportunityTask | Invia opportunità per avviare un coinvolgimento partendo da un'opportunità | 

### Programmi di finanziamento
<a name="mcp-config-funding-programs"></a>


| Azione | Description | 
| --- | --- | 
| partnercentral:ListBenefitAllocations | Elenca le allocazioni di benefit disponibili per il tuo account | 
| partnercentral:ListBenefitApplications | Elenca le domande di benefit presentate | 
| partnercentral:CreateBenefitApplication | Crea una nuova richiesta di benefit (MAP, POC, WMP) | 
| partnercentral:GetBenefitApplication | Recupera i dettagli di una specifica richiesta di benefit | 
| partnercentral:UpdateBenefitApplication | Aggiorna una richiesta di benefit in sospeso | 
| partnercentral:AssociateBenefitApplicationResource | Collega una risorsa a una richiesta di benefit | 
| partnercentral:DisassociateBenefitApplicationResource | Rimuovere un collegamento a una risorsa da una domanda di benefit | 

### Accesso al Marketplace
<a name="mcp-config-marketplace-access"></a>


| Azione | Description | 
| --- | --- | 
| aws-marketplace:DescribeEntity | Recupera i dettagli di un'entità del marketplace | 
| aws-marketplace:SearchAgreements | Cerca gli accordi del marketplace | 
| aws-marketplace:ListEntities | Elenca le entità del marketplace | 

### Agente di onboarding
<a name="mcp-config-onboarding-agent"></a>

**Gestione degli account partner ()`partnercentral`:**


| Azione | Description | 
| --- | --- | 
| partnercentral:ListPartners | Elenca le registrazioni dei partner per l'account | 
| partnercentral:GetPartner | Recupera la registrazione del partner e i dettagli del profilo | 
| partnercentral:GetProfileVisibility | Recupera la visibilità attuale del profilo () PUBLIC/PRIVATE | 
| partnercentral:GetAllianceLeadContact | Recupera le informazioni di contatto del leader dell'alleanza | 
| partnercentral:GetProfileUpdateTask | Controlla lo stato di un aggiornamento asincrono in sospeso del profilo | 
| partnercentral:StartProfileUpdateTask | Invia un aggiornamento del profilo partner (asincrono) | 
| partnercentral:CancelProfileUpdateTask | Annulla un'attività di aggiornamento del profilo in sospeso | 
| partnercentral:PutProfileVisibility | Cambia la visibilità del profilo in PUBBLICA o PRIVATA | 
| partnercentral:PutAllianceLeadContact | Aggiorna il contatto principale dell'alleanza (nome, titolo, email) | 
| partnercentral:SendEmailVerificationCode | Invia un codice di verifica per le modifiche via e-mail domain/contact  | 
| partnercentral:AssociateAwsTrainingCertificationEmailDomain | Collega un dominio e-mail per il monitoraggio delle certificazioni di formazione | 
| partnercentral:DisassociateAwsTrainingCertificationEmailDomain | Rimuovi un dominio e-mail di certificazione della formazione collegato | 
| partnercentral:GetAccountConnections | Elenca le connessioni attive all'account (ad esempio, link sussidiari) | 
| partnercentral:GetConnectionInvitations | Elenca gli inviti di connessione inviati e ricevuti in sospeso | 
| partnercentral:CreateConnectionInvitation | Invia un invito alla connessione a un altro account AWS | 
| partnercentral:CancelConnectionInvitation | Annullare un invito alla connessione in uscita in sospeso | 
| partnercentral:RespondConnectionInvitation | Accetta o rifiuta un invito alla connessione in arrivo | 
| partnercentral:CancelConnection | Annullare una connessione attiva all'account | 
| partnercentral:ManageConnectionPreferences | Ottieni o aggiorna le preferenze di condivisione tra account connessi | 

**Configurazione venditore Marketplace (`aws-marketplace`):**


| Azione | Description | 
| --- | --- | 
| aws-marketplace:ListEntities | Elenca le entità del Marketplace (ad es. entità venditrici) | 
| aws-marketplace:DescribeEntity | Recupera i dettagli completi di un'entità Marketplace | 
| aws-marketplace:DescribeChangeSet | Verifica lo stato di un set di modifiche inviato | 
| aws-marketplace:StartChangeSet | Invia un set di modifiche al Marketplace (ad esempio, aggiornamento del profilo venditore) | 

**IAM — ruolo collegato al servizio ()`iam`:**


| Azione | Description | 
| --- | --- | 
| iam:GetRole | Verifica se esiste il ruolo collegato al servizio Marketplace Resale Authorization | 
| iam:CreateServiceLinkedRole | Crea il ruolo AWSServiceRoleForMarketplaceResaleAuthorization | 

## Ambienti di catalogo
<a name="mcp-config-catalog-environments"></a>


| Catalogo | Description | 
| --- | --- | 
| "AWS" | Ambiente di produzione. Tutte le operazioni influiscono sui dati in tempo reale dei partner. | 
| "Sandbox" | Ambiente di test isolato. Nessun impatto sui dati di produzione. Utilizzo per lo sviluppo e la convalida. | 

## Gestione della sessione
<a name="mcp-config-session-management"></a>


| Proprietà | Valore | 
| --- | --- | 
| Formato dell'ID della sessione | UUID v4 con session- prefisso (ad esempio,) session-550e8400-e29b-41d4-a716-446655440000 | 
| Creazione di sessioni | Automatico alla prima sendMessage chiamata senza sessionId | 
| Scadenza della sessione | 48 ore dalla creazione della sessione (scadenza assoluta, non basata sull'inattività) | 

## Caricamento di un file
<a name="mcp-config-file-upload"></a>


| Proprietà | Valore | 
| --- | --- | 
| Numero massimo di file per messaggio | 3 | 
| Limite di dimensione dell'immagine | 3,75 MB | 
| Limite delle dimensioni del documento | 4,5 MB | 
| Estensioni consentite | doc, docx, pdf, png, jpeg, xlsx, csv, txt | 
| Bucket S3 (produzione) | file aws-partner-central-marketplace-ephemeral-writeonly-files | 
| Percorso di caricamento | s3://{bucket}/{aws-account-id}/ | 
| Requisito URI S3 | Deve includere il parametro di versionId interrogazione | 

### Workflow di caricamento
<a name="mcp-config-upload-workflow"></a>

1. Carica il file nel bucket S3 appropriato con il prefisso AWS dell'ID dell'account.

1. Annota l'URI S3, incluso quello `versionId` restituito dal caricamento.

1. Includi il file come blocco di `document` contenuto nella `sendMessage` chiamata.

Esempio di formato URI S3:

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

## Codici di errore
<a name="mcp-config-error-codes"></a>


| Codice | Nome | Description | 
| --- | --- | --- | 
| -32001 | AUTHENTICATION\_FAILURE | La firma SigV4 non è valida o le credenziali sono scadute | 
| -31004 | TOOL\_PERMISSION\_DENIED | L'identità IAM non dispone dell'azione richiesta per questa operazione partnercentral: | 
| -32002 | ACCESS\_DENIED | Accesso generale negato (account non registrato, regione non corrispondente, ecc.) | 
| -32004 | LIMIT\_EXCEEDED | Limite di tariffa o quota superati. Riprova con backoff esponenziale. | 
| -30001 | RESOURCE\_NOT\_FOUND | La risorsa richiesta (sessione, opportunità, ecc.) non esiste | 
| -32600 | INVALID\_REQUEST |  JSON-RPC Richiesta non valida o parametri non validi | 
| -32603 | INTERNAL\_ERROR | Server-side errore. Riprova la richiesta . | 

## Limiti di frequenza
<a name="mcp-config-rate-limits"></a>

Il server impone limiti di tariffa per account:


| Operation | Tasso sostenuto | Scoppio | 
| --- | --- | --- | 
| sendMessage | 2 richieste al minuto | 10 | 
| Tutte le altre operazioni | 10 richieste al minuto | 20 | 

Se superi questi limiti, il server restituisce il codice di errore `-32004` (LIMIT\_EXCEEDED). Implementa il backoff esponenziale con jitter nel tuo client per gestire con garbo la limitazione della velocità.

## Tipi di eventi Streaming (SSE)
<a name="mcp-config-sse-events"></a>

Quando `stream` è impostato su `true` In una `sendMessage` chiamata, il server restituisce Server-Sent Events con questi tipi di eventi:


| Tipo di evento | Description | 
| --- | --- | 
| stream\_start | Connessione di streaming stabilita | 
| assistant-response.start | L'agente ha iniziato a generare una risposta | 
| assistant-response.delta | Parte di testo incrementale della risposta dell'agente | 
| assistant-response.completed | L'agente ha terminato la generazione della risposta | 
| server-tool-use | L'agente sta richiamando uno strumento interno (operazione di lettura) | 
| server-tool-response | Risultato della chiamata di uno strumento interno | 
| tool\_approval\_request | L'agente richiede l'approvazione umana per un'operazione di scrittura | 
| stream\_end | Chiusura della connessione Stream | 
| done | Evento finale che indica che il flusso SSE è completo | 

## Fasi successive
<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): documentazione `sendMessage` e `getSession` strumenti dettagliati