View a markdown version of this page

Uso de conectores gestionados por socios - AWS DevOps Agente

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.

Uso de conectores gestionados por socios

Se conecta un conector administrado por un socio AWS DevOps El agente se dirige a un servidor de Model Context Protocol (MCP) que aloja un socio. Los ejemplos incluyen el servicio de observabilidad o gestión de incidentes de un socio. El socio publica el conector en el AWS DevOps Repositorio de herramientas del agente en el GitHub sitio web. El conector define los puntos finales del servidor y los métodos de autenticación que acepta. También puede enumerar las habilidades recomendadas por el socio.

Con un conector, no es necesario buscar las URL de los puntos finales, las URL de OAuth o los ámbitos del socio. Eliges un punto final e ingresas solo tus propias credenciales, y AWS DevOps El agente crea el resto del registro a partir del conector. Utilice un conector cuando el socio publique uno para su servidor MCP. Para obtener instrucciones sobre cómo registrar cualquier otro servidor MCP, consulte Registrar un servidor MCP.

En este tema, conector significa la definición del socio, y servidor MCP se refiere al registro que se crea a partir de él. La consola usa los mismos términos, por ejemplo Eliminar el servidor MCP.

Un conector registra un servidor MCP, por lo que sus herramientas funcionan igual que en un servidor MCP que usted mismo registre. Un conector también proporciona lo siguiente:

  • Configuración fija — Las URL de los puntos finales, los métodos de autenticación y las URL y los ámbitos de OAuth provienen del conector. No puedes cambiarlos.

  • Habilidades recomendadas — Puede instalar las habilidades recomendadas por el conector al agregarlo a un espacio de agentes. Más adelante, puede instalar más, activarlos o desactivarlos o eliminarlos.

  • Webhook de alerta — Al añadir el conector a un espacio de agentes, AWS DevOps El agente crea un webhook para que las alertas del producto del socio puedan iniciar las investigaciones. Algunos conectores también definen automáticamente la carga útil de las alertas.

Cómo funcionan los conectores gestionados por los socios

En la siguiente lista se describe quién administra el servidor de un conector y a dónde van los datos:

  • Funcionamiento del servidor — El socio opera y brinda soporte al servidor MCP. AWS no lo opera. Para obtener ayuda con el servidor, utilice el Soporte enlace para el conector de la consola.

  • Mantenimiento del conector — Cada conector muestra un Partner-managed o AWS-gestionado insignia. La insignia nombra a quien mantiene la definición del conector.

  • Credenciales — Sus credenciales solo se dirigen a las URL de la definición del conector.

  • Solicitudes — El punto final que elijas pertenece a la región o al sitio del socio para tu cuenta con el socio. Puede estar fuera del AWS Región de su espacio de agente. Como ocurre con cualquier servidor MCP al que se conecte, las solicitudes al servidor lo abandonan AWS Región.

Registros y versiones

En la lista siguiente se describe cómo se relaciona un registro con los espacios de agente y las versiones de los conectores:

  • Alcance del registro — Registra un conector una vez en su AWS cuenta. Luego, lo agrega a cada espacio de agente que lo necesite.

  • Versiones — Un registro conserva la versión del conector que ha registrado. Cuando un socio deja de usar un conector, este deja de aparecer en el Disponible sección, y no puedes volver a registrarla. Su tarjeta está debajo Registrado actualmente muestra Obsoleto, y la página que Ver todo Las aperturas pueden asignar un nombre al conector que lo reemplaza. Los registros existentes seguirán funcionando hasta que los cancele.

Una habilidad recomendada es una habilidad que el socio sugiere para su conector, como una guía sobre el uso de las herramientas del socio durante una investigación. Las habilidades recomendadas provienen del catálogo de habilidades del AWS DevOps Repositorio de herramientas del agente en el GitHub sitio web. Puede instalar las habilidades recomendadas al agregar el conector a un espacio de agentes. Cuando edite el servidor MCP más adelante, puede instalar más habilidades, habilitar o deshabilitar las habilidades instaladas o eliminarlas.

