L' Centrale Partner AWS API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'Centrale Partner AWS API Reference.
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à.
Guida introduttiva al server MCP Partner Central Agent
Questa guida illustra come configurare l'accesso programmatico al server MCP Partner Central Agent utilizzando un client MCP personalizzato. Il server utilizza HTTPS diretto con autenticazione SigV4: non è richiesto alcun proxy o plug-in IDE.
Prerequisiti
Prima di iniziare, assicurati di avere:
Un account Partner Central attivo (migrato alla AWS console)
Un AWS account con autorizzazioni IAM per Partner Central
AWS CLI installata e configurata con credenziali
Accesso alla regione us-east-1 (Virginia settentrionale)
Connettività HTTPS a
partnercentral-agents-mcp.us-east-1.api.awsSupporto TLS 1.2+ nel tuo client HTTP
Un MCP-compatible client che supporta la firma delle richieste JSON-RPC 2.0 e SigV4
Fase 1: configurare le autorizzazioni IAM
Il server MCP Partner Central Agent richiede autorizzazioni IAM a due livelli: accesso al protocollo (per comunicare con l'endpoint MCP) e accesso ai dati (per eseguire le operazioni di Partner Central).
Allegare le politiche IAM
Per allegare una policy alla tua identità IAM utilizzando la console di AWS gestione:
Apri la console IAM
. Nel riquadro di navigazione a sinistra, scegli Utenti, Gruppi di utenti o Ruoli a seconda dell'identità a cui desideri allegare la policy, quindi scegli il nome dell'utente, del gruppo o del ruolo specifico.
Scegli la scheda Autorizzazioni.
Scegli Allega politiche (o Aggiungi autorizzazioni se è la prima volta).
Nell'elenco delle policy, cerca e seleziona la policy gestita che desideri allegare (ad esempio, una policy personalizzata che hai creato dai blocchi JSON riportati di seguito).
Scegli Allega politiche (o Avanti e poi Aggiungi autorizzazioni) per confermare.
Le autorizzazioni hanno effetto immediato. È possibile allegare più politiche alla stessa identità.
Consigliato: utilizza la politica gestita
Il modo più semplice per concedere l'accesso al protocollo MCP è collegare 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.
Autorizzazioni minime per l'accesso al protocollo MCP
Come minimo, la tua identità IAM necessita di questa azione per interagire con il server MCP:
| Azione | Description |
|---|---|
partnercentral:UseSession |
Necessario per creare, aggiornare e recuperare le sessioni di conversazione |
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "partnercentral:UseSession" ], "Resource": "*", "Condition": { "Bool": { "aws:IsMcpServiceAction": "true" } } } ] }
Autorizzazioni di accesso ai dati
Per eseguire effettivamente le operazioni di Partner Central tramite l'agente, sono necessarie autorizzazioni aggiuntive in base al caso d'uso.
Gestione delle opportunità:
{ "Effect": "Allow", "Action": [ "partnercentral:List*", "partnercentral:Get*", "partnercentral:CreateOpportunity", "partnercentral:UpdateOpportunity", "partnercentral:SubmitOpportunity", "partnercentral:AssignOpportunity", "partnercentral:AssociateOpportunity", "partnercentral:DisassociateOpportunity" ], "Resource": "*" }
Programmi di finanziamento:
{ "Effect": "Allow", "Action": [ "partnercentral:ListBenefitAllocations", "partnercentral:ListBenefitApplications", "partnercentral:CreateBenefitApplication", "partnercentral:GetBenefitApplication", "partnercentral:UpdateBenefitApplication", "partnercentral:SubmitBenefitApplication", "partnercentral:AmendBenefitApplication", "partnercentral:CancelBenefitApplication", "partnercentral:RecallBenefitApplication", "partnercentral:AssociateBenefitApplicationResource", "partnercentral:DisassociateBenefitApplicationResource" ], "Resource": "*" }
Accesso al Marketplace:
{ "Effect": "Allow", "Action": [ "aws-marketplace:DescribeEntity", "aws-marketplace:DescribeAgreement", "aws-marketplace:SearchAgreements", "aws-marketplace:ListEntities" ], "Resource": "*" }
Registrazione iniziale di Partner Central:
{ "Effect": "Allow", "Action": [ "partnercentral:ListPartners", "partnercentral:GetPartner", "partnercentral:GetProfileVisibility", "partnercentral:GetAllianceLeadContact", "partnercentral:GetProfileUpdateTask", "partnercentral:StartProfileUpdateTask", "partnercentral:CancelProfileUpdateTask", "partnercentral:PutProfileVisibility", "partnercentral:PutAllianceLeadContact", "partnercentral:SendEmailVerificationCode", "partnercentral:AssociateAwsTrainingCertificationEmailDomain", "partnercentral:DisassociateAwsTrainingCertificationEmailDomain", "partnercentral:GetAccountConnections", "partnercentral:GetConnectionInvitations", "partnercentral:CreateConnectionInvitation", "partnercentral:CancelConnectionInvitation", "partnercentral:RespondConnectionInvitation", "partnercentral:CancelConnection", "partnercentral:ManageConnectionPreferences" ], "Resource": "*" }
Per la configurazione del venditore su Marketplace, aggiungi anche:
{ "Effect": "Allow", "Action": [ "aws-marketplace:ListEntities", "aws-marketplace:DescribeEntity", "aws-marketplace:DescribeChangeSet", "aws-marketplace:StartChangeSet" ], "Resource": "*" }
Per la gestione dei ruoli collegata ai servizi (rivendita): Authorizations/CPPO
{ "Effect": "Allow", "Action": [ "iam:GetRole", "iam:CreateServiceLinkedRole" ], "Resource": "*" }
Politica di accesso completo
Per lo sviluppo e il test, puoi combinare tutte le autorizzazioni in un'unica politica:
aws iam create-policy \ --policy-name PartnerCentralAgentsFullAccess \ --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "partnercentral:UseSession", "partnercentral:List*", "partnercentral:Get*", "partnercentral:CreateOpportunity", "partnercentral:UpdateOpportunity", "partnercentral:SubmitOpportunity", "partnercentral:AssignOpportunity", "partnercentral:AssociateOpportunity", "partnercentral:DisassociateOpportunity", "partnercentral:CreateResourceSnapshot", "partnercentral:CreateResourceSnapshotJob", "partnercentral:StartResourceSnapshotJob", "partnercentral:CreateEngagement", "partnercentral:CreateEngagementInvitation", "partnercentral:RejectEngagementInvitation", "partnercentral:StartEngagementByAcceptingInvitationTask", "partnercentral:StartEngagementFromOpportunityTask", "partnercentral:CreateBenefitApplication", "partnercentral:UpdateBenefitApplication", "partnercentral:SubmitBenefitApplication", "partnercentral:AmendBenefitApplication", "partnercentral:CancelBenefitApplication", "partnercentral:RecallBenefitApplication", "partnercentral:AssociateBenefitApplicationResource", "partnercentral:DisassociateBenefitApplicationResource", "partnercentral:ListPartners", "partnercentral:StartProfileUpdateTask", "partnercentral:CancelProfileUpdateTask", "partnercentral:PutProfileVisibility", "partnercentral:PutAllianceLeadContact", "partnercentral:SendEmailVerificationCode", "partnercentral:AssociateAwsTrainingCertificationEmailDomain", "partnercentral:DisassociateAwsTrainingCertificationEmailDomain", "partnercentral:CreateConnectionInvitation", "partnercentral:CancelConnectionInvitation", "partnercentral:RespondConnectionInvitation", "partnercentral:CancelConnection", "partnercentral:ManageConnectionPreferences" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "aws-marketplace:DescribeEntity", "aws-marketplace:DescribeAgreement", "aws-marketplace:SearchAgreements", "aws-marketplace:ListEntities", "aws-marketplace:DescribeChangeSet", "aws-marketplace:StartChangeSet" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "iam:GetRole", "iam:CreateServiceLinkedRole" ], "Resource": "*" } ] }'
Read-only politica
Per ambienti di produzione o casi d'uso di sola lettura, limita le autorizzazioni alle operazioni di lettura:
aws iam create-policy \ --policy-name PartnerCentralAgentReadOnly \ --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "partnercentral:UseSession", "partnercentral:List*", "partnercentral:Get*", "partnercentral:ListPartners", "partnercentral:GetPartner", "partnercentral:GetProfileVisibility", "partnercentral:GetAllianceLeadContact", "partnercentral:GetProfileUpdateTask", "partnercentral:GetAccountConnections", "partnercentral:GetConnectionInvitations" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "aws-marketplace:DescribeEntity", "aws-marketplace:DescribeAgreement", "aws-marketplace:SearchAgreements", "aws-marketplace:ListEntities", "aws-marketplace:DescribeChangeSet" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "iam:GetRole" ], "Resource": "*" } ] }'
Fase 2: Connect il client MCP
Il server MCP Partner Central Agent utilizza HTTPS diretto con firma delle richieste SigV4. Non esiste un livello proxy: il client MCP invia le richieste JSON-RPC 2.0 direttamente all'endpoint.
Endpoint
https://partnercentral-agents-mcp.us-east-1.api.aws/mcp
Autenticazione
Tutte le richieste devono essere firmate con AWS Signature Version 4 utilizzando:
Nome del servizio:
partnercentral-agents-mcpRegione:
us-east-1
Inizializza la connessione MCP
Invia una initialize richiesta per stabilire il protocollo:
{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-03-26", "capabilities": {}, "clientInfo": { "name": "my-partner-client", "version": "1.0.0" } } }
Risposta prevista:
{ "jsonrpc": "2.0", "id": 1, "result": { "protocolVersion": "2025-03-26", "capabilities": { "tools": { "listChanged": false } }, "serverInfo": { "name": "PartnerCentralAgentMCPServer", "version": "1.0.0" } } }
Elenca gli strumenti disponibili
{ "jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {} }
Firma delle chiamate con l'intestazione MCP
Quando si effettuano richieste agli agenti MCP di Partner Central, si consiglia di includere l'intestazione MCP personalizzata utilizzando i seguenti metodi per AWS identificare l'origine dell'applicazione client, monitorare l'utilizzo e controllare le prestazioni.AWS utilizza questa intestazione per distinguere il tipo di applicazione client che effettua la chiamata e per raccogliere informazioni sulla percentuale di successo delle diverse implementazioni client.
Metodo 1: _meta field (MCP) programmatic/stateless
Per il codice che crea direttamente le richieste MCP, fornisci il _meta campo sulle tools/call richieste.
{ "method": "tools/call", "params": { "name": "sendMessage", "arguments": { "content": [ { "type": "text", "text": "List my open opportunities with expected close date in Q1 2026" } ], "catalog": "AWS" }, "_meta": { "integrator": "<Integrator's Company Name / Direct>", "sourceProduct": "<Integrator's Application Name>" } } }
Metodo 2: ClientInfo (agenti personalizzati basati sulla sessione)
Per i client MCP personalizzati che stabiliscono sessioni, fornisci le informazioni sull'intestazione MCP all'interno del campo: clientInfo
{ "method": "initialize", "params": { "protocolVersion": "2024-11-05", "clientInfo": { "integrator": "<Integrator's Company Name / Direct>", "sourceProduct": "<Integrator's Application Name>" } } }
Campi in: clientInfo
-
integrator— Nome dell'azienda o «Direct» per i partnerAd esempio:
AWS -
sourceProduct— Product/agent nomeAd esempio:
AWS CRM Connector
Metodo 3: parametro URL (solo MCP ospitato)
Solo per client MCP ospitati in cui l'integratore non può modificare i campi del protocollo. Usa il parametro URL:
URL del server: https://mcp.partnercentral.aws?appId=<Integrator's Company Name / Direct>
Fase 3: Verifica la configurazione
Invia un semplice messaggio per confermare che tutto funziona. Usa il Sandbox catalogo per testare:
{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "sendMessage", "arguments": { "content": [ { "type": "text", "text": "Hello, what can you help me with?" } ], "catalog": "Sandbox" } } }
Se ricevi una risposta "status": "complete" e una risposta via SMS dall'agente, la configurazione funziona correttamente. La risposta includerà anche un messaggio sessionId che potrai utilizzare per i messaggi di follow-up.
Passaggio 4: Esegui le tue prime attività
Consulta le tue opportunità
{ "jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": { "name": "sendMessage", "arguments": { "sessionId": "session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "content": [ { "type": "text", "text": "List my open opportunities with expected revenue over $50K" } ], "catalog": "AWS" } } }
Verifica l'idoneità al finanziamento
{ "jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": { "name": "sendMessage", "arguments": { "sessionId": "session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "content": [ { "type": "text", "text": "Am I eligible for MAP funding for opportunity O1234567890?" } ], "catalog": "AWS" } } }
Recupera la cronologia delle sessioni
{ "jsonrpc": "2.0", "id": 6, "method": "tools/call", "params": { "name": "getSession", "arguments": { "sessionId": "session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "catalog": "AWS" } } }
Inserimento dei partner
{ "jsonrpc": "2.0", "id": 7, "method": "tools/call", "params": { "name": "sendMessage", "arguments": { "sessionId": "session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "content": [ { "type": "text", "text": "Help me onboard to Partner Central" } ], "catalog": "AWS" } } }
Altre attività di onboarding da provare:
«Guidami nella procedura del questionario fiscale»
«Puoi dare un'occhiata al mio sito Web e compilare il mio profilo di partner?»
«Cosa devo fare ancora per essere pronto a vendere su Marketplace?»
Considerazioni relative alla sicurezza
Non passate AWS le credenziali tramite i parametri dello strumento MCP. L'autenticazione è gestita dalla firma delle richieste SigV4 a livello di trasporto.
Utilizza il catalogo Sandbox per test e sviluppo. Il
"Sandbox"catalogo fornisce un ambiente isolato che non influisce sui dati dei partner di produzione.Applica le politiche IAM con privilegi minimi nella produzione. Utilizza la policy di sola lettura per il monitoraggio e la segnalazione dei casi d'uso. Concedi le autorizzazioni di scrittura solo quando l'utente deve aggiornare le opportunità o inviare richieste di finanziamento.
Esamina attentamente le operazioni di scrittura. Il server utilizza l'approvazione human-in-the-loop per tutte le operazioni di scrittura. Quando viene proposta un'azione di scrittura, rivedi i parametri prima dell'approvazione.
I dati della sessione sono transitori. Le sessioni scadono 48 ore dopo la creazione. Non fare affidamento sulle sessioni per l'archiviazione dei dati a lungo termine.
I file caricati vengono trasferiti in un bucket S3 temporaneo. I file caricati vengono archiviati temporaneamente e non vengono conservati in modo permanente. Non caricare file contenenti credenziali, segreti o altre informazioni sensibili.
Fasi successive
Riferimento alla configurazione: riferimento completo per endpoint, azioni IAM, gestione delle sessioni e codici di errore
Riferimento agli strumenti: documentazione dettagliata per
sendMessageegetSessionstrumenti
