Connect a DSW instance to an Agent through MCP - Platform For AI - Centro de documentación de Alibaba Cloud

Una vez que habilite el servicio MCP en una instancia de DSW, podrá conectarla a un cliente Agent. El Agent puede ejecutar comandos, leer y escribir archivos, así como correr código directamente en la instancia. Esto le permite delegar tareas de desarrollo en la nube a la inteligencia artificial.

Requisitos previos

Se configuró una VPC y un security group para la instancia de DSW o para la cuota de recursos a la que pertenece.

Casos de uso

Al conectar una instancia de DSW a un Agent, este obtiene una máquina de desarrollo en la nube lista para usarse. Puede leer y escribir código, ejecutar comandos y correr experimentos directamente en la instancia, lo que le libera de operaciones repetitivas del entorno. Los escenarios típicos incluyen:

Desarrollo y depuración remota de código: el Agent crea y modifica código en la instancia, lo ejecuta, localiza errores, los corrige y vuelve a correrlo para completar un ciclo de desarrollo completo.
Preparación del entorno y gestión de dependencias: solicite al Agent que instale las dependencias faltantes de Python o del sistema, compruebe las versiones de CUDA y del framework, y verifique el entorno de ejecución. Así evitará escribir comandos uno por uno.
Entrenamiento y hosting de experimentos: el Agent inicia scripts de entrenamiento y espera de forma asíncrona, supervisa registros y salidas, y resume automáticamente los resultados cuando finaliza el proceso.
Procesamiento de datos y organización de documentación: busque y limpie por lotes los archivos de datos en la instancia, o convierta páginas web, PDF y documentos de Office a Markdown para su análisis posterior.

Conectar una instancia de DSW a un Agent mediante MCP

Paso 1: Crear una instancia de DSW y habilitar el servicio MCP

Habilite el servicio MCP en tres pasos: active el interruptor del servicio, genere las credenciales de acceso y abra el puerto en el security group. Después de esto, el Agent podrá acceder a la instancia mediante el protocolo MCP.

Active el interruptor del servicio MCP. A continuación se muestra cómo crear una instancia con recursos públicos. Configure los parámetros clave tal como se describe en esta sección; los demás parámetros se configuran según sus necesidades.

Para una instancia existente, vaya a la lista de instancias, haga clic en Change Configuration en la columna Actions y vuelva a configurar la instancia de DSW.
- Resource Type: seleccione recursos públicos.
- VPC Settings: seleccione una VPC en la misma región. Se requiere una VPC para habilitar el servicio MCP.
- Security Group: seleccione el security group creado.
- VSwitch: seleccione el vSwitch creado.
- Enable MCP Service: active el interruptor. Cuando está encendido, aparece un servicio llamado MCP que escucha en el puerto 9806 de la instancia de forma predeterminada.
Si desea acceder a la instancia de DSW desde internet (por ejemplo, mediante un cliente Agent local), configure los siguientes parámetros:
- Service Access and Port Configuration:
  - Access over Internet: seleccione la casilla de verificación.
  - Internet Access Port: por ejemplo, 1078.
- Public Network Access: seleccione DNAT + EIP
  - NAT Gateway: seleccione la puerta de enlace NAT creada en la misma región.
  - EIP: seleccione la EIP asociada a la puerta de enlace NAT.
    
    Importante
    Importante: para permitir que la instancia de DSW acceda a internet, configure una entrada SNAT en la puerta de enlace NAT. Para obtener más información, consulte Improve public access speed through a dedicated gateway.
Una vez completada la configuración, haga clic en OK para crear la instancia.
Genere las credenciales de acceso. Una vez creada la instancia de DSW, haga clic en su nombre para ir a la página de detalles. En la sección Access Configuration, haga clic en Generate Access Credentials. Estas credenciales sirven para autenticar al Agent cuando llama al servicio MCP. Páselas como un Bearer Token en el encabezado de la solicitud.

Ahora cuenta con el endpoint de acceso y las credenciales de acceso de MCP.

Nota
Las credenciales tienen una vigencia predeterminada de 7 días. Cuando caduquen, vuelva a generarlas en la misma ubicación. Después de regenerarlas, actualice las credenciales en la configuración del Agent.

