I connettori attualmente integrati in WorkBuddy non sono ancora in grado di coprire funzioni come GPT Image 2, la creazione musicale con Suno e la ricerca Google. Se è necessario utilizzare questi servizi, è possibile integrare i servizi MCP forniti da Ace Data Cloud.

L'intero processo di integrazione si divide principalmente in due passaggi:

  1. Ottenere la piattaforma API Key nella console di Ace Data Cloud.
  2. Configurare il servizio MCP in WorkBuddy.

Questo articolo illustrerà come integrare il servizio MCP di Ace Data Cloud in WorkBuddy e, prendendo come esempio la generazione di una canzone tramite il modello Suno, mostrerà il metodo di utilizzo specifico del servizio.

Avviso di sicurezza: conservare adeguatamente la piattaforma API Key e non pubblicarla in articoli, screenshot, repository pubblici o cronologie delle chat. Se la piattaforma API Key è stata divulgata, revocarla immediatamente nella console e crearne una nuova.

1. Ottenere la piattaforma API Key di Ace Data Cloud

Aprire la console di Ace Data Cloud:

Link diretto alla console di Ace Data Cloud

Punto di accesso per ottenere la API Key nella pagina di gestione delle applicazioni di Ace Data Cloud

Dopo essere entrati nella console, copiare la piattaforma API Key da utilizzare.

Se non si dispone ancora di una piattaforma API Key, fare clic sul pulsante Crea nell'angolo in alto a destra della pagina e seguire le istruzioni per creare una nuova piattaforma API Key.

2. Configurare il servizio MCP in WorkBuddy

WorkBuddy offre tre metodi di configurazione del servizio MCP; è possibile sceglierne uno qualsiasi:

  1. Configurazione tramite il gestore MCP;
  2. Modifica diretta del file di configurazione;
  3. Lasciare che WorkBuddy completi automaticamente la configurazione.

Metodo uno: configurazione tramite il gestore MCP

Aprire WorkBuddy e accedere, nell'ordine, alla pagina Esperti > Competenze > Connettori.

Qui sono disponibili diversi connettori. Fare clic su Connettore personalizzato nell'angolo in alto a destra della pagina per accedere alla pagina di configurazione del connettore.

Pagina dei connettori di WorkBuddy

A questo punto verrà visualizzata la finestra di configurazione del connettore. Di seguito viene utilizzato come esempio il servizio Suno di Ace Data Cloud per mostrare il metodo di configurazione specifico.

Finestra di configurazione del connettore personalizzato

Fare clic sul pulsante Aggiungi MCP nella parte superiore della pagina.

Aggiunta del servizio MCP

Aggiungere il seguente codice di configurazione e sostituire la tua API Key nel codice con la API Key appena copiata:

"acedatacloud-suno": {
  "type": "http",
  "url": "https://suno.mcp.acedata.cloud/mcp",
  "headers": {
    "Authorization": "Bearer 你的 API Key"
  },
  "description": "Suno AI 音乐生成（生成/续写/翻唱/歌词）"
}

Dopo aver completato la configurazione, fare clic sul pulsante Salva. Quindi tornare alla pagina dei connettori, individuare ed espandere il servizio Suno appena aggiunto.

Al primo utilizzo, WorkBuddy potrebbe richiedere di confermare se si considera attendibile questo servizio. Dopo aver fatto clic sul pulsante Considera attendibile, sarà possibile visualizzare i servizi correlati forniti da Suno.

Elenco dei servizi MCP di Suno

A questo punto, è possibile chiamare in WorkBuddy il servizio Suno fornito da Ace Data Cloud.

Metodo due: modificare direttamente il file di configurazione

Questo metodo è simile al precedente, ma richiede di modificare direttamente il file di configurazione di WorkBuddy.

Il percorso predefinito del file di configurazione è il seguente:

C:\Users\你的用户名\.workbuddy\mcp.json

Aggiungere la seguente configurazione alla configurazione MCP esistente:

"acedatacloud-suno": {
  "type": "http",
  "url": "https://suno.mcp.acedata.cloud/mcp",
  "headers": {
    "Authorization": "Bearer 你的 API Key"
  },
  "description": "Suno AI 音乐生成（生成/续写/翻唱/歌词）"
}

Sostituire la tua API Key nel codice con la API Key copiata dalla console di Ace Data Cloud, quindi salvare il file.

Nota:

  • Il codice sopra riportato è un frammento JSON da aggiungere alla configurazione esistente e non è necessariamente un file mcp.json completo.
  • Se nella configurazione originale sono già presenti altri servizi, è necessario aggiungere correttamente le virgole secondo il formato JSON.
  • Non utilizzare direttamente questo frammento per sovrascrivere l'intero file di configurazione.
  • Si consiglia di eseguire il backup del file mcp.json originale prima della modifica.
  • Errori nel formato JSON potrebbero impedire a WorkBuddy di avviarsi correttamente, pertanto questo metodo è più adatto agli utenti con una certa conoscenza informatica.

Metodo tre: lasciare che WorkBuddy configuri automaticamente