Una habilidad recomendada instalada aparece junto con las demás habilidades de su espacio de agente. Su contenido proviene del catálogo, por lo que no puede editarlo. El agente lo carga de la misma forma que cualquier otra habilidad. Para obtener más información sobre las habilidades, consulte DevOps Habilidades de los agentes.

Antes de empezar

Para usar un conector administrado por un socio, compruebe que dispone de lo siguiente:

  • Una cuenta con el socio que pueda crear las credenciales que requiere el conector, como una clave de API o un cliente de OAuth. La guía de configuración del conector enumera los pasos del producto del socio.

  • Permiso para registrar proveedores de capacidades y agregar capacidades a un espacio de agentes en el AWS DevOps Consola de agentes.

  • (Opcional) Una conexión privada existente, si llegas al punto final del socio a través de una red privada. Para obtener más información sobre las conexiones privadas, consulte Conectarse a herramientas alojadas de forma privada.

Para obtener más información acerca de las consideraciones de seguridad que se aplican a cualquier servidor MCP, como incluir en la lista de permisos únicamente las herramientas que necesita, consulte Consideraciones de seguridad.

Encontrar un conector

Busque un conector para consultar su guía de configuración y las habilidades recomendadas antes de registrarlo. Puedes empezar por el Proveedores de capacidades página o desde un espacio de agentes.

Búsqueda de un conector en la página de proveedores de capacidades

Para buscar un conector en Proveedores de capacidades página, complete los siguientes pasos:

  1. Abra el AWS DevOps Consola de agente en https://console.aws.amazon.com/devops-agent/.

  2. En el panel de navegación, elige Proveedores de capacidades.

  3. En el Disponible sección, encuentra el conector. Para reducir la lista, introduzca su nombre en Encuentre la capacidad, o elige una categoría. Cada tarjeta muestra la insignia, la descripción y las categorías del conector.

  4. Elige el nombre del conector.

Se abre la página del conector. Para omitirlo e iniciar el registro, puede elegir Registrarse en su lugar, en la tarjeta.

Cómo encontrar un conector desde un Agent Space

Para buscar un conector desde un espacio de agentes, complete los pasos siguientes:

  1. Abra el AWS DevOps Consola de agente en https://console.aws.amazon.com/devops-agent/y, a continuación, seleccione su espacio de agente.

  2. Elija la pestaña Capacidades.

  3. En la sección correspondiente a la categoría del conector, como Telemetría, Comunicaciones, o DevOps, elige Añadir.

  4. En Agregue una capacidad, en Partner-managed conectores, elige Registrarse.

  5. En la lista de conectores, elija Seleccione para el conector.

Se abre la página del conector.

Qué muestra la página del conector

La página del conector muestra la siguiente información:

  • El socio, la versión del conector y sus categorías

  • Enlaces a la documentación y el soporte del socio

  • La guía de configuración del conector

  • Las habilidades que recomienda el conector

Para iniciar el registro, elija Registrarse. Para obtener instrucciones, consulte Registrar un conector.

Registrar un conector

Al registrar un conector, AWS DevOps El agente crea un registro de servidor MCP en su AWS cuenta a partir de la definición del conector. El registro consta de cuatro pasos. La consola omite los pasos que el conector no necesita.

Paso 1: detalles del servidor MCP

En este paso, asigne un nombre al servidor MCP y elija dónde AWS DevOps El agente se conecta. El título del paso incluye el nombre del conector, por ejemplo Ejemplo: detalles del servidor Corp MCP.

Si el paso se muestra Guía de configuración, amplíela antes de rellenar el formulario y complete los pasos del socio. Muestran cómo crear las credenciales que se introducen Paso 3: Configuración de la autenticación. Para conservar una copia de los pasos, elige Copiar.

