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 di Partner Central Agent

Questa guida illustra come configurare l'accesso al server MCP Partner Central Agent. Il server supporta due metodi di autenticazione: OAuth per l'accesso basato su browser e SIGv4 per l'accesso diretto a HTTPS: non è richiesto alcun proxy o plug-in IDE.

Prerequisiti

Prima di iniziare, assicurati di avere:

Solo per l'autenticazione SIGv4

I seguenti prerequisiti si applicano solo all'autenticazione Sigv4.

Passaggio 1: configura l'autenticazione e connettiti

Con il Partner Central Agent MCP Server, puoi autenticarti utilizzando OAuth per l'accesso basato su browser o SIGv4 per l'accesso diretto HTTPS. Scegli il metodo più adatto al tuo flusso di lavoro. Il tuo client MCP si connette direttamente all'endpoint: non è richiesto alcun livello proxy o plug-in IDE.

Endpoint

https://partnercentral-agents-mcp.us-east-1.api.aws/mcp

Il Partner Central Agent MCP Server è attualmente disponibile solo negli Stati Uniti orientali (Virginia settentrionale). È possibile connettersi a questo endpoint da qualsiasi posizione.

Scelta di un metodo di autenticazione

Connetti il tuo client MCP

Scegli una scheda per visualizzare le istruzioni di configurazione per il tuo metodo di autenticazione preferito.

OAuth (simple)

Con OAuth, accedi utilizzando le stesse credenziali utilizzate per la AWS console di gestione. Quando ti connetti per la prima volta, il tuo client MCP apre una finestra del browser per. AWS Sign-In Dopo aver autenticato e autorizzato l'accesso, i token si aggiornano automaticamente in background.

Nota

L'autorizzazione di un agente non gli conferisce autorizzazioni aggiuntive. AWS AWS valuta ogni richiesta rispetto alle politiche IAM, alle politiche di controllo dei servizi, alle politiche di controllo delle risorse e ai limiti delle autorizzazioni.

Prerequisiti

Concedi le autorizzazioni di accesso OAuth al tuo ruolo o utente IAM. Puoi allegare la policy AWSMcpServiceActionsFullAccess gestita o aggiungere signin:CreateOAuth2Token le azioni signin:AuthorizeOAuth2Access and alla tua policy IAM.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "signin:AuthorizeOAuth2Access",
                "signin:CreateOAuth2Token"
            ],
            "Resource": "*"
        }
    ]
}

Nota

Non è richiesta alcuna autorizzazione esplicita per partnercentral:* le azioni per l'accesso al protocollo MCP. Il server MCP concede l'accesso al protocollo per impostazione predefinita a tutte le identità autenticate. AWS Le signin:* autorizzazioni sopra riportate sono necessarie solo per abilitare il flusso OAuth basato su browser.

Configura il tuo client MCP

Usa uno dei seguenti client per connetterti.

Codice Claude CLI

Esegui il comando seguente:

claude mcp add partnercentral --transport http https://partnercentral-agents-mcp.us-east-1.api.aws/mcp

Desktop Claude

Aggiungilo come server MCP remoto con il seguente URL:

https://partnercentral-agents-mcp.us-east-1.api.aws/mcp

Kiro CLI (v3 o successivo)

Esegui il comando seguente:

kiro-cli --v3 mcp add --name partnercentral --url https://partnercentral-agents-mcp.us-east-1.api.aws/mcp

Nota

OAuth con Partner Central Agent MCP Server richiede la Kiro CLI versione 3 o successiva. Le versioni precedenti non supportano questo flusso.

Kiro IDE

Aggiungilo come server MCP remoto con il seguente URL:

https://partnercentral-agents-mcp.us-east-1.api.aws/mcp

Amazon Quick

Crea un connettore e installalo inQuick Desktop.

Parte 1: Creazione del connettore

Completa i seguenti passaggi inAmazon Quick.

1. Nel pannello sinistro diAmazon Quick, apri Funzionalità → Connettori.

2. Scegli Crea → Connettori Web. Quick Web si apre nel browser predefinito.

3. Seleziona la scheda Crea per il tuo team, quindi scegli Model Context Protocol.

4. Scegli No, Crea nuovo e inserisci quanto segue:

   Campo	Valore
   Nome	Agenti Partner Central
   Description	Da MCP a Partner Central Agents
   Endpoint del server MCP	https://partnercentral-agents-mcp.us-east-1.api.aws/mcp
   Tipo di connessione	Rete pubblica
   Tipo di connessione di autenticazione	Rete pubblica

5. Scegli Avanti.

6. Per la configurazione di autenticazione, seleziona App OAuth predefinita.

7. Scegli Crea e continua. Si apre un popup del browser per accedere con il tuo account Partner Central: seleziona il tuo account di accesso esistente.

8. Dopo la chiusura del popup, scegli Avanti per accedere alla sezione di revisione.

9. Nella sezione Pubblica, seleziona gli alias con cui vuoi condividere il connettore (incluso il tuo) o condividerlo con l'intera organizzazione.

Parte 2: Connettiti Desktop rapido

Installa il connettore nell'applicazione desktop.

1. InQuick Desktop, apri Capacità.