È anche possibile chiedere direttamente a WorkBuddy di modificare la configurazione MCP.

Inserire quanto segue nella finestra di chat di WorkBuddy:

请帮我配置 MCP 服务，配置如下：

"acedatacloud-suno": {
  "type": "http",
  "url": "https://suno.mcp.acedata.cloud/mcp",
  "headers": {
    "Authorization": "Bearer 你的 API Key"
  },
  "description": "Suno AI 音乐生成（生成/续写/翻唱/歌词）"
}

Prima di inviare, sostituire la tua API Key al suo interno con la API Key copiata dalla console di Ace Data Cloud.

Successivamente, WorkBuddy completerà automaticamente la configurazione in base al contenuto sopra indicato. Una volta completata la configurazione, è possibile aprire l'elenco dei servizi MCP ed espandere il servizio Suno per visualizzare le funzioni attualmente richiamabili.

Suggerimento: è possibile chiedere direttamente a WorkBuddy lo scopo, i parametri e il metodo di chiamata dei vari servizi di Suno. Quando si utilizza il metodo di configurazione automatica, verificare il contenuto che WorkBuddy sta per modificare prima dell'esecuzione, per evitare di sovrascrivere erroneamente la configurazione esistente.

3. Chiamare il modello Suno per creare una canzone

Dopo aver completato la configurazione del servizio MCP di Suno, è possibile creare canzoni in WorkBuddy.

Di seguito viene presentato un metodo di utilizzo di base. L'effetto di generazione specifico dipende dalle impostazioni del prompt, dello stile musicale, dei tag e di altri parametri.

3.1 Inserire le esigenze di creazione della canzone

È possibile inserire nella finestra di chat:

请使用 Suno 为我创作一首歌曲。

Per migliorare la corrispondenza tra il risultato generato e le aspettative, si consiglia di aggiungere le seguenti informazioni nel prompt:

  • Tema della canzone;
  • Stile musicale;
  • Lingua del canto;
  • Genere del cantante o caratteristiche della voce;
  • Atmosfera emotiva;
  • Velocità e ritmo;
  • Se è necessario generare automaticamente il testo.

Ad esempio:

请使用 Suno 为我创作一首中文流行歌曲。

歌曲主题：雨后的城市与重新出发
音乐风格：流行、轻摇滚
情绪氛围：温暖、充满希望
演唱声音：年轻男声
歌曲节奏：中速
其他要求：生成完整歌词，并提供合适的歌曲标题

Inserire le esigenze di creazione della canzone

3.2 Specificare il servizio Suno di Ace Data Cloud

Se è necessario specificare chiaramente il servizio, è possibile inserire:

Si prega di utilizzare il modello Suno di Ace Data Cloud per la creazione.

WorkBuddy leggerà i servizi MCP già configurati e richiamerà il servizio Suno corrispondente per eseguire l'attività.

Richiamare il servizio Suno di Ace Data Cloud

La generazione del brano richiede solitamente alcuni minuti di attesa; il tempo effettivo può essere influenzato da fattori quali il modello, la durata del brano e la coda delle attività.

3.3 Consultare lo stato di generazione del brano

Se non è possibile ottenere normalmente il brano, oppure se l'attività non restituisce risultati per molto tempo, è possibile chiedere a WorkBuddy di richiamare il servizio di consultazione delle attività.

Ad esempio:

Per favore, aiutami a consultare l'attività di generazione del brano Suno inviata poco fa.

Consultare l'attività di generazione del brano

Una volta completata l'attività, il brano verrà salvato in locale; fare clic sul file audio corrispondente per ascoltarlo in anteprima.

Di seguito sono riportati i brani generati in questa dimostrazione:

4. Visualizzare le attività cronologiche

Tornare alla console di Ace Data Cloud e accedere alla pagina Pannello di controllo > Attività cronologiche per visualizzare l'attività di generazione del brano appena inviata.

Visualizzare le attività cronologiche

Nella pagina delle attività cronologiche, è possibile visualizzare lo stato dell'attività e i relativi risultati di generazione.

Attraverso i servizi MCP forniti da Ace Data Cloud, è possibile estendere comodamente WorkBuddy con funzionalità esterne come Suno.

L'intero processo di integrazione include principalmente i seguenti due passaggi:

  1. Creare e copiare l'API Key nella console di Ace Data Cloud;
  2. Aggiungere la configurazione MCP in WorkBuddy e completare l'autorizzazione del servizio.

Questo articolo utilizza la generazione musicale Suno come esempio e illustra il processo di configurazione, richiamo e consultazione delle attività del servizio MCP. Anche altri servizi MCP possono essere integrati in modo simile.

Il servizio Suno di Ace Data Cloud adotta un modello di fatturazione per utilizzo, senza necessità di sottoscrivere un piano mensile. Per gli standard di costo effettivi, fare riferimento alle informazioni più recenti nella console di Ace Data Cloud e nella relativa documentazione tecnica.

Durante il processo di configurazione, conservare correttamente l'API Key ed eseguire il backup del file originale prima di modificare manualmente il file mcp.json.