Paso 2: Abrir el puerto y la IP en el security group

En la página de detalles de DSW, dentro de la sección Network Information, haga clic en el nombre del security group para ir a su página de detalles. En la pestaña Inbound, haga clic en Add Rule. Configure los siguientes parámetros; para los demás, utilice los valores predeterminados.

Source: introduzca la dirección IP donde se despliega el Agent (por ejemplo, la IP pública de la computadora local que ejecuta el Agent).
Destination (this instance): introduzca el puerto 9806.

Paso 3: Conectar el Agent a la instancia de DSW

El servicio MCP de DSW utiliza el protocolo estándar Streamable HTTP y es compatible con los clientes Agent más populares. Abra el cliente Agent (como Open Code o Qoder CLI) y envíele el siguiente prompt. Reemplace <MCP access endpoint> y <access credentials> con los valores reales. El Agent completará automáticamente la conexión MCP.

Si usa un cliente Agent local para conectarse a una instancia de DSW, utilice el endpoint de acceso público.

Add an MCP server named dsw-mcp with the Streamable HTTP protocol, endpoint http://<MCP access endpoint>, and request header Authorization: Bearer <access credentials>. Complete the setup automatically using your MCP configuration method.

Una vez establecida la conexión, introduzca el siguiente comando en el cliente Agent para comprobar la conectividad.

Create a hello_world Python file in the /mnt/workspace directory on the DSW instance.

Cuando termine de ejecutarse el comando, abra la instancia de DSW. El archivo hello_world.py aparecerá en el espacio de trabajo.

Herramientas compatibles

El servicio MCP de DSW expone un conjunto de herramientas mediante el protocolo estándar Streamable HTTP. El Agent carga automáticamente la lista de herramientas después de conectarse. Estas se agrupan en cinco categorías: Shell, File, System, Format conversion y Code, con un total de 16.

Herramientas de shell

Ejecutan comandos dentro de la instancia. Los comandos consecutivos comparten el directorio de trabajo, lo cual resulta útil para correr scripts, instalar dependencias e iniciar trabajos de entrenamiento.

Herramienta	Función	Parámetros clave
`shell_exec`	Ejecutar un comando de shell	cmd (obligatorio), cwd, new_session, timeout
`shell_view`	Consultar la salida acumulada y el estado de una sesión	session_id, limit
`shell_wait`	Esperar a que finalice un comando asíncrono	session_id, seconds
`shell_write`	Enviar entrada a un proceso en ejecución	session_id, input, press_enter
`shell_kill`	Finalizar y limpiar una sesión	session_id

Herramientas de archivos

Leen, escriben, buscan y editan archivos dentro de la instancia.

Herramienta	Función	Parámetros clave
`file_read`	Leer el contenido de un archivo (por rango de líneas)	path (obligatorio), start_line, end_line, sudo
`file_write`	Escribir o anexar contenido a un archivo; admite binarios en base64	path, content, encoding, append
`file_str_replace`	Reemplazar cadenas de forma global dentro de un archivo	path, old_str, new_str
`file_search`	Buscar contenido en archivos mediante expresiones regulares	path, regex
`file_find`	Encontrar archivos con un patrón glob	path, pattern
`file_list`	Listar directorios (de forma recursiva y filtrando por tipo)	path, recursive, file_types
`file_edit`	Editor con capacidad de deshacer cambios	command (view/create/str_replace/insert/undo_edit), path, etcétera

Herramientas del sistema

Consultan el entorno de la instancia y las dependencias instaladas.

Herramienta	Función	Parámetros clave
`system_info`	Consultar el entorno de la instancia (SO, Python, Node, herramientas disponibles)	Ninguna
`system_packages`	Listar los paquetes de Python o Node.js instalados	language

Herramientas de conversión de formato

Herramienta	Función	Parámetros clave
`util_to_markdown`	Convertir páginas web, PDF, archivos de Office, imágenes, etcétera, a Markdown	uri

Herramientas de código

Herramienta	Función	Parámetros clave
`code_run`	Ejecutar código (actualmente compatible con Python)	code, language, timeout

Una vez habilitado el servicio MCP, las herramientas están disponibles de inmediato. No se requiere ninguna configuración adicional.