Introduzca la información siguiente:

  • Nombre — Introduzca un nombre corto para este servidor MCP. La consola rellena el nombre del conector, que puede cambiar. Usa letras, números, guiones (-) y guiones bajos (_). El nombre debe ser único en su AWS cuenta. AWS DevOps El agente agrega el nombre al principio de cada nombre de herramienta y el nombre de una herramienta puede tener como máximo 64 caracteres, así que mantenga el nombre corto.

  • Punto final — Algunos socios ofrecen más de un punto final, como un sitio regional. Si es así, elige el punto final que usa tu cuenta con el socio. De lo contrario, la consola muestra el punto final del conector. La URL del punto final aparece en AWS CloudTrail inicia sesión en tu cuenta.

  • Campos de conector — Algunos conectores solicitan más valores, como el nombre de la instancia con el partner. Cada campo muestra la etiqueta que le asigna el conector. Introduzca el valor de su cuenta con el socio.

  • Conéctese al punto final mediante una conexión privada — (Opcional) Seleccione esta opción para dirigir las solicitudes al punto final del socio a través de una conexión privada existente. En el caso de un conector que utilice OAuth, puedes elegir una conexión privada independiente para el intercambio de tokens.

  • Configuración avanzada — (Opcional) Elija un cliente gestionado AWS Servicio de administración de claves (AWS clave (KMS) para cifrar el registro. Para obtener más información sobre el cifrado, consulte Cifrado en reposo para DevOps ¿Agente.

Elija Siguiente.

Paso 2: Método de autenticación

En este paso, tú eliges cómo AWS DevOps El agente se autentica en el producto del socio. Este paso solo aparece cuando el conector ofrece más de un método de autenticación. El conector define el orden de los métodos. Seleccione una de las siguientes opciones:

  • Clave de API — AWS DevOps El agente se autentica con una clave que usted crea en el producto del socio para que usted controle sus permisos.

  • Credenciales del cliente de OAuth — AWS DevOps El agente se autentica con un identificador de cliente y un secreto que usted crea en el producto del socio.

  • Inicia sesión en compañero (por ejemplo, Inicie sesión en Example Corp) — AWS DevOps El agente actúa en tu nombre después de que inicies sesión en el producto del socio.

  • Inicie sesión con un registro dinámico de clientes — AWS DevOps El agente registra su propio cliente de OAuth con el partner y, a continuación, actúa en tu nombre tras iniciar sesión.

Elija Siguiente.

Paso 3: Configuración de la autenticación

En este paso, introduzca las credenciales que necesita su método de autenticación. El Definido por el conector La sección muestra los valores que establece el conector, que no se pueden cambiar.

La consola omite este paso para Inicie sesión con un registro dinámico de clientes. También omite este paso para Inicia sesión en compañero cuando el conector proporciona su propio cliente de OAuth.

Clave de API

En el caso de una clave de API, introduce un valor para cada encabezado que aparezca en el conector. El conector establece el nombre del encabezado y cualquier prefijo, como Bearer , así que introduzca solo la clave.

Credenciales del cliente OAuth

Para obtener las credenciales del cliente de OAuth, complete los pasos siguientes:

  1. Introduzca el ID de cliente y Secreto del cliente que creaste en el producto del socio.

  2. (Opcional) Añadir Ámbitos adicionales y Parámetros de intercambio adicionales. AWS DevOps El agente los solicita además de los alcances y parámetros que define el conector.

Inicie sesión con el socio

Para Inicia sesión en compañero, complete los pasos siguientes:

  1. Si el conector no proporciona su propio cliente de OAuth, introduzca ID de cliente y Secreto del cliente que creaste en el producto del socio. Si el socio admite Proof Key for Code Exchange (PKCE), puedes dejar el secreto del cliente vacío.

  2. (Opcional) Agregar Ámbitos adicionales.

Elija Siguiente.

Paso 4: Revisa y regístrate

Para finalizar el registro, complete los siguientes pasos:

  1. Revisa los detalles. Para cambiar un paso, elige Editar en la sección correspondiente a ese paso.

  2. Elija Registro.

  3. Si has elegido un método de inicio de sesión, inicia sesión en la página del partner que se abre en la consola y, a continuación, aprueba el acceso.

La consola vuelve a AWS DevOps Agente, y el registro está completo. Si se registró desde un espacio de agentes, la consola abre los pasos para agregar el conector a ese espacio de agentes. Si se registró desde el Proveedores de capacidades página, consulte Agregar un conector a un espacio de agentes.

Si el registro falla, la consola permanece en la etapa de revisión y muestra el error. Corrija los detalles y, a continuación, elija Registrarse otra vez.

Agregar un conector a un espacio de agentes

Cuando agrega un conector a un espacio de agentes, elige las herramientas que los agentes pueden usar allí y, de manera opcional, instala las habilidades recomendadas para el conector. Si ha registrado el conector desde Proveedores de capacidades página, comience desde su espacio de agente:

  1. Abre el AWS DevOps Consola de agente en https://console.aws.amazon.com/devops-agent/y, a continuación, seleccione su espacio de agente.

  2. Elija la pestaña Capacidades.

  3. En la sección correspondiente a la categoría del conector, elija Añadir.

  4. En Agregue una capacidad, busque el servidor MCP que ha registrado desde el conector y, a continuación, elija Agregar.

Paso 1: seleccionar herramientas

En este paso, usted elige las herramientas que el agente puede usar en este espacio de agentes. Seleccione solo las herramientas que necesita su espacio de agente. Si clasifica las herramientas como de solo lectura o mutantes, elija una clasificación para cada herramienta. Para obtener más información sobre la clasificación de herramientas, consulte Trabajar con acciones dirigidas. Para obtener más información sobre la cantidad máxima de herramientas de MCP en un espacio de agentes, consulte Cuotas.

Algunos conectores también muestran Tipo de autenticación de webhook. Elija cómo se autentica el producto del socio en el webhook de alertas de Agent Space: HMAC (predeterminado) o Clave de API. Los conectores que definen sus propias alertas lo configuran por usted.

Para omitir el paso de habilidades opcionales, elija Ir directamente a Revisar y guardar. En caso contrario, elija Siguiente.

Este paso solo aparece cuando el conector recomienda habilidades. En este paso, elige las habilidades recomendadas para la instalación. La consola muestra las habilidades recomendadas por el conector, sin seleccionar ninguna. Se muestra una habilidad que ya está instalada en el espacio de agentes Habilitado o Discapacitado, y no puedes seleccionarlo. Seleccione las habilidades que desea instalar y, a continuación, elija Siguiente.

Paso 3: revisar y guardar

Para guardar el conector en el espacio de agentes, complete los pasos siguientes:

  1. Revise las herramientas, las habilidades y Webhook de alertas escriba. Para cambiarlos, elija Editar en su sección.

  2. Seleccione Save.

AWS DevOps El agente agrega el servidor MCP al espacio de agentes y, a continuación, instala las habilidades que haya seleccionado. Si una habilidad no se instala, aparece una notificación y el servidor MCP permanece en el espacio de agente. Para volver a intentarlo, edite el conector en el espacio de agentes y, a continuación, seleccione la habilidad. Para obtener instrucciones, consulte Edición de un conector en un espacio de agentes.

Configurar el webhook de alertas

Después de elegir Guardar, se abre la consola Configura el webhook de alertas. Se abre cada vez que se agrega el conector a un espacio de agentes, pero no cuando se edita el conector. Tras configurar el webhook, cada alerta que se le envíe inicia una investigación en el Agent Space.

Para configurar el webhook, siga los pasos siguientes:

  1. Copia el URL del webhook, el Cabecera o Secreto de firma, y el Cuerpo de la solicitud o Formato de cuerpo de solicitud. Para guardar la URL y el secreto en un archivo, elige Descarga el archivo.csv. AWS DevOps El agente muestra el secreto solo una vez.

  2. Seleccione He guardado y almacenado mi URL y mis credencialesy, a continuación, elija Listo.

  3. Configura el webhook en el producto del socio. Para obtener instrucciones, consulte la guía de configuración del conector.

Los valores funcionan de la siguiente manera:

  • URL de webhook — La URL a la que el producto del socio envía alertas.

  • Encabezado — En el caso de un webhook que utilice un token de portador, el Authorization: Bearer el encabezado que el producto del socio envía con cada solicitud.

  • Secreto de firma — En el caso de un webhook que firma solicitudes, el secreto que el producto del socio utiliza para firmar timestamp:body con HMAC-SHA256. El producto del socio envía la marca de tiempo en el x-amzn-event-timestamp el encabezado y la firma en x-amzn-event-signature encabezado.

  • Cuerpo de la solicitud — En el caso de un conector que define sus alertas, la carga útil de las alertas. El producto del socio rellena los valores de su plantilla cuando se activa una alerta.

  • Formato del cuerpo de la solicitud — Para cualquier otro conector, el formato JSON que debe usar cada alerta. Asigne a cada alerta un carácter único incidentId.

¿Cuál de Encabezado o Secreto de firma verás, depende de cómo se autentique el webhook. O el conector lo configura o tú lo eliges en Selecciona herramientas. No depende del método de autenticación que haya elegido al registrar el conector.

Para obtener más información sobre la autenticación y la carga útil del webhook, consulta Invocando DevOps Agente a través de Webhook. Para obtener más información sobre la sustitución de un secreto perdido, consulte Rotación de credenciales de webhook.

Donde aparece el conector

En el Capacidades pestaña, el conector aparece en la sección correspondiente a su primera categoría: Telemetría, Gasoducto, Comunicaciones, o DevOps. Un conector cuya primera categoría es Nube, o que el catálogo ya no aparece en la lista, aparece en Servidor MCP sección.

Edición de un conector en un espacio de agentes

Puede cambiar las herramientas de un conector en un espacio de agentes e instalar, habilitar, deshabilitar o eliminar las habilidades recomendadas. Para editar un conector, lleve a cabo los pasos siguientes:

  1. Abra el AWS DevOps Consola de agente en https://console.aws.amazon.com/devops-agent/y, a continuación, seleccione su espacio de agente.

  2. En el Capacidades pestaña, seleccione el servidor MCP en su sección y, a continuación, elija Editar.

  3. En Seleccione herramientas, cambie las herramientas. La consola se inicia a partir de las herramientas que ha guardado. Si el servidor MCP ya no muestra una herramienta guardada, la consola la elimina de la selección y muestra una advertencia.

  4. Encendido Seleccione las habilidades recomendadas, seleccione las habilidades que desea conservar o instalar. Para eliminar una habilidad instalada, desmárquela.

  5. (Opcional) Activado Definir el estado de habilidad, activa o desactiva cada habilidad instalada. Los agentes usan solo las habilidades que están activadas. Este paso solo aparece cuando al menos una habilidad permanece instalada.

  6. ¿Activado Revisa y guarda, revisa el cambio realizado en cada habilidad y, a continuación, elige Guarda.

AWS DevOps El agente guarda los cambios y el webhook de alerta permanece igual. Antes de guardar, la revisión le avisa si el cambio elimina habilidades. También te avisa si otro conector del espacio de agentes recomienda deshabilitar o eliminar una habilidad, ya que el cambio se aplica también a ese conector. Puede volver a instalar una habilidad eliminada más adelante.

Si se produce un error en un cambio de habilidad, aparecerá en una notificación y los demás cambios se conservarán. Para volver a intentarlo, vuelva a editar el conector.

Eliminar un conector de un espacio de agente

Para eliminar un conector de un espacio de agentes, siga estos pasos:

  1. Abra el AWS DevOps Consola de agente en https://console.aws.amazon.com/devops-agent/y, a continuación, seleccione su espacio de agente.

  2. En el Capacidades pestaña, seleccione el servidor MCP en su sección y, a continuación, elija Eliminar.

  3. En Eliminar el servidor MCP, revise la confirmación y, a continuación, elija Eliminar.

El servidor MCP se elimina del espacio de agentes. Al eliminarlo también se eliminan las habilidades recomendadas del conector que están instaladas en el espacio de agentes. Esto incluye una habilidad recomendada que ha instalado usted mismo. Una habilidad permanece instalada si otro conector del espacio de agentes también la recomienda. La confirmación asigna un nombre a la habilidad o indica el número de habilidades antes de eliminar nada. Esta acción no se puede deshacer.

Si AWS DevOps El agente no puede comprobar qué habilidades están instaladas, la confirmación así lo indica. En ese caso, las habilidades permanecen instaladas y Eliminar elimina solo el servidor MCP.

Actualizar o anular el registro de un conector

Para encontrar el registro de un conector, siga estos pasos:

  1. Abra el AWS DevOps Consola de agente en https://console.aws.amazon.com/devops-agent/.

  2. En el panel de navegación, elige Proveedores de capacidades.

  3. Bajo Registrado actualmente, busca la tarjeta del conector y, a continuación, elige Ver todo.

  4. En Inscripciones, seleccione el servidor MCP.

Si el registro usa Inicie sesión en compañero o Inicie sesión con un registro dinámico de clientes, puedes volver a iniciar sesión sin anular el registro, por ejemplo, después de que el socio revoque el acceso. Elige Accionesy, a continuación, elija Actualizar. En el paso de revisión, sal URL de autorización vacío, elige Actualizary, a continuación, inicie sesión en la página del socio. AWS DevOps El agente actualiza su acceso y las credenciales de cliente y las asociaciones de Agent Space permanecen iguales.

Para cambiar una clave de API o las credenciales de un cliente de OAuth, o para usar una versión más reciente del conector, anule el registro del servidor MCP y vuelva a registrar el conector. Para anular el registro, primero elimine el servidor MCP de cada espacio de agente que lo utilice. Para obtener instrucciones, consulte Eliminar un conector de un espacio de agentes. Luego seleccione el servidor MCP, elija Acciones, y elige Anular el registro. La consola anula el registro del servidor MCP de inmediato, sin pedirle que confirme.

Solución de problemas de conectores gestionados por el socio

Utilice la siguiente información para resolver problemas comunes relacionados con los conectores gestionados por los socios.

«Este conector no define una URL para el punto final que ha elegido»

Este error significa que la definición del conector no incluye el punto final que ha elegido. Para resolverlo, elija otro punto final. Si el error continúa, póngase en contacto con el soporte técnico del conector.

El registro falla porque el nombre está en uso

Los nombres de los servidores MCP deben ser únicos en su AWS cuenta. Para resolver este problema, introduce otro nombre en Paso 1: detalles del servidor MCPy, a continuación, vuelva a registrarse.

La página del webhook de alertas no muestra ninguna credencial

Si Configurar un webhook de alertas muestra un error en lugar del encabezado o el secreto de firma, AWS DevOps El agente no devolvió la credencial del webhook. Para obtener una, gira el webhook. Para obtener instrucciones, consulte Rotación de credenciales de webhook.

Las alertas no inician las investigaciones

El producto del partner debe enviar la solicitud exactamente como la mostró la consola. Para resolver este problema, siga estos pasos:

  1. En el producto del partner, comprueba que el webhook utilice la URL del webhook de la consola.

  2. Comprueba que cada solicitud incluya la Authorization encabezado, o el x-amzn-event-timestamp y x-amzn-event-signature encabezados para un webhook firmado.

  3. Comprueba que el cuerpo de la solicitud coincide con el Cuerpo de la solicitud o Formato de cuerpo de solicitud desde la consola.

Para obtener más pasos para la solución de problemas, consulte Solución de problemas de webhooks.