Se reestructuró la referencia de la Centro de socios de AWS API. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia de la Centro de socios de AWS API.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Introducción al servidor Partner Central Agent MCP

En esta guía se explica cómo configurar el acceso al servidor MCP del agente de Partner Central. El servidor admite dos métodos de autenticación: OAuth para el inicio de sesión desde el navegador y SIGv4 para el acceso HTTPS directo, sin necesidad de un proxy ni de un complemento IDE.

Requisitos previos

Antes de empezar, asegúrese de que tiene lo siguiente:

Solo para la autenticación SigV4

Los siguientes requisitos previos se aplican únicamente a la autenticación Sigv4.

Paso 1: configurar la autenticación y conectarse

Con el servidor MCP del agente de Partner Central, puede autenticarse con OAuth para iniciar sesión desde el navegador o con SIGv4 para acceder directamente a través de HTTPS. Elija el método que mejor se adapte a su flujo de trabajo. Su cliente MCP se conecta directamente al punto final, sin necesidad de una capa de proxy ni de un complemento de IDE.

Punto de conexión

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

El servidor MCP de Partner Central Agent actualmente solo está disponible en el este de EE. UU. (Virginia del Norte). Puede conectarse a este punto final desde cualquier ubicación.

Elegir un método de autenticación

Conecta tu cliente de MCP

Seleccione una pestaña para ver las instrucciones de configuración de su método de autenticación preferido.

OAuth (simple)

Con OAuth, inicias sesión con las mismas credenciales que usas para la consola AWS de administración. Cuando te conectas por primera vez, tu cliente MCP abre una ventana del navegador para. AWS Sign-In Tras autenticarse y autorizar el acceso, los tokens se actualizan automáticamente en segundo plano.

nota

La autorización de un agente no le otorga ningún permiso adicional AWS . AWS evalúa cada solicitud comparándola con tus políticas de IAM, políticas de control de servicios, políticas de control de recursos y límites de permisos.

Requisitos previos

Otorga permisos de inicio de sesión de OAuth a tu rol o usuario de IAM. Puedes adjuntar la política AWSMcpServiceActionsFullAccess gestionada o añadir las signin:CreateOAuth2Token acciones signin:AuthorizeOAuth2Access y a tu política de IAM.

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

nota

No es necesario permitir partnercentral:* acciones de forma explícita para acceder al protocolo MCP. El servidor MCP concede el acceso al protocolo de forma predeterminada a todas las identidades AWS autenticadas. Los signin:* permisos anteriores solo son necesarios para habilitar el flujo de OAuth basado en el navegador.

Configure su cliente MCP

Utilice uno de los siguientes clientes para conectarse.

Claude Code CLI

Use el siguiente comando:

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

Escritorio Claude

Añádalo como servidor MCP remoto con la siguiente URL:

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

CLI de Kiro (v3 o posterior)

Use el siguiente comando:

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

nota

OAuth con el servidor MCP del agente de Partner Central requiere la Kiro CLI versión 3 o posterior. Las versiones anteriores no admiten este flujo.

IDE de Kiro

Añádalo como servidor MCP remoto con la siguiente URL:

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

Amazon Quick

Cree un conector e instálelo. Quick Desktop

Parte 1: Crear el conector

Complete los siguientes pasos enAmazon Quick.

1. En el panel izquierdo deAmazon Quick, abra Capacidades → Conectores.

2. Seleccione Crear → Conectores web. La web rápida se abre en el navegador predeterminado.

3. Selecciona la pestaña Crear para tu equipo y, a continuación, elige Model Context Protocol.

4. Seleccione No, Crear nuevo e introduzca lo siguiente:

   Campo	Valor
   Name	Agentes de Partner Central
   Description (Descripción)	MCP se unirá a los agentes centrales asociados
   Punto final del servidor MCP	https://partnercentral-agents-mcp.us-east-1.api.aws/mcp
   Tipo de conexión	Red pública
   Tipo de conexión de autenticación	Red pública

5. Elija Siguiente.

6. Para la configuración de autenticación, selecciona la aplicación OAuth predeterminada.

