View a markdown version of this page

Comience con AWS Registro de agentes - Base amazónica AgentCore
Requisitos previosPaso 1: Crear un registroPaso 2: Agregar un registro de registroPaso 3: Enviar el registro para su aprobaciónPaso 4: Aprobar el registroPaso 5: Descubra los registros aprobadosLo que has construidoSiguientes pasos

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.

Comience con AWS Registro de agentes

La migración ya está abierta

AWS El registro de agentes se ha lanzado en el nuevo espacio de agent-registry nombres. La compatibilidad con el espacio de bedrock-agentcore nombres de versión preliminar pública dejará de funcionar el 17 de septiembre de 2026. Para obtener instrucciones sobre la migración, consulta la Guía Guía completa de migración de registros completa de migración del registro.

En esta guía, crearás tu primer registro, añadirás un registro, lo aprobarás y lo buscarás.

Requisitos previos

Complete los pasos de la sección Requisitos previos.

Paso 1: Crear un registro

Cree un registro con la autorización de IAM y la aprobación manual.

Consola

Crear un registro con autorización IAM-based

ejemplo
AWS Agent Registry namespace

  1. Abra la consola AWS de registro del agente.

  2. En el panel de navegación, elija Registry.

  3. En la sección Registros, elija Crear registro.

  4. En la sección Detalles del registro, en Nombre, introduce un nombre para tu registro. El nombre debe empezar por un carácter alfanumérico. Los caracteres válidos son a-z, A—Z, 0—9, _ (guión bajo), - (guión), (punto) y . (barra diagonal). / El nombre puede tener hasta 64 caracteres.

  5. (Opcional) Seleccione Detalles adicionales para expandir la sección y, a continuación, en Descripción, escriba una descripción que ayude a identificar este registro.

  6. En la sección Autorización de detección, para el tipo de autenticación, elija Usar autorización de IAM (autorización entrante).

  7. En la sección de aprobación de registros, activa o desactiva: Auto-approval

    • Cuando Auto-approval está activada, cuando envías un registro para su aprobación, el registro pasa directamente al estado Aprobado y pasa a ser visible en los resultados de búsqueda poco después.

    • Cuando Auto-approval está desactivada, cuando envías un registro para su aprobación, el registro pasa al estado Pendiente de aprobación y es necesario que un responsable lo revise y apruebe antes de que se publique.

  8. (Opcional) En la sección Etiquetas, selecciona Agregar nueva etiqueta para adjuntar una o más etiquetas al registro. Cada etiqueta tiene una clave y un valor opcional.

  9. Elige Crear registro.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra la página de registro de AWS agentes en la Bedrock-AgentCore consola.

  2. En el panel de navegación, seleccione Registro.

  3. En la sección Registros, elija Crear registro.

  4. En la sección Detalles del registro, en Nombre, introduce un nombre para tu registro. El nombre debe empezar por un carácter alfanumérico. Los caracteres válidos son a-z, A—Z, 0—9, _ (guión bajo), - (guión), (punto) y . (barra diagonal). / El nombre puede tener hasta 64 caracteres.

  5. (Opcional) Seleccione Detalles adicionales para expandir la sección y, a continuación, en Descripción, escriba una descripción que ayude a identificar este registro.

  6. En la sección Autorización de la API de búsqueda, para el tipo de autenticación, elige Usar autorización de IAM (autorización entrante).

  7. En la sección de aprobación de registros, activa o desactiva: Auto-approval

    • Cuando Auto-approval está activada, cuando envías un registro para su aprobación, el registro pasa directamente al estado Aprobado y pasa a ser visible en los resultados de búsqueda poco después.

    • Cuando Auto-approval está desactivada, cuando envías un registro para su aprobación, el registro pasa al estado Pendiente de aprobación y es necesario que un responsable lo revise y apruebe antes de que se publique.

  8. Selecciona Crear registro.

Crear un registro con JWT-based autorización

La autorización del proveedor de identidades utiliza JSON Web Tokens (JWT) para controlar el acceso a las API del plano de datos detectables y al punto final MCP del registro. Puede usar Amazon Cognito para configurar rápidamente la autorización o utilizar su propio proveedor de identidad para habilitar OAuth 2.0.

