Connect a DSW instance to an Agent through MCP - Platform For AI: Central de Documentação do Alibaba Cloud

Ao ativar o service MCP em uma instância DSW, você conecta essa instância a um cliente Agent. O Agent passa a executar comandos, ler e gravar arquivos e executar código diretamente na instância, permitindo delegar tarefas de desenvolvimento em cloud para a IA.

Pré-requisitos

Configure uma VPC e um grupo de segurança para a instância DSW ou para a cota de recursos à qual ela pertence.

Casos de uso

Conectar uma instância DSW a um Agent fornece uma máquina de desenvolvimento em cloud pronta para uso. O Agent lê e grava código, executa comandos e roda experimentos diretamente na instância, eliminando operações repetitivas de ambiente. Os cenários típicos incluem:

Desenvolvimento e depuração remota de código: O Agent cria e modifica código na instância, executa o programa, localiza erros, aplica correções e reexecuta para concluir um ciclo completo de desenvolvimento.
Preparação de ambiente e gerenciamento de dependências: Solicite ao Agent que instale dependências ausentes do Python ou do sistema, verifique versões do CUDA e de frameworks e valide o ambiente de execução, evitando a digitação manual de comandos.
Treinamento e hospedagem de experimentos: O Agent inicia scripts de treinamento, aguarda de forma assíncrona, monitora logs e saídas, e resume os resultados automaticamente ao final do processo.
Processamento de dados e organização de documentação: Busque e limpe arquivos de dados em lote na instância ou converta páginas da web, PDFs e documentos do Office para Markdown para análise posterior.

Conectar uma instância DSW a um Agent via MCP

Etapa 1: Criar uma instância DSW e ativar o service MCP

Ative o service MCP em três etapas: ligue a chave do service, gere credenciais de acesso e abra a porta no grupo de segurança. Após isso, o Agent acessa a instância pelo protocolo MCP.

Ative a chave do service MCP. O exemplo abaixo mostra como criar uma instância usando recursos públicos. Configure os parâmetros principais conforme descrito nesta seção. Configure os demais parâmetros conforme necessário.

Para uma instância existente, acesse a lista de instâncias, clique em Change Configuration na coluna Actions e reconfigure a instância DSW.
- Resource Type: Selecione recursos públicos.
- VPC Settings: Selecione uma VPC na mesma região. Uma VPC é obrigatória para ativar o service MCP.
- Security Group: Selecione o grupo de segurança criado.
- VSwitch: Selecione o vSwitch criado.
- Enable MCP Service: Ative a chave. Quando ativada, um service chamado MCP aparece e escuta na porta 9806 da instância por padrão.
Para acessar a instância DSW pela internet (por exemplo, por meio de um cliente Agent local), configure os seguintes parâmetros:
- Service Access and Port Configuration:
  - Access over Internet: Marque a caixa de seleção.
  - Internet Access Port: Por exemplo, 1078.
- Public Network Access: Selecione DNAT + EIP
  - NAT Gateway: Selecione o NAT gateway criado na mesma região.
  - EIP: Selecione o EIP associado ao NAT gateway.
    
    Importante
    Importante: Para permitir que a instância DSW acesse a internet, configure uma entrada SNAT para o NAT gateway. Para mais informações, consulte Improve public access speed through a dedicated gateway.
Após concluir a configuração, clique em OK para criar a instância.
Gere as credenciais de acesso. Depois que a instância DSW for criada, clique no nome da instância para ir à página de detalhes. Na seção Access Configuration, clique em Generate Access Credentials. Essas credenciais autenticam o Agent quando ele chama o service MCP. Passe as credenciais como Bearer Token no cabeçalho da requisição.

Agora você tem o endpoint de acesso e as credenciais de acesso do MCP.

Nota
As credenciais são válidas por 7 dias por padrão. Ao expirarem, regenere-as no mesmo local. Após a regeneração, atualize as credenciais na configuração do Agent.