7. Elige Crear y continuar. Se abre una ventana emergente del navegador para iniciar sesión con su cuenta de Partner Central; seleccione la cuenta en la que ha iniciado sesión.

8. Cuando se cierre la ventana emergente, selecciona Siguiente para acceder a la sección de reseñas.

9. En la sección Publicar, selecciona los alias con los que quieres compartir el conector (incluido el tuyo) o con toda la organización.

Parte 2: Conéctate Escritorio rápido

Instale el conector en su aplicación de escritorio.

1. EnQuick Desktop, abra Capacidades.

2. En la pestaña Conectores, seleccione Explorar más y busque agentes de Partner Central. Es posible que tarde unos minutos en aparecer.

3. Elija Instalar.

nota

Si tu cliente no aparece en la lista, usa la URL de punto final que aparece arriba. Si las llamadas a las herramientas fallan debido a errores en las credenciales, añádelo ?oauth=initialize a la URL para activar explícitamente el flujo de inicio de sesión de OAuth.

SigV4 (advanced)

Usa SIGv4 para autenticar las solicitudes de clientes MCP personalizados, agentes independientes, canalizaciones o scripts de automatización. CI/CD

Requisitos previos

Complete los siguientes pasos antes de conectarse.

1. Instale la AWS CLI.

2. Inicie sesión y configure las credenciales: aws configure

3. Verificar el acceso: aws sts get-caller-identity

nota

No se requiere ningún permiso explícito de IAM para acceder al protocolo MCP. El servidor MCP concede acceso de forma predeterminada a todas las identidades autenticadas. AWS Solo necesita AWS credenciales válidas que puedan firmar las solicitudes.

Configuración

Firme las solicitudes con AWS la versión 4 de Signature con los siguientes parámetros:

• Nombre del servicio: partnercentral-agents-mcp

• Región: us-east-1

Ejemplo conawscurl:

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"

Restringir el acceso a MCP

De forma predeterminada, todas las AWS identidades autenticadas tienen acceso mediante protocolos al servidor MCP. Para bloquear el acceso al MCP a usuarios o cuentas específicos, aplique una denegación explícita en: partnercentral:InvokeMcp

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

Referencia al protocolo MCP

En esta sección se describe el JSON-RPC protocolo para las implementaciones personalizadas de clientes MCP. Si está utilizandoClaude Code, o KiroClaude Desktop, su cliente gestiona estas solicitudes automáticamente.

El formato de solicitud y respuesta es idéntico para la autenticación OAuth y Sigv4. La única diferencia es el encabezado de autenticación HTTP: OAuth usa encabezados de firmaAuthorization: Bearer <token>, mientras que SIGv4 usa encabezados de firma. AWS

Inicialice la conexión MCP

Envíe una initialize solicitud para establecer el protocolo:

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
        "protocolVersion": "2025-03-26",
        "capabilities": {},
        "clientInfo": {
            "name": "my-partner-client",
            "version": "1.0.0"
        }
    }
}

Respuesta esperada:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "protocolVersion": "2025-03-26",
        "capabilities": {
            "tools": {
                "listChanged": false
            }
        },
        "serverInfo": {
            "name": "PartnerCentralAgentMCPServer",
            "version": "1.0.0"
        }
    }
}

Enumere las herramientas disponibles

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

Paso 2: Otorgar permisos de acceso a los datos

Cuando se conecta al servidor MCP, solo tiene acceso al protocolo. Para realizar las operaciones de Partner Central, como consultar oportunidades o gestionar la financiación, necesita permisos de IAM adicionales. En las siguientes secciones se describe cómo adjuntar políticas y los niveles de permisos disponibles.

Adjuntar políticas de IAM

Para adjuntar una política a tu identidad de IAM mediante la AWS consola de administración:

Los permisos entran en vigor de forma inmediata. Puede adjuntar varias políticas a la misma identidad.

Recomendado: utilice la política gestionada

La forma más sencilla de conceder permisos de acceso a los datos es adjuntar la política AWSPartnerCentralFullAccess gestionada a tu identidad de IAM. Esta política incluye los permisos para todas las operaciones de Partner Central disponibles a través del servidor MCP.

Para un control más detallado, utilice las políticas personalizadas de las siguientes secciones para conceder solo las acciones específicas que requiera su caso práctico.

Permisos de acceso a datos

Para realizar realmente las operaciones de Partner Central a través del agente, necesitará permisos adicionales en función de su caso de uso.

Gestión de oportunidades:

{
    "Effect": "Allow",
    "Action": [
        "partnercentral:List*",
        "partnercentral:Get*",
        "partnercentral:CreateOpportunity",
        "partnercentral:UpdateOpportunity",
        "partnercentral:SubmitOpportunity",
        "partnercentral:AssignOpportunity",
        "partnercentral:AssociateOpportunity",
        "partnercentral:DisassociateOpportunity"
    ],
    "Resource": "*"
}

Programas de financiación:

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

Acceso al mercado:

{
    "Effect": "Allow",
    "Action": [
        "aws-marketplace:DescribeEntity",
        "aws-marketplace:DescribeAgreement",
        "aws-marketplace:SearchAgreements",
        "aws-marketplace:ListEntities"
    ],
    "Resource": "*"
}

Incorporación a 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": "*"
}

Para configurar un vendedor de Marketplace, añade también:

{
    "Effect": "Allow",
    "Action": [
        "aws-marketplace:ListEntities",
        "aws-marketplace:DescribeEntity",
        "aws-marketplace:DescribeChangeSet",
        "aws-marketplace:StartChangeSet"
    ],
    "Resource": "*"
}

Para la administración de funciones vinculadas a servicios (reventa Authorizations/CPPO):

{
    "Effect": "Allow",
    "Action": [
        "iam:GetRole",
        "iam:CreateServiceLinkedRole"
    ],
    "Resource": "*"
}

Política de acceso completo

Para el desarrollo y las pruebas, puede combinar todos los permisos en una sola política:

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 política

Para entornos de producción o casos de uso de solo lectura, restrinja los permisos a las operaciones de lectura:

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

Firmar las llamadas con el encabezado MCP

Al realizar solicitudes a los agentes MCP de Partner Central, recomendamos incluir el encabezado MCP personalizado mediante los siguientes métodos para ayudar a AWS identificar el origen de la aplicación cliente, supervisar el uso y auditar el rendimiento. AWS utiliza este encabezado para distinguir el tipo de aplicación cliente que realiza la llamada y para recopilar información sobre la tasa de éxito de las diferentes implementaciones de clientes.

Método 1: _meta field (MCP) programmatic/stateless

Para el código que construye directamente las solicitudes de MCP, proporciona el _meta campo en tools/call las solicitudes.

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

Método 2: ClientInfo (agentes personalizados basados en sesiones)

Para los clientes MCP personalizados que establecen sesiones, proporcione la información del encabezado de MCP dentro del campo: clientInfo

{
    "method": "initialize",
    "params": {
        "protocolVersion": "2024-11-05",
        "clientInfo": {
            "integrator": "<Integrator's Company Name / Direct>",
            "sourceProduct": "<Integrator's Application Name>"
        }
    }
}

Campos en: clientInfo

Método 3: parámetro URL (solo MCP hospedado)

Solo para clientes MCP alojados en los que el integrador no pueda modificar los campos de protocolo. Utilice el parámetro URL:

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

Paso 3: comprobación de la configuración

Envía un mensaje sencillo para confirmar que todo funciona. Utilice el Sandbox catálogo para realizar pruebas:

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

Si recibe una respuesta del agente "status": "complete" y otra por mensaje de texto, significa que la configuración funciona correctamente. La respuesta también incluirá una sessionId que podrás usar para los mensajes de seguimiento.

Paso 4: ejecución de las primeras tareas

Consulta tus oportunidades

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

Verifique la elegibilidad para recibir financiación

{
    "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 el historial de la sesión

{
    "jsonrpc": "2.0",
    "id": 6,
    "method": "tools/call",
    "params": {
        "name": "getSession",
        "arguments": {
            "sessionId": "session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "catalog": "AWS"
        }
    }
}

Incorporación de socios

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

Otras tareas de incorporación que puedes probar:

Consideraciones de seguridad

Resolución de problemas

En la siguiente tabla se enumeran los errores más comunes y sus soluciones.

Siguientes pasos