Todos os produtos
Search

Este produto

    AgentBay:Access through MCP

    Central de documentação

    AgentBay:Access through MCP

    Última atualização: Jun 29, 2026

    O AgentBay utiliza o Model Context Protocol (MCP) para oferecer uma interface unificada entre modelos de IA e ambientes de execução em nuvem. Por meio do MCP, você gerencia sessões, opera arquivos, executa comandos, gerencia aplicativos e controla janelas.

    Pré-requisitos

    Obter uma chave de API

    1. Faça logon no console do AgentBay.

    2. No painel de navegação à esquerda, escolha Service Management.

    3. Na página Service Management, clique em Create API Key.

    4. Na caixa de diálogo Create API Key, insira um nome e clique em OK.

      Importante

      Para proteger a segurança dos dados, não compartilhe sua chave de API.

    Selecionar uma imagem

    Defina IMAGEID na sua URL do MCP de acordo com suas necessidades. As URLs abaixo são exemplos — utilize o código real obtido no console. Para mais informações sobre como obter sua URL do MCP, consulte Obter um endereço MCP.

    Selecionar a imagem mais recente

    Uma imagem latest sempre resolve para a versão mais nova de cada tipo de ambiente.

    • Computador em nuvem (Windows): windows_latest

    • Computador em nuvem (Linux): linux_latest

    • Navegador em nuvem: browser_latest

    • Sandbox de código: code_latest

    • Telefone em nuvem: mobile_latest

    Usar uma versão específica da imagem

    Defina IMAGEID como uma versão específica de imagem de sistema operacional ou uma imagem personalizada.

    Imagem de sistema

    1. Faça logon no console do AgentBay.

    2. No painel de navegação à esquerda, escolha Image Management.

    3. Na página Images (Beta), clique na aba System Image e copie o ID da imagem.

    Imagem personalizada

    1. Faça logon no console do AgentBay.

    2. No painel de navegação à esquerda, escolha Image Management.

    3. Na página Images (Beta), clique na aba Custom Image e copie o ID da imagem.

    Configurar o servidor MCP

    Adicione a URL do MCP a qualquer ferramenta compatível com MCP, como Cline ou Cursor. Os passos abaixo utilizam o Cursor v0.50.5.

    1. Abra Cursor Settings e escolha MCP no painel esquerdo.

    2. No painel MCP Servers, clique em Add new global MCP server.

    3. Cole o bloco de código da URL do MCP obtido em Obter um endereço MCP no seu arquivo mcp.json e salve. Três métodos de conexão estão disponíveis: SSE, Stdio e Streamable.

      SSE

      {
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay-intl.wuying.aliyuncs.com/v2/sse?APIKEY=YOUR_API_KEY&IMAGEID=browser_latest"
    }
  }
}

      Streamable

      {
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay-intl.wuying.aliyuncs.com/v2/mcp?APIKEY=YOUR_API_KEY&IMAGEID=browser_latest"
    }
  }
}

    Experimentar o AgentBay

    Navegar em um site com um navegador em nuvem

    Após configurar o MCP do AgentBay na sua ferramenta, use o agente para executar tarefas.

    Nota

    No exemplo a seguir, IMAGEID está definido como browser_latest.

    1. Execute esta instrução para abrir o site da Alibaba Cloud em uma sessão de navegador em nuvem.

      Visit the Alibaba Cloud website

    2. Execute esta instrução para obter a URL da sandbox e visualizar o status da tarefa.

      Return the URL of the Wuying MCP service sandbox environment

      • Esta URL expira e tem usos limitados. Abra-a imediatamente.

      • Utilize os parâmetros de URL &input=true&keyboard=true para alternar a interação por teclado e mouse. Também é possível ajustar essas configurações em tempo real com o Web SDK.

    Próximos passos

    • Usar uma imagem personalizada: Caso a imagem padrão apresente problemas de rede ou de aplicativo, utilize uma imagem personalizada. Para detalhes, consulte Criar uma imagem.

    • Ferramentas MCP: Para saber quais ferramentas MCP estão disponíveis, consulte Visão geral das ferramentas MCP.