ejemplo
AWS Agent Registry namespace

  1. Abra la consola de registro de AWS agentes.

  2. En el panel de navegación, elija Registry.

  3. En la sección Registros, elija Crear registro.

  4. En la sección Detalles del registro, en Nombre, introduce un nombre para tu registro. El nombre debe empezar por un carácter alfanumérico. Los caracteres válidos son a-z, A—Z, 0—9, _ (guión bajo), - (guión), (punto) y . (barra diagonal). / El nombre puede tener hasta 64 caracteres.

  5. (Opcional) Seleccione Detalles adicionales para expandir la sección y, a continuación, en Descripción, escriba una descripción que ayude a identificar este registro.

  6. En la sección Autorización de detección, para el tipo de autenticación, elija Usar tokens web JSON (JWT) (autorización entrante).

  7. Para la configuración del esquema JWT, elige una de las siguientes opciones:

    1. Creación rápida de configuraciones con Cognito (recomendado): AWS Agent Registry crea las configuraciones de autorización en su nombre utilizando Amazon Cognito como proveedor de identidad. No se necesita configuración adicional.

    2. Utilice las configuraciones de proveedores de identidad existentes: traiga su propio proveedor de identidades para habilitar OAuth 2.0. Si eliges esta opción, completa los siguientes pasos:

      1. Para la URL de descubrimiento, introduce la URL de descubrimiento de tu proveedor de identidad. AWS Agent Registry usa esta URL para obtener automáticamente la configuración de inicio de sesión, token y verificación de tu proveedor. Puedes encontrar esta URL en el panel de control o en la documentación de tu proveedor de identidad (por ejemplo,https://cognito-identity.amazonaws.com/.well-known/openid-configuration).

        nota

        La URL de descubrimiento no se puede cambiar una vez creado el registro.

      2. (Opcional) En la configuración de autorización de JWT, seleccione Audiencias permitidas para obtener una lista de las audiencias permitidas que el Registro del AWS Agente valida a la luz de la aud afirmación contenida en el token de JWT. En OAuth 2.0, una declaración de audiencia (aud) especifica a qué servidor de recursos (API) está destinado el token. Esto garantiza que el token sea el destinatario correcto antes de procesar la solicitud, lo que evita que un token se vuelva a utilizar en una API diferente para la que no se emitió.

      3. (Opcional) Seleccione Clientes permitidos para proporcionar una lista de los identificadores de clientes permitidos que AWS Agent Registry valide para compararlos con la client_id afirmación contenida en el token de JWT. A client_id es un identificador público y único para una aplicación que solicita tokens de acceso para acceder a las API del plano de datos detectables o al punto final MCP del registro. Si habilita esta opción, introduzca uno o más identificadores de cliente en el campo Clientes y, a continuación, seleccione Agregar cliente para agregar más clientes.

      4. (Opcional) Seleccione Ámbitos permitidos para obtener una lista de los permisos permitidos, definidos como ámbitos. Si está configurado, al menos un valor de ámbito del token entrante debe coincidir con uno de los valores configurados. Los ámbitos actúan como permisos para limitar lo que puede hacer una aplicación.

      5. (Opcional) Seleccione las notificaciones personalizadas para proporcionar un conjunto de reglas que hagan coincidir las notificaciones específicas del token entrante con los valores predefinidos. Para cada regla, especifique el nombre de la notificación, el tipo de valor (STRING o STRING_ARRAY) y el valor de coincidencia requerido.

  8. En la sección de aprobación de registros, activa o desactiva: Auto-approval

    1. Cuando Auto-approval está activada, cuando envías un registro para su aprobación, el registro pasa directamente al estado Aprobado y se muestra inmediatamente en los resultados de la búsqueda.

    2. Cuando Auto-approval está desactivada, cuando envías un registro para su aprobación, el registro pasa al estado Pendiente de aprobación y es necesario que un administrador del registro lo revise y apruebe antes de publicarlo.

  9. (Opcional) En la sección Etiquetas, selecciona Agregar nueva etiqueta para adjuntar una o más etiquetas al registro. Cada etiqueta tiene una clave y un valor opcional.

  10. Elige Crear registro.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra la página de registro de AWS agentes en la Bedrock-AgentCore consola.

  2. En el panel de navegación, seleccione Registro.

  3. En la sección Registros, elija Crear registro.

  4. En la sección Detalles del registro, en Nombre, introduce un nombre para tu registro. El nombre debe empezar por un carácter alfanumérico. Los caracteres válidos son a-z, A—Z, 0—9, _ (guión bajo), - (guión), (punto) y . (barra diagonal). / El nombre puede tener hasta 64 caracteres.

  5. (Opcional) Seleccione Detalles adicionales para expandir la sección y, a continuación, en Descripción, escriba una descripción que ayude a identificar este registro.

  6. En la sección Autorización de la API de búsqueda, para el tipo de autenticación, elige Usar tokens web JSON (JWT) (autorización entrante).

  7. Para la configuración del esquema JWT, elige una de las siguientes opciones:

    1. Creación rápida de configuraciones con Cognito (recomendado): AWS Agent Registry crea las configuraciones de autorización en su nombre utilizando Amazon Cognito como proveedor de identidad. No se necesita configuración adicional.

    2. Utilice las configuraciones de proveedores de identidad existentes: traiga su propio proveedor de identidades para habilitar OAuth 2.0. Si eliges esta opción, completa los siguientes pasos:

      1. Para la URL de descubrimiento, introduce la URL de descubrimiento de tu proveedor de identidad. AWS Agent Registry usa esta URL para obtener automáticamente la configuración de inicio de sesión, token y verificación de tu proveedor. Puedes encontrar esta URL en el panel de control o en la documentación de tu proveedor de identidad (por ejemplo,https://cognito-identity.amazonaws.com/.well-known/openid-configuration).

        nota

        La URL de descubrimiento no se puede cambiar una vez creado el registro.

      2. (Opcional) En la configuración de autorización de JWT, seleccione Audiencias permitidas para obtener una lista de las audiencias permitidas que el Registro del AWS Agente valida a la luz de la aud afirmación contenida en el token de JWT. En OAuth 2.0, una declaración de audiencia (aud) especifica a qué servidor de recursos (API) está destinado el token. Esto garantiza que el token sea el destinatario correcto antes de procesar la solicitud, lo que evita que un token se vuelva a utilizar en una API diferente para la que no se emitió.

      3. (Opcional) Seleccione Clientes permitidos para proporcionar una lista de los identificadores de clientes permitidos que AWS Agent Registry valide para compararlos con la client_id afirmación contenida en el token de JWT. A client_id es un identificador público y único para una aplicación que solicita tokens de acceso para acceder a la API de búsqueda del registro. Si habilita esta opción, introduzca uno o más identificadores de cliente en el campo Clientes y, a continuación, seleccione Agregar cliente para agregar más clientes.

      4. (Opcional) Seleccione Ámbitos permitidos para obtener una lista de los permisos permitidos, definidos como ámbitos. Si está configurado, al menos un valor de ámbito del token entrante debe coincidir con uno de los valores configurados. Los ámbitos actúan como permisos para limitar lo que puede hacer una aplicación.

      5. (Opcional) Seleccione las notificaciones personalizadas para proporcionar un conjunto de reglas que hagan coincidir las notificaciones específicas del token entrante con los valores predefinidos. Para cada regla, especifique el nombre de la notificación, el tipo de valor (STRING o STRING_ARRAY) y el valor de coincidencia requerido.

  8. En la sección de aprobación de registros, activa o desactiva: Auto-approval

    1. Cuando Auto-approval está activada, cuando envías un registro para su aprobación, el registro pasa directamente al estado Aprobado y se muestra inmediatamente en los resultados de la búsqueda.

    2. Cuando Auto-approval está desactivada, cuando envías un registro para su aprobación, el registro pasa al estado Pendiente de aprobación y es necesario que un administrador del registro lo revise y apruebe antes de publicarlo.

  9. Selecciona Crear registro.

nota

* Se requiere al menos un campo de configuración de autorización de JWT: audiencias permitidas, clientes permitidos, ámbitos permitidos o notificaciones personalizadas. Si configuras más de uno, AWS Agent Registry los verifica todos. * La URL de descubrimiento no se puede cambiar una vez creado el registro. * El tipo de autorización (IAM o JWT) no se puede cambiar una vez creado el registro. * Un registro solo admite un tipo de autorización entrante a la vez: IAM Sigv4 o JWT Bearer Token. No puedes usar ambos a la vez. La búsqueda mediante IAM solo se admite mediante el IAM-based registro, y la búsqueda mediante Oauth solo se admite mediante un registro basado en Oauth.

Tras crear el registro, la consola accede a la página de detalles del registro. El estado del registro inicialmente es Creando. AWS El registro del agente asigna al registro un ARN, que puede encontrar en la sección Detalles del registro. El estado del registro cambia a Listo una vez completado el aprovisionamiento. Puede agregar registros al registro cuando su estado sea Listo.

AWS CLI

ejemplo
AWS Agent Registry namespace
aws agent-registry-control create-registry \
  --name "MyFirstRegistry" \
  --description "My first Agent Registry" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry \
  --name "MyFirstRegistry" \
  --description "My first Agent Registry" \
  --region us-east-1

El estado del registro comienza como EN PROCESO DE CREACIÓN y pasa a ESTAR LISTO cuando finaliza el aprovisionamiento.

AWS SDK

ejemplo
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.create_registry(
    name='my-agent-registry',
    description='My first Agent Registry'
)
print(response['registryArn'])
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.create_registry(
    name='my-agent-registry',
    description='My first Agent Registry'
)
print(response['registryArn'])

Paso 2: Agregar un registro de registro

Cree un registro para un servidor MCP en su registro.

Consola

Un registro de registro representa un agente, una herramienta, una habilidad o un recurso personalizado.

ejemplo
AWS Agent Registry namespace

  1. Abra la consola AWS de registro de agentes.

  2. En el panel de navegación, elija Registro y, a continuación, elija el nombre del registro al que desea agregar un registro.

  3. En la sección Registros del registro, elija Crear registro.

  4. Elige un tipo de fuente:

    1. Sincronizar desde el punto final: proporcione una URL de punto final y credenciales opcionales para obtener los metadatos de un servidor MCP o un punto final de agente (A2A). Consulte Sincronizar registros de fuentes externas para obtener más información.

    2. Manual: configure manualmente los detalles del registro y la configuración del protocolo. Continúe con los pasos que se indican a continuación.

  5. En la sección Detalles del registro, en Nombre, introduzca un nombre único para el registro. El nombre debe ser único en el registro; la combinación de Name y Record version debe ser única. El nombre debe empezar por un carácter alfanumérico. Los caracteres válidos son a-z, A—Z, 0—9, _ (guión bajo), - (guión), (punto) y . (barra diagonal). / El nombre puede tener hasta 255 caracteres.

  6. (Opcional) En Nombre para mostrar, introduzca una etiqueta legible para el registro. Aparece en la tabla de registros del registro y en los resultados de la búsqueda junto con el nombre técnico del registro.

  7. (Opcional) En Descripción, introduzca una descripción para el registro. La descripción puede tener de 1 a 4.096 caracteres.

  8. En Versión del registro, introduzca un identificador de versión para el registro (por ejemplo, 1.0.0 ov2.1).

  9. En la sección Tipo de registro y descriptor:

    1. En Tipo, seleccione el tipo semántico del registro. El tipo determina qué claves descriptoras principales son válidas.

      • MCP: protocolo diseñado para las comunicaciones entre agentes y herramientas de IA. Gestiona la gestión del contexto y los formatos de mensajes estructurados.

      • Agente: protocolo diseñado para interacciones seguras entre agentes. Permite flujos de trabajo distribuidos e intercambio de información.

      • Habilidades: registre las habilidades de los agentes con la documentación de Markdown y una definición estructurada opcional.

      • Personalizado: implementación de protocolos personalizados para patrones de comunicación especializados. Defina sus propias especificaciones de interfaz y requisitos de integración.

    2. En Descriptor, elija la forma de los datos descriptores del registro. Las opciones disponibles dependen del tipo que haya seleccionado:

      • MCP → Servidor MCP o personalizado

      • Agente → Tarjeta de agente A2A, servidor MCP o personalizada

      • Habilidades → Definición de habilidades de agente o personalizadas

      • Personalizado → Personalizado

  10. Aparecerá un editor específico para cada descriptor en función de su selección de descriptores:

    1. Servidor MCP: seleccione una versión del esquema en el menú desplegable de versiones del esquema (por ejemplo,2025-12-11) e introduzca el server.json de registro del protocolo de contexto del modelo desde el sitio web del protocolo de contexto del modelo en el editor de definiciones de su servidor MCP. La definición debe cumplir con el esquema oficial del servidor MCP para la versión seleccionada. Para ver el esquema oficial como referencia, active Mostrar esquema oficial. (Opcional) Seleccione Agregar definición de herramienta para agregar las herramientas disponibles en este servidor con sus parámetros de entrada, salidas y ejemplos de uso. Seleccione una versión del esquema (por ejemplo2025-11-25) e introduzca la definición de su herramienta en el editor de definiciones de Your Tool.

    2. Tarjeta de agente A2A: la versión del esquema es0.3. Introduzca la definición de su tarjeta de agente en el editor. Para ver el esquema oficial como referencia, activa Mostrar esquema oficial.

    3. Definición de las habilidades de los agentes: para ver la documentación sobre las habilidades, introduce la puntuación que describe esta habilidad. (Opcional) Seleccione Incluir definición de habilidad para agregar una definición estructurada. Seleccione una versión del esquema e introduzca la definición como un objeto JSON.

    4. Personalizado: introduce tu definición personalizada como un objeto JSON.

  11. (Opcional) En la sección Etiquetas, elige Agregar nueva etiqueta para adjuntar una o más etiquetas al registro. Cada etiqueta tiene una clave y un valor opcional.

  12. Elija Crear registro.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra la página de registro de AWS agentes en la Bedrock-AgentCore consola.

  2. En el panel de navegación, elija Registro y, a continuación, elija el nombre del registro al que desea agregar un registro.

  3. En la sección Registros del registro, elija Crear registro.

  4. Elige un tipo de fuente:

    1. Sincronizar desde el punto final: proporcione una URL de punto final y credenciales opcionales para obtener los metadatos de un servidor MCP o un punto final de agente (A2A). Consulte Sincronizar registros de fuentes externas para obtener más información.

    2. Manual: configure manualmente los detalles del registro y la configuración del protocolo. Continúe con los pasos que se indican a continuación.

  5. En la sección Detalles del registro, en Nombre, introduzca un nombre para el registro. El nombre debe empezar por un carácter alfanumérico. Los caracteres válidos son a-z, A—Z, 0—9, _ (guión bajo), - (guión), (punto) y . (barra diagonal). / El nombre puede tener hasta 255 caracteres.

  6. (Opcional) En Descripción, introduzca una descripción para el registro. La descripción puede tener de 1 a 4.096 caracteres.

  7. En Versión del registro, introduzca un identificador de versión para el registro (por ejemplo, 1.0.0 ov2.1).

  8. En la sección Tipo de registro, elige el tipo que coincida con tu recurso:

    1. MCP: protocolo diseñado para las comunicaciones entre agentes y herramientas de IA. Gestiona la gestión del contexto y los formatos de mensajes estructurados. Si elige este tipo, complete los pasos siguientes:

      1. En la sección de definición del servidor MCP, seleccione una versión del esquema en el menú desplegable de versiones del esquema (por ejemplo,2025-12-11) y, a continuación, escriba Model Context Protocol registry server.json desde el sitio web del Model Context Protocol en el editor de definiciones de su servidor MCP. La definición debe cumplir con el esquema oficial del servidor MCP para la versión seleccionada. Para ver el esquema oficial como referencia, active Mostrar esquema oficial.

      2. (Opcional) Selecciona Agregar definición de herramienta para agregar las herramientas específicas disponibles en este servidor con sus parámetros de entrada, salidas y ejemplos de uso para mejorar la visibilidad. Si selecciona esta opción, seleccione una versión del esquema en el menú desplegable Versión del esquema (por ejemplo,2025-11-25) y, a continuación, introduzca la definición de la herramienta en el editor de definiciones de Su herramienta. Para ver el esquema oficial de la herramienta como referencia, activa Mostrar esquema oficial.

    2. Agente: protocolo diseñado para interacciones seguras entre agentes. Permite flujos de trabajo distribuidos e intercambio de información. Si elige este tipo, la versión del esquema es0.3. Introduzca la definición de su tarjeta de agente en el editor. Para ver el esquema oficial como referencia, activa Mostrar esquema oficial.

    3. Habilidades de agente: registre las habilidades de los agentes con la documentación de Markdown y una definición estructurada opcional. Si elige este tipo, complete los pasos siguientes:

      1. Para ver la documentación sobre las habilidades, consulte la documentación de Markdown que describe esta habilidad.

      2. (Opcional) Seleccione Incluir definición de habilidad para agregar una definición estructurada. Si seleccionas esta opción, selecciona una versión del esquema en el menú desplegable Versión del esquema y, a continuación, introduce la definición de la habilidad como un objeto JSON en el editor.

    4. Personalizado: implementación de protocolos personalizados para patrones de comunicación especializados. Defina sus propias especificaciones de interfaz y requisitos de integración. Si eliges este tipo, introduce tu definición personalizada como un objeto JSON en el editor.

  9. Elija Crear registro.

nota

Para agregar un servidor o un agente al registro que no cumpla con los esquemas de protocolo MCP o A2A estándar, utilice el tipo de registro personalizado.

Tras seleccionar Crear registro, AWS Agent Registry comienza a aprovisionar el registro. El estado del registro inicialmente es Creando. Cuando se completa el aprovisionamiento, el estado cambia a Borrador. Para que el registro esté disponible para que otros lo descubran, envíelo para su aprobación. Para obtener más información, consulte el paso 3: Enviar el registro para su aprobación.

AWS CLI

ejemplo
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id <registryId> \
  --name "weather-server" \
  --display-name "WeatherServer" \
  --record-type MCP \
  --descriptors '{"mcpServer": {"data": "{\"name\": \"weather/mcp-server\", \"description\": \"Weather data service\", \"version\": \"1.0.0\"}", "dataSchemaVersion": "2025-12-11"}}' \
  --record-version "1.0" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "WeatherServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"weather/mcp-server\", \"description\": \"Weather data service\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

El registro se crea en estado CREATING y pasa a BORRADOR cuando finaliza el procesamiento. Para obtener más ejemplos de AWS CLI para crear registros de otros tipos, consulte la sección Crear y administrar registros.

AWS SDK

ejemplo
AWS Agent Registry namespace
import boto3
import json

client = boto3.client('agent-registry-control')

server_content = json.dumps({
    "name": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    displayName='My MCP Server',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'data': server_content,
            'dataSchemaVersion': '2025-12-11',
            'additionalData': {
                'tools': {
                    'data': tools_content,
                    'dataSchemaVersion': '2024-11-05'
                }
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3
import json

client = boto3.client('bedrock-agentcore-control')

server_content = json.dumps({
    "name": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'schemaVersion': '2025-12-11',
                'inlineContent': server_content
            },
            'tools': {
                'protocolVersion': '2024-11-05',
                'inlineContent': tools_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Paso 3: Enviar el registro para su aprobación

Consola

Al enviar un registro para su aprobación, se inicia el proceso de revisión que hace que el registro esté disponible para su descubrimiento. Puede enviar un registro desde la tabla de registros o desde la página de detalles del registro.

Para enviar un registro para su aprobación desde la tabla de registros del registro

ejemplo
AWS Agent Registry namespace

  1. Abra la consola AWS de registro del agente.

  2. En el panel de navegación, elija Registry y, a continuación, elija el nombre del registro.

  3. En la sección Registros del registro, seleccione el registro que desea enviar.

  4. Selecciona Actualizar estado y, a continuación, selecciona Enviar para su aprobación.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra la página de registro de AWS agentes en la Bedrock-AgentCore consola.

  2. En el panel de navegación, elija Registro y, a continuación, elija el nombre del registro.

  3. En la sección Registros del registro, seleccione el registro que desea enviar.

  4. Selecciona Actualizar estado y, a continuación, selecciona Enviar para su aprobación.

Para enviar un registro para su aprobación desde la página de detalles del registro

ejemplo
AWS Agent Registry namespace

  1. Abra la consola AWS de registro de agentes.

  2. En el panel de navegación, elija Registry y, a continuación, elija el nombre del registro.

  3. En la sección Registros del registro, elija el nombre del registro que desea enviar.

  4. Selecciona Actualizar estado y, a continuación, selecciona Enviar para su aprobación.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra la página de registro de AWS agentes en la Bedrock-AgentCore consola.

  2. En el panel de navegación, elija Registro y, a continuación, elija el nombre del registro.

  3. En la sección Registros del registro, elija el nombre del registro que desea enviar.

  4. Selecciona Actualizar estado y, a continuación, selecciona Enviar para su aprobación.

Después de enviar un registro para su aprobación, el estado del registro cambia según la configuración de aprobación del registro:

  • Si el registro está Auto-approval activado, el estado del registro cambia directamente a Aprobado y aparece en los resultados de búsqueda poco después.

  • Si el registro Auto-approval se ha desactivado, el estado del registro cambia a Pendiente de aprobación y es necesario que un administrador del registro lo revise y apruebe antes de publicarlo.

AWS CLI

ejemplo
AWS Agent Registry namespace
aws agent-registry-control submit-registry-record-for-approval \
  --registry-id <registryId> \
  --record-id <recordId> \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id <registryId> \
  --record-id <recordId> \
  --region us-east-1

El registro pasa a PENDING_APPROVAL (o directamente a APPROVED si la aprobación automática está habilitada).

AWS SDK

ejemplo
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Record ID: {response['recordId']}")
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
print(f"Updated At: {response['updatedAt']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Record ID: {response['recordId']}")
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
print(f"Updated At: {response['updatedAt']}")

Paso 4: Aprobar el registro

Consola

Para aprobar un registro de la tabla de registros

ejemplo
AWS Agent Registry namespace

  1. Abra la consola AWS de registro del agente.

  2. En el panel de navegación, elija Registry y, a continuación, elija el nombre del registro.

  3. En la sección Registros del registro, seleccione el registro que desea aprobar.

  4. Selecciona Actualizar estado y, a continuación, elige Aprobar.

  5. En el cuadro de diálogo de confirmación, introduce el motivo del cambio de estado.

  6. Elija Confirmar.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra la página de registro de AWS agentes en la Bedrock-AgentCore consola.

  2. En el panel de navegación, elija Registro y, a continuación, elija el nombre del registro.

  3. En la sección Registros del registro, seleccione el registro que desea aprobar.

  4. Selecciona Actualizar estado y, a continuación, elige Aprobar.

  5. En el cuadro de diálogo de confirmación, introduce el motivo del cambio de estado.

  6. Elija Confirmar.

Para aprobar un registro desde la página de detalles del registro

ejemplo
AWS Agent Registry namespace

  1. Abra la consola AWS de registro del agente.

  2. En el panel de navegación, elija Registry y, a continuación, elija el nombre del registro.

  3. En la sección Registros del registro, elija el nombre del registro que desea aprobar.

  4. En la página de detalles del registro, elija Actualizar estado y, a continuación, elija Aprobar.

  5. En el cuadro de diálogo de confirmación, introduzca el motivo del cambio de estado.

  6. Elija Confirmar.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra la página de registro de AWS agentes en la Bedrock-AgentCore consola.

  2. En el panel de navegación, elija Registro y, a continuación, elija el nombre del registro.

  3. En la sección Registros del registro, elija el nombre del registro que desea aprobar.

  4. En la página de detalles del registro, elija Actualizar estado y, a continuación, elija Aprobar.

  5. En el cuadro de diálogo de confirmación, introduzca el motivo del cambio de estado.

  6. Elija Confirmar.

AWS CLI

ejemplo
AWS Agent Registry namespace
aws agent-registry-control update-registry-record-status \
  --registry-id <registryId> \
  --record-id <recordId> \
  --status APPROVED \
  --status-reason "Reviewed and approved" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record-status \
  --registry-id <registryId> \
  --record-id <recordId> \
  --status APPROVED \
  --status-reason "Reviewed and approved" \
  --region us-east-1

AWS SDK

ejemplo
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.update_registry_record_status(
    registryId='<registryId>',
    recordId='<recordId>',
    status='APPROVED',
    statusReason='Meets all requirements'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # APPROVED
print(f"Reason: {response['statusReason']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.update_registry_record_status(
    registryId='<registryId>',
    recordId='<recordId>',
    status='APPROVED',
    statusReason='Meets all requirements'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # APPROVED
print(f"Reason: {response['statusReason']}")

Paso 5: Descubra los registros aprobados

El directorio de registros es la página de la consola para explorar y buscar los registros aprobados en un registro. Al seleccionar un registro en la página del directorio de registros, la consola muestra automáticamente los registros aprobados. Desde allí, puede hojear la lista o usar el cuadro de búsqueda para ejecutar una consulta en lenguaje natural. Utilízalo mediante programación ListDiscoverableRegistryRecords para navegar, SearchDiscoverableRegistryRecords buscar y BatchGetDiscoverableRegistryRecord obtener todos los detalles de muchos registros en una sola llamada.

Consola

nota

Console-based la detección solo está disponible para los registros que utilizan Use IAM como tipo de autorización. Si tu registro usa JSON Web Tokens (JWT), llama directamente a las API del plano de datos detectables mediante un cliente HTTP, como curl o Postman, con un token de portador de JWT válido en el encabezado de la solicitud. La AWS CLI y los AWS SDK utilizan la firma SigV4 de IAM y no se pueden usar con los registros. JWT-authorized Para obtener más información, consulte Buscar registros de registro.

ejemplo
AWS Agent Registry namespace

Para examinar o buscar registros aprobados

  1. Abra la consola AWS de registro del agente.

  2. En el panel de navegación, seleccione el directorio de registros.

  3. En Registro, seleccione el registro cuyos registros aprobados desea explorar. La página muestra automáticamente todos los registros aprobados de ese registro.

  4. (Opcional) Cambia entre la vista de tarjeta y la de tabla en la parte superior derecha de la página.

  5. (Opcional) En Buscar registros aprobados, introduce una consulta en lenguaje natural o un nombre para acotar los resultados y, a continuación, selecciona Buscar.

  6. Elige una tarjeta o fila para abrir todos los detalles del registro.

El directorio de registros solo muestra los registros en estado Aprobado. Los registros en estado Borrador, Pendiente de aprobación, Rechazado o Obsoleto no aparecen.

Amazon Bedrock AgentCore namespace (to be deprecated)

Para buscar registros de registro

  1. Abra la página de registro del AWS agente en la Bedrock-AgentCore consola.

  2. En el panel de navegación, elija Registro y, a continuación, elija el nombre del registro.

  3. Seleccione la pestaña Buscar registros.

  4. En el campo Buscar registros aprobados, introduce tu consulta de búsqueda.

  5. (Opcional) Para filtrar los resultados por una propiedad específica, seleccione el campo de búsqueda para expandir el menú Propiedades y, a continuación, seleccione un filtro: nombre , tipo de descriptor o versión.

  6. Elija Buscar.

La búsqueda solo devuelve los registros con el estado Aprobado. Los registros de otros estados, como en borrador, pendiente de aprobación, rechazado o obsoleto, no aparecen en los resultados de la búsqueda.

AWS CLI

Examine los registros aprobados: muestre una lista de los registros aprobados en un registro:

aws agent-registry list-discoverable-registry-records \
  --registry-id "<registry-id>" \
  --region us-east-1

Busque registros aprobados: ejecute una búsqueda híbrida semántica y por palabra clave:

ejemplo
AWS Agent Registry namespace
aws agent-registry search-discoverable-registry-records \
  --search-query "weather" \
  --registry-ids "<registry-id>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore search-registry-records \
  --search-query "weather" \
  --registry-ids "<registry-id>" \
  --region us-east-1

Recupera todos los detalles de muchos registros a la vez:

aws agent-registry batch-get-discoverable-registry-record \
  --entries '[{"registryId": "<registry-id>", "recordIds": ["<recordId-1>", "<recordId-2>"]}]' \
  --region us-east-1
nota

ListDiscoverableRegistryRecordsy solo BatchGetDiscoverableRegistryRecord están disponibles en el espacio de agent-registry nombres. No están disponibles en el espacio de bedrock-agentcore nombres.

AWS SDK

Examine los registros aprobados:

import boto3

client = boto3.client('agent-registry')

list_response = client.list_discoverable_registry_records(
    registryId='<registry-id>',
    maxResults=20
)
for record in list_response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")

Buscar registros aprobados:

ejemplo
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry')

response = client.search_discoverable_registry_records(
    registryIds=['arn:aws:agent-registry:us-east-1:<account>:registry/<registryId>'],
    searchQuery='weather forecast tool',
    maxResults=10
)
for record in response['registryRecords']:
    print(f"Record: {record['displayName']} ({record['recordId']})")
    print(f"  Name: {record['name']}")
    print(f"  Type: {record['recordType']}")
    print(f"  Status: {record['status']}")
    print(f"  Version: {record['recordVersion']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore')

response = client.search_registry_records(
    registryIds=['arn:aws:bedrock-agentcore:us-east-1:<account>:registry/<registryId>'],
    searchQuery='weather forecast tool',
    maxResults=10
)
for record in response['registryRecords']:
    print(f"Record: {record['name']} ({record['recordId']})")
    print(f"  Type: {record['descriptorType']}")
    print(f"  Status: {record['status']}")
    print(f"  Version: {record['version']}")

Recupere todos los detalles de muchos registros a la vez:

batch_response = client.batch_get_discoverable_registry_record(
    entries=[{'registryId': '<registry-id>', 'recordIds': ['<recordId-1>', '<recordId-2>']}]
)
for record in batch_response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")
for err in batch_response['errors']:
    print(f"Error for {err['recordId']}: {err['errorCode']}")

Lo que has construido

  • Un registro con autorización de IAM y aprobación manual

  • Un registro de registro que describe un servidor MCP

  • Un registro aprobado que se puede explorar y buscar en el directorio de registros

Siguientes pasos

  • Cree experiencias de descubrimiento similares a las de un catálogo basándose en y ListDiscoverableRegistryRecords BatchGetDiscoverableRegistryRecord

  • Configure EventBridge las notificaciones de Amazon para automatizar su flujo de trabajo de aprobación

  • Agregue más registros para sus agentes, servidores, habilidades y recursos personalizados