2. Nella scheda Connettori, scegli Sfoglia altro e cerca Partner Central Agents. La visualizzazione potrebbe richiedere alcuni minuti.

3. Scegli Installa.

Nota

Se il tuo cliente non è presente nell'elenco, utilizza l'URL dell'endpoint riportato sopra. Se le chiamate allo strumento non riescono a causa di errori di credenziali, aggiungile all'URL ?oauth=initialize per attivare esplicitamente il flusso di accesso OAuth.

SigV4 (advanced)

Usa SIGv4 per autenticare le richieste di client MCP personalizzati, agenti headless, pipeline o script di automazione. CI/CD

Prerequisiti

Completa i passaggi seguenti prima di connetterti.

1. Installa la AWS CLI.

2. Accedi e configura le credenziali: aws configure

3. Verifica l'accesso: aws sts get-caller-identity

Nota

Non è richiesto alcun IAM Allow esplicito per l'accesso al protocollo MCP. Il server MCP concede l'accesso per impostazione predefinita a tutte le identità autenticate. AWS Sono necessarie solo AWS credenziali valide in grado di firmare le richieste.

Configura

Firma le richieste utilizzando AWS Signature Version 4 con i seguenti parametri:

• Nome del servizio: partnercentral-agents-mcp

• Regione: us-east-1

Esempio utilizzandoawscurl:

awscurl --service partnercentral-agents-mcp --region us-east-1 \
  -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  "https://partnercentral-agents-mcp.us-east-1.api.aws/mcp"

Limitazione dell'accesso MCP

Per impostazione predefinita, tutte le AWS identità autenticate hanno accesso tramite protocollo al server MCP. Per bloccare l'accesso MCP per utenti o account specifici, applica un rifiuto esplicito su: partnercentral:InvokeMcp

{
    "Effect": "Deny",
    "Action": "partnercentral:InvokeMcp",
    "Resource": "*"
}

Riferimento al protocollo MCP

Questa sezione descrive il JSON-RPC protocollo per le implementazioni personalizzate dei client MCP. Se stai utilizzandoClaude Code,, o KiroClaude Desktop, il tuo client gestisce queste richieste automaticamente.

Il formato di richiesta e risposta è identico per l'autenticazione OAuth e Sigv4. L'unica differenza è l'intestazione di autenticazione HTTP: OAuth utilizza, mentre SigV4 utilizza Authorization: Bearer <token> le intestazioni delle firme. AWS

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

Elenco degli strumenti disponibili

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

Fase 2: concedere le autorizzazioni di accesso ai dati

Quando ti connetti al server MCP, hai solo accesso al protocollo. Per eseguire operazioni con Partner Central, ad esempio la ricerca di opportunità o la gestione dei finanziamenti, sono necessarie autorizzazioni IAM aggiuntive. Le seguenti sezioni descrivono come allegare le policy e i livelli di autorizzazione disponibili.

Allegare politiche IAM

Per allegare una policy alla tua identità IAM utilizzando la console di AWS gestione:

Le autorizzazioni hanno effetto immediato. È possibile allegare più policy alla stessa identità.

Consigliato: utilizza la policy gestita

Il modo più semplice per concedere le autorizzazioni di accesso ai dati è collegare la policy AWSPartnerCentralFullAccess gestita alla tua identità IAM. Questa policy include le autorizzazioni per tutte le operazioni di Partner Central disponibili tramite il server MCP.

Per un controllo dettagliato, utilizza le politiche personalizzate nelle sezioni seguenti per concedere solo le azioni specifiche richieste dal tuo caso d'uso.

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": "*"
}

Partner Central Onboarding:

{
    "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 configurare i venditori del 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 policy:

aws iam create-policy \
    --policy-name PartnerCentralAgentsFullAccess \
    --policy-document '{
        "Version": "2012-10-17",
        "Statement": [
            {
                "Effect": "Allow",
                "Action": [
                    "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:List*",
                    "partnercentral:Get*"
                ],
                "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": "*"
            }
        ]
    }'

Firmare le chiamate con l'intestazione MCP

Quando si effettuano richieste agli agenti MCP di Partner Central, consigliamo di includere l'intestazione MCP personalizzata utilizzando i seguenti metodi per AWS identificare l'origine dell'applicazione client, monitorare l'utilizzo e verificare 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 dei client.

Metodo 1: _meta field (MCP) programmatic/stateless

Per il codice che costruisce direttamente le richieste MCP, fornisci il tools/call campo sulle richieste. _meta

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

Metodo 3: parametro URL (solo MCP ospitato)

Solo per i client MCP ospitati in cui l'integratore non può modificare i campi del protocollo. Usa il parametro URL:

URL del server: https://partnercentral-agents-mcp.us-east-1.api.aws/mcp?appId=<Integrator's Company Name / Direct>

Passaggio 3: verifica la configurazione

Invia un semplice messaggio per confermare che tutto funziona. Usa il Sandbox catalogo per i test:

{
    "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 da utilizzare per i messaggi di follow-up.

Passaggio 4: esegui le tue prime attività

Interroga 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:

Considerazioni relative alla sicurezza

Risoluzione dei problemi

La tabella seguente elenca gli errori più comuni e le relative risoluzioni.

Fasi successive