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.
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
Esta página proporciona la referencia completa para conectarse al servidor MCP Agent de Partner Central y configurarlo.
Punto de conexión
| 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
Todas las acciones de IAM utilizan el partnercentral: prefijo, a menos que se indique lo contrario.
Acceso al protocolo MCP
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
| 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
| 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
| 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
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
| 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
| 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
| 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
Cargue el archivo en el depósito de S3 correspondiente con el prefijo de su ID de AWS cuenta.
Anote el URI de S3, incluido el
versionIddevuelto por la carga.Incluye el archivo como bloque de
documentcontenido en tusendMessagellamada.
Ejemplo de formato URI de S3:
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
Códigos de error
| 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
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)
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
Referencia de herramientas: documentación detallada
sendMessageygetSessionherramientas