Etapa 2: Abrir a porta e o IP no grupo de segurança

Na página de detalhes da DSW, na seção Network Information, clique no nome do grupo de segurança para ir à página de detalhes do grupo de segurança. Na aba Inbound, clique em Add Rule. Configure os parâmetros a seguir. Use os valores padrão para os demais parâmetros.

Source: Insira o endereço IP do local de implantação do Agent (por exemplo, o IP público do computador local que executa o Agent).
Destination (this instance): Insira a porta 9806.

Etapa 3: Conectar o Agent à instância DSW

O service MCP da DSW utiliza o protocolo padrão Streamable HTTP e é compatível com os principais clientes Agent. Abra o cliente Agent (como Open Code ou Qoder CLI) e envie o seguinte prompt ao Agent, substituindo <MCP access endpoint> e <access credentials> pelos valores reais. O Agent completará automaticamente a conexão MCP.

Se você usar um cliente Agent local para conectar-se a uma instância DSW, utilize o endpoint de acesso 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.

Depois que a conexão for estabelecida, insira o seguinte comando no cliente Agent para testar a conectividade.

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

Após a execução do comando, abra a instância DSW. O arquivo hello_world.py aparecerá no workspace.

Ferramentas suportadas

O service MCP da DSW expõe um conjunto de ferramentas por meio do protocolo padrão Streamable HTTP. O Agent carrega a lista de ferramentas automaticamente após a conexão. As ferramentas estão divididas em cinco categorias: Shell, Arquivo, Sistema, Conversão de formato e Código, totalizando 16 ferramentas.

Ferramentas de Shell

Execute comandos dentro da instância. Comandos consecutivos compartilham o diretório de trabalho, o que é útil para rodar scripts, instalar dependências e iniciar jobs de treinamento.

Ferramenta	Função	Parâmetros principais
`shell_exec`	Executar um comando shell	cmd (obrigatório), cwd, new_session, timeout
`shell_view`	Visualizar saída acumulada e status de uma sessão	session_id, limit
`shell_wait`	Aguardar a conclusão de um comando assíncrono	session_id, seconds
`shell_write`	Enviar entrada para um processo em execução	session_id, input, press_enter
`shell_kill`	Encerrar e limpar uma sessão	session_id

Ferramentas de arquivo

Leia, grave, pesquise e edite arquivos dentro da instância.

Ferramenta	Função	Parâmetros principais
`file_read`	Ler conteúdo do arquivo (por intervalo de linhas)	path (obrigatório), start_line, end_line, sudo
`file_write`	Gravar ou anexar a um arquivo; suporta binário base64	path, content, encoding, append
`file_str_replace`	Substituir strings globalmente dentro de um arquivo	path, old_str, new_str
`file_search`	Pesquisar conteúdo do arquivo por expressão regular	path, regex
`file_find`	Localizar arquivos por padrão glob	path, pattern
`file_list`	Listar diretórios (recursivo, filtrar por tipo)	path, recursive, file_types
`file_edit`	Editor com capacidade de desfazer	command (view/create/str_replace/insert/undo_edit), path, entre outros

Ferramentas de sistema

Consulte o ambiente da instância e as dependências instaladas.

Ferramenta	Função	Parâmetros principais
`system_info`	Consultar o ambiente da instância (SO, Python, Node, ferramentas disponíveis)	Nenhum
`system_packages`	Listar pacotes Python ou Node.js instalados	language

Ferramentas de conversão de formato

Ferramenta	Função	Parâmetros principais
`util_to_markdown`	Converter páginas da web, PDFs, arquivos do Office, imagens, etc., para Markdown	uri

Ferramentas de código

Ferramenta	Função	Parâmetros principais
`code_run`	Executar código (atualmente suporta Python)	code, language, timeout

Após a ativação do service MCP, as ferramentas ficam disponíveis imediatamente. Nenhuma configuração adicional é necessária.