Os conectores atualmente integrados ao WorkBuddy ainda não conseguem cobrir funcionalidades como GPT Image 2, criação musical com Suno e pesquisa do Google. Se for necessário utilizar esses serviços, é possível integrar o serviço MCP fornecido pela Ace Data Cloud.

Todo o processo de integração é dividido principalmente em duas etapas:

  1. Obter a API Key da plataforma no console da Ace Data Cloud.
  2. Configurar o serviço MCP no WorkBuddy.

Este artigo apresentará como integrar o serviço MCP da Ace Data Cloud ao WorkBuddy e, usando como exemplo a chamada do modelo Suno para gerar uma música, demonstrará o método específico de uso do serviço.

Aviso de segurança: Guarde adequadamente a API Key da plataforma e não a publique em artigos, capturas de tela, repositórios públicos ou registros de conversa. Se a API Key da plataforma já tiver sido vazada, revogue-a imediatamente no console e crie uma nova.

1. Obter a API Key da plataforma Ace Data Cloud

Abra o console da Ace Data Cloud:

Link direto para o console da Ace Data Cloud

Entrada para obter a API Key na página de gerenciamento de aplicações da Ace Data Cloud

Após entrar no console, copie a API Key da plataforma que precisa ser utilizada.

Se você ainda não tiver uma API Key da plataforma, clique no botão Criar no canto superior direito da página e siga as instruções para criar uma nova API Key da plataforma.

2. Configurar o serviço MCP no WorkBuddy

O WorkBuddy oferece três formas de configurar o serviço MCP. Basta escolher uma delas:

  1. Configurar pelo gerenciador MCP;
  2. Editar diretamente o arquivo de configuração;
  3. Deixar o WorkBuddy concluir a configuração automaticamente.

Método um: configurar pelo gerenciador MCP

Abra o WorkBuddy e acesse, em sequência, a página Especialistas > Habilidades > Conectores.

Aqui são fornecidos vários conectores disponíveis. Clique em Conector personalizado no canto superior direito da página para entrar na página de configuração do conector.

Página de conectores do WorkBuddy

Neste momento, será exibida uma janela de configuração do conector. A seguir, será usado como exemplo o serviço Suno da Ace Data Cloud para demonstrar o método específico de configuração.

Janela de configuração de conector personalizado

Clique no botão Adicionar MCP na parte superior da página.

Adicionar serviço MCP

Adicione o seguinte código de configuração e substitua sua API Key no código pela API Key copiada anteriormente:

"acedatacloud-suno": {
  "type": "http",
  "url": "https://suno.mcp.acedata.cloud/mcp",
  "headers": {
    "Authorization": "Bearer sua API Key"
  },
  "description": "Geração de música com Suno AI (gerar/continuar/regravar/letras)"
}

Após concluir a configuração, clique no botão Salvar. Em seguida, volte à página de conectores, encontre e expanda o serviço Suno que acabou de ser adicionado.

No primeiro uso, o WorkBuddy poderá solicitar que você confirme se confia nesse serviço. Após clicar no botão Confiar, será possível visualizar os serviços relacionados fornecidos pelo Suno.

Lista de serviços MCP do Suno

Neste ponto, você já pode chamar o serviço Suno fornecido pela Ace Data Cloud no WorkBuddy.

Método dois: editar diretamente o arquivo de configuração

Este método é semelhante ao anterior, mas exige a modificação direta do arquivo de configuração do WorkBuddy.

O caminho padrão do arquivo de configuração é o seguinte:

C:\Users\seu nome de usuário\.workbuddy\mcp.json

Adicione a seguinte configuração à configuração MCP existente:

"acedatacloud-suno": {
  "type": "http",
  "url": "https://suno.mcp.acedata.cloud/mcp",
  "headers": {
    "Authorization": "Bearer sua API Key"
  },
  "description": "Geração de música com Suno AI (gerar/continuar/regravar/letras)"
}

Substitua sua API Key no código pela API Key copiada do console da Ace Data Cloud e salve o arquivo.

Observação:

  • O código acima é um trecho JSON que precisa ser adicionado à configuração existente e não é necessariamente um arquivo mcp.json completo.
  • Se já houver outros serviços na configuração original, será necessário adicionar vírgulas corretamente de acordo com o formato JSON.
  • Não use diretamente esse trecho para substituir todo o arquivo de configuração.
  • Recomenda-se fazer backup do arquivo mcp.json original antes da modificação.
  • Erros no formato JSON podem impedir que o WorkBuddy seja iniciado normalmente; portanto, esse método é mais adequado para usuários com algum conhecimento de informática.

Método três: deixar o WorkBuddy configurar automaticamente

Você também pode solicitar diretamente ao WorkBuddy que modifique a configuração MCP.

Digite o seguinte conteúdo na janela de chat do WorkBuddy:

Por favor, ajude-me a configurar o serviço MCP. A configuração é a seguinte:

"acedatacloud-suno": {
  "type": "http",
  "url": "https://suno.mcp.acedata.cloud/mcp",
  "headers": {
    "Authorization": "Bearer sua API Key"
  },
  "description": "Geração de música com Suno AI (gerar/continuar/regravar/letras)"
}

Antes de enviar, substitua sua API Key pela API Key copiada do console da Ace Data Cloud.

Em seguida, o WorkBuddy concluirá automaticamente a configuração de acordo com o conteúdo acima. Após a conclusão da configuração, você poderá abrir a lista de serviços MCP e expandir o serviço Suno para visualizar as funcionalidades atualmente disponíveis para chamada.

Dica: Você pode perguntar diretamente ao WorkBuddy sobre a finalidade, os parâmetros e o método de chamada de cada serviço do Suno. Ao utilizar o método de configuração automática, verifique o conteúdo que o WorkBuddy está prestes a modificar antes da execução, evitando substituir incorretamente configurações existentes.

3. Chamar o modelo Suno para criar músicas

Após concluir a configuração do serviço Suno MCP, você poderá criar músicas no WorkBuddy.

A seguir, é apresentado um método básico de uso. O efeito específico da geração depende das configurações do prompt, do estilo musical, das tags e de outros parâmetros.

3.1 Inserir requisitos de criação da música

Você pode digitar na janela de chat:

Por favor, use o Suno para criar uma música para mim.

Para melhorar a correspondência entre o resultado gerado e o esperado, recomenda-se complementar as seguintes informações no prompt:

  • Tema da música;
  • Estilo musical;
  • Idioma do canto;
  • Gênero do cantor ou características da voz;
  • Atmosfera emocional;
  • Velocidade e ritmo;
  • Se é necessário gerar letras automaticamente.

Por exemplo:

Por favor, use o Suno para criar uma música pop chinesa para mim.

Tema da música: a cidade após a chuva e recomeçar
Estilo musical: pop, rock leve
Atmosfera emocional: acolhedora, cheia de esperança
Voz de canto: voz masculina jovem
Ritmo da música: médio
Outros requisitos: gerar letras completas e fornecer um título de música adequado

Inserir requisitos de criação da música

3.2 Especificar o serviço Suno do Ace Data Cloud

Se for necessário especificar claramente o serviço, você pode inserir:

Por favor, use o modelo Suno do Ace Data Cloud para criar.

O WorkBuddy lerá os serviços MCP já configurados e chamará o serviço Suno correspondente para executar a tarefa.

Chamar o serviço Suno do Ace Data Cloud

A geração de músicas geralmente requer alguns minutos de espera, e o tempo real pode ser afetado por fatores como o modelo, a duração da música e a fila de tarefas.

3.3 Consultar o status da geração de músicas

Se não for possível obter a música normalmente, ou se a tarefa não retornar resultados por muito tempo, você pode pedir ao WorkBuddy para chamar o serviço de consulta de tarefas.

Por exemplo:

Por favor, ajude-me a consultar a tarefa de geração de música Suno enviada agora há pouco.

Consultar tarefa de geração de música

Após a conclusão da tarefa, a música será salva localmente; clique no arquivo de áudio correspondente para ouvi-la.

Abaixo estão as músicas geradas nesta demonstração:

4. Visualizar tarefas históricas

Retorne ao console do Ace Data Cloud e acesse a página Painel de controle > Tarefas históricas para visualizar a tarefa de geração de música enviada agora há pouco.

Visualizar tarefas históricas

Na página de tarefas históricas, é possível visualizar o status da tarefa e os resultados de geração relacionados.

Resumo

Por meio dos serviços MCP fornecidos pelo Ace Data Cloud, é possível ampliar convenientemente o WorkBuddy com capacidades externas como o Suno.

Todo o processo de integração inclui principalmente as duas etapas a seguir:

  1. Criar e copiar a API Key no console do Ace Data Cloud;
  2. Adicionar a configuração MCP no WorkBuddy e concluir a autorização do serviço.

Este artigo usa a geração de música com Suno como exemplo e demonstra o processo de configuração, chamada e consulta de tarefas do serviço MCP. Outros serviços MCP também podem ser integrados de maneira semelhante.

O serviço Suno do Ace Data Cloud adota um modelo de cobrança por uso, sem necessidade de assinatura de plano mensal. Os padrões de cobrança reais devem seguir as explicações mais recentes no console do Ace Data Cloud e na documentação técnica relacionada.

Durante o processo de configuração, mantenha a API Key devidamente protegida e faça backup do arquivo original antes de modificar manualmente o arquivo mcp.json.