Se reestructuró la referencia de la AWS Partner Central API. Para obtener más información sobre las operaciones de API compatibles, consulta la [referencia de la AWS Partner Central API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).

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.

# Referencia de la configuración
<a name="mcp-configuration-reference"></a>

Esta página proporciona la referencia completa para conectarse al servidor MCP Agent de Partner Central y configurarlo.

## Punto de conexión
<a name="mcp-config-endpoint"></a>


| Propiedad | Valor | 
| --- | --- | 
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp | 
| Region | us-east-1(Virginia del Norte) únicamente | 
| Protocolo | JSON-RPC 2.0 a través de HTTPS | 
| Transmisión | Server-Sent Eventos (SSE) | 
| Autenticación | AWS Versión exclusiva 4 | 
| Nombre del servicio SiGv4 | partnercentral-agents-mcp | 
| Requisito de TLS | TLS 1.2 o superior | 

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

Todas las acciones de IAM utilizan el `partnercentral:` prefijo, a menos que se indique lo contrario.

### Acceso al protocolo MCP
<a name="mcp-config-protocol-access"></a>

La forma más sencilla de conceder el acceso al protocolo MCP consiste en adjuntar la política `AWSMcpServiceActionsFullAccess` gestionada a su identidad de IAM. Esta política incluye todos los permisos necesarios para interactuar con el servidor MCP. Para un control más detallado, puede utilizar la clave de `aws:IsMcpServiceAction` condición de sus políticas de IAM para limitar los permisos específicamente a las acciones del servicio MCP.


| Action | Description (Descripción) | 
| --- | --- | 
| partnercentral:UseSession | Cree, actualice y recupere sesiones de conversación | 

### Gestión de oportunidades
<a name="mcp-config-opportunity-management"></a>


| Action | Description (Descripción) | 
| --- | --- | 
| partnercentral:List\* | Enumere las oportunidades, las soluciones y otros recursos de Partner Central | 
| partnercentral:Get\* | Recupere los detalles de las oportunidades individuales y otros recursos | 
| partnercentral:CreateOpportunity | Crea una oportunidad | 
| partnercentral:UpdateOpportunity | Modifique los campos de oportunidad (etapa, fecha de cierre, ingresos, etc.) | 
| partnercentral:SubmitOpportunity | Envíe una oportunidad de AWS revisión | 
| partnercentral:AssignOpportunity | Asigne una oportunidad a un representante de un socio | 
| partnercentral:AssociateOpportunity | Vincula una oportunidad a otro recurso (solución, etc.) | 
| partnercentral:DisassociateOpportunity | Eliminar un enlace entre una oportunidad y otro recurso | 
| partnercentral:StartEngagementFromOpportunityTask | Envíe oportunidades para iniciar una participación a partir de una oportunidad | 

### Programas de financiación
<a name="mcp-config-funding-programs"></a>


| Action | Description (Descripción) | 
| --- | --- | 
| partnercentral:ListBenefitAllocations | Enumere las asignaciones de beneficios disponibles para su cuenta | 
| partnercentral:ListBenefitApplications | Enumere las solicitudes de prestaciones presentadas | 
| partnercentral:CreateBenefitApplication | Cree una nueva solicitud de beneficios (MAP, POC, WMP) | 
| partnercentral:GetBenefitApplication | Recupere los detalles de una solicitud de beneficios específica | 
| partnercentral:UpdateBenefitApplication | Actualice una solicitud de prestación pendiente | 
| partnercentral:AssociateBenefitApplicationResource | Vincular un recurso a una solicitud de prestación | 
| partnercentral:DisassociateBenefitApplicationResource | Eliminar un enlace a un recurso de una solicitud de prestaciones | 

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


| Action | Description (Descripción) | 
| --- | --- | 
| aws-marketplace:DescribeEntity | Recupera los detalles de una entidad del mercado | 
| aws-marketplace:SearchAgreements | Busque acuerdos de mercado | 
| aws-marketplace:ListEntities | Enumere las entidades del mercado | 

### Agente de incorporación
<a name="mcp-config-onboarding-agent"></a>

**Administración de cuentas de socios (`partnercentral`):**


| Action | Description (Descripción) | 
| --- | --- | 
| partnercentral:ListPartners | Enumere los registros de socios en la cuenta | 
| partnercentral:GetPartner | Recupera los detalles de registro y perfil del socio | 
| partnercentral:GetProfileVisibility | Recupera la visibilidad del perfil actual (PUBLIC/PRIVATE) | 
| partnercentral:GetAllianceLeadContact | Recupera la información de contacto del líder de la alianza | 
| partnercentral:GetProfileUpdateTask | Compruebe el estado de una actualización de perfil asíncrona pendiente | 
| partnercentral:StartProfileUpdateTask | Envía una actualización del perfil de un socio (asíncrona) | 
| partnercentral:CancelProfileUpdateTask | Cancela una tarea de actualización de perfil pendiente | 
| partnercentral:PutProfileVisibility | Cambia la visibilidad del perfil a PÚBLICA o PRIVADA | 
| partnercentral:PutAllianceLeadContact | Actualice el contacto principal de la alianza (nombre, cargo, correo electrónico) | 
| partnercentral:SendEmailVerificationCode | Envía un código de verificación para los cambios basados en el correo electrónico domain/contact  | 
| partnercentral:AssociateAwsTrainingCertificationEmailDomain | Vincula un dominio de correo electrónico para el seguimiento de la certificación de formación | 
| partnercentral:DisassociateAwsTrainingCertificationEmailDomain | Eliminar un dominio de correo electrónico de certificación de formación vinculado | 
| partnercentral:GetAccountConnections | Enumere las conexiones de cuentas activas (p. ej., enlaces subsidiarios) | 
| partnercentral:GetConnectionInvitations | Enumere las invitaciones de conexión pendientes enviadas y recibidas | 
| partnercentral:CreateConnectionInvitation | Envía una invitación de conexión a otra AWS cuenta | 
| partnercentral:CancelConnectionInvitation | Cancela una invitación de conexión saliente pendiente | 
| partnercentral:RespondConnectionInvitation | Acepta o rechaza una invitación de conexión entrante | 
| partnercentral:CancelConnection | Cancela la conexión de una cuenta activa | 
| partnercentral:ManageConnectionPreferences | Obtenga o actualice las preferencias de uso compartido entre las cuentas conectadas | 

**Configuración de vendedor de Marketplace (`aws-marketplace`):**


| Action | Description (Descripción) | 
| --- | --- | 
| aws-marketplace:ListEntities | Listar entidades de Marketplace (p. ej., entidades vendedoras) | 
| aws-marketplace:DescribeEntity | Recuperar todos los detalles de una entidad de Marketplace | 
| aws-marketplace:DescribeChangeSet | Compruebe el estado de un conjunto de cambios enviado | 
| aws-marketplace:StartChangeSet | Envía un conjunto de cambios en Marketplace (por ejemplo, una actualización del perfil del vendedor) | 

**IAM: función vinculada al servicio (): `iam`**


| Action | Description (Descripción) | 
| --- | --- | 
| iam:GetRole | Compruebe si existe la función vinculada al servicio de autorización de reventa de Marketplace | 
| iam:CreateServiceLinkedRole | Creación del rol de AWSServiceRoleForMarketplaceResaleAuthorization | 

## Entornos de catálogo
<a name="mcp-config-catalog-environments"></a>


| Catálogo | Description (Descripción) | 
| --- | --- | 
| "AWS" | Entorno de producción. Todas las operaciones afectan a los datos de los socios en tiempo real. | 
| "Sandbox" | Entorno de pruebas aislado. Sin impacto en los datos de producción. Úselo para el desarrollo y la validación. | 

## Gestión de sesiones
<a name="mcp-config-session-management"></a>


| Propiedad | Valor | 
| --- | --- | 
| Formato de ID de sesión | UUID v4 con session- prefijo (por ejemplo,) session-550e8400-e29b-41d4-a716-446655440000 | 
| Creación de sesiones | Automático en la primera sendMessage llamada sin necesidad de sessionId | 
| Caducidad de la sesión | 48 horas desde la creación de la sesión (caducidad absoluta, no basada en la inactividad) | 

## Cargar archivo
<a name="mcp-config-file-upload"></a>


| Propiedad | Valor | 
| --- | --- | 
| Número máximo de archivos por mensaje | 3 | 
| Límite de tamaño de imagen | 3,75 MB | 
| Límite de tamaño del documento | 4,5 MB | 
| Extensiones permitidas | doc, docx, pdf, png, jpeg, xlsx, csv, txt | 
| Cubeta S3 (producción) | aws-partner-central-marketplace-efemeral-writeonly-files | 
| Ruta de subida | s3://{bucket}/{aws-account-id}/ | 
| Requisito de URI de S3 | Debe incluir el parámetro versionId de consulta | 

### Cargar flujo de trabajo
<a name="mcp-config-upload-workflow"></a>

1. Cargue el archivo en el depósito de S3 correspondiente con el prefijo de su ID de AWS cuenta.

1. Anote el URI de S3, incluido el `versionId` devuelto por la carga.

1. Incluye el archivo como bloque de `document` contenido en tu `sendMessage` llamada.

Ejemplo de formato URI de S3:

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

## Códigos de error
<a name="mcp-config-error-codes"></a>


| Code | Name | Description (Descripción) | 
| --- | --- | --- | 
| -32001 | AUTHENTICATION\_FAILURE | La firma SigV4 no es válida o las credenciales han caducado | 
| -31004 | TOOL\_PERMISSION\_DENIED | La identidad de IAM carece de la partnercentral: acción necesaria para esta operación | 
| -32002 | ACCESS\_DENIED | Acceso general denegado (la cuenta no está inscrita, la región no coincide, etc.) | 
| -32004 | LIMIT\_EXCEEDED | Se ha superado el límite de tarifa o la cuota. Vuelva a intentarlo con un retroceso exponencial. | 
| -30001 | RESOURCE\_NOT\_FOUND | El recurso solicitado (sesión, oportunidad, etc.) no existe | 
| -32600 | INVALID\_REQUEST |  JSON-RPC Solicitud con formato incorrecto o parámetros no válidos | 
| -32603 | INTERNAL\_ERROR | Server-side error. Intente realizar de nuevo la solicitud . | 

## Límites de frecuencia
<a name="mcp-config-rate-limits"></a>

El servidor impone límites de tarifas por cuenta:


| Operación | Tasa sostenida | Ráfaga | 
| --- | --- | --- | 
| sendMessage | Dos solicitudes por minuto | 10 | 
| Otras operaciones | 10 solicitudes por minuto | 20 | 

Si superas estos límites, el servidor devuelve el código de error `-32004` (LIMIT\_EXCEEDED). Implemente un retardo exponencial con fluctuación en su cliente para gestionar la limitación de velocidad sin problemas.

## Tipos de eventos de streaming (SSE)
<a name="mcp-config-sse-events"></a>

Cuando `stream` se establece `true` en una `sendMessage` llamada, el servidor devuelve los Server-Sent eventos con los siguientes tipos de eventos:


| Tipo de evento | Description (Descripción) | 
| --- | --- | 
| stream\_start | Conexión de transmisión establecida | 
| assistant-response.start | El agente ha empezado a generar una respuesta | 
| assistant-response.delta | Fragmento de texto incremental de la respuesta del agente | 
| assistant-response.completed | El agente ha terminado de generar la respuesta | 
| server-tool-use | El agente está invocando una herramienta interna (operación de lectura) | 
| server-tool-response | Resultado de la invocación de una herramienta interna | 
| tool\_approval\_request | El agente solicita la aprobación humana para una operación de escritura | 
| stream\_end | Se cierra la conexión de Stream | 
| done | Evento final que indica que la transmisión de SSE ha completado | 

## Siguientes pasos
<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): documentación detallada `sendMessage` y `getSession` herramientas