Configurare il server MCP di Adobe Workfront
Il server MCP Adobe Workfront ti consente di lavorare con i tuoi dati Workfront attraverso una conversazione in linguaggio naturale in una piattaforma di intelligenza artificiale supportata.
Prima di poter collegare una piattaforma di agenti di intelligenza artificiale a Workfront, un amministratore Workfront deve abilitare l’accesso al server MCP nell’istanza di Workfront. I passaggi esatti per connettere una piattaforma AI agente sono diversi per ogni piattaforma AI agente supportata.
Piattaforme di IA agente supportate
Il server MCP di Workfront funziona con qualsiasi piattaforma di intelligenza artificiale che supporta il protocollo MCP (Model Context Protocol).
Questo articolo illustra i passaggi di connessione per:
- Claude
- ChatGPT
Se utilizzi una piattaforma agente di IA compatibile con MCP diversa (ad esempio, Gemini o Microsoft Copilot), segui i passaggi descritti nella documentazione di tale piattaforma per aggiungere un server MCP personalizzato. Quando viene richiesto l’URL del server MCP, immetti:
https://mcp.workfront.adobe.com/mcp/v1/workfront
Prerequisiti
Prima di poter collegare Workfront a una piattaforma di intelligenza artificiale, è necessario:
- Disporre di un account Adobe Workfront attivo con l’autorizzazione per accedere ai dati che si desidera utilizzare
- Avere accesso a una piattaforma agente di IA come Claude
- L’istanza di Workfront deve essere abilitata su Adobe Identity Management System (IMS).
- Per utilizzare MCP con Workfront Planning, l’organizzazione deve essere inclusa in un pacchetto Workfront che includa Adobe Workfront Planning.
Prerequisiti per l’amministrazione
L’accesso al server MCP è gestito da due amministratori distinti.
-
L’amministratore di Workfront controlla l’accesso al server MCP per l’istanza di Workfront tramite due opzioni in Preferenze di sistema: Strumenti MCP di sola lettura (per impostazione predefinita) e Strumenti MCP di scrittura (per impostazione predefinita). Se è possibile trovare elementi Workfront tramite la piattaforma di gestione dell’intelligenza artificiale ma non è possibile crearli, aggiornarli o eliminarli, chiedi all’amministratore di Workfront di abilitare le azioni di scrittura.
Per ulteriori informazioni, vedere Configurare le preferenze di sistema.
-
Se utilizzi una versione Enterprise di una piattaforma AI agente, l’amministratore di tale piattaforma deve abilitare il connettore Adobe Workfront per la tua organizzazione o concederti l’accesso URL personalizzato per connettersi al server Workfront MCP.
Connettere Workfront a Claude
La connessione a Workfront viene eseguita una volta per ogni account Claude. La connessione consente di eseguire l’autenticazione a una specifica istanza di Workfront e si rimane connessi fino a quando non si sceglie di disconnettersi.
Connettersi a Claude Desktop dalla directory dei connettori
Per connettere Workfront a Claude:
-
Apri Claude.
-
Passare all’area connettori.
-
Trovare Adobe Workfront nell’elenco dei connettori.
Se non lo vedi, vedi Prerequisiti di amministratore in questo articolo.
-
Fai clic su Connetti.
-
Quando richiesto, accedi all’istanza di Workfront.
-
Al termine dell’autenticazione, sei connesso.
Connettersi a Claude con un URL
| note |
|---|
| NOTE |
| Per eseguire questa procedura, è necessario essere un proprietario in un ambiente aziendale Claude. |
| Per l'affermazione di Claude sul requisito del proprietario, vedere Aggiungere un connettore personalizzato nella documentazione di Claude. |
Per connettere Workfront a Claude con un URL:
-
Accedi a Claude utilizzando le tue credenziali.
-
Nel menu a sinistra, seleziona l’icona Personalizza.
-
Seleziona Connettori, quindi seleziona l’icona + per aggiungere un connettore.
-
Seleziona il pulsante Crea app.
-
Assegna al connettore un nome desiderato (ad esempio “Workfront”) e immetti l’URL del server MCP:
code language-none https://mcp.workfront.adobe.com/mcp/v1/workfront -
Una volta creato il connettore, viene visualizzata una finestra di accesso. Esegui l’autenticazione utilizzando le credenziali di Adobe ID. Se appartieni a più istanze, assicurati di selezionare l’istanza Workfront desiderata.
Personalizzare il comportamento di Claude con le abilità
Claude supporta set di istruzioni creati dall’utente denominati skill. È possibile utilizzare un’abilità per personalizzare il comportamento di Claude con Workfront. È possibile, ad esempio, creare un’abilità che indica a Claude di recuperare sempre dati aggiornati da Workfront anziché basarsi sui risultati precedenti.
Per ulteriori informazioni sulle Claude abilità, consulta la documentazione per l’utente Claude o chiedi aiuto a Claude per le abilità.
Connetti a ChatGPT
La procedura per connettere il server Workfront MCP con ChatGPT varia a seconda che si utilizzi ChatGPT Desktop o Codex o ChatGPT sul web.
Connessione al codex ChatGPT Desktop o ChatGPT
-
In ChatGPT aprire Impostazioni.
-
Fai clic su Plug-in nell’area di navigazione a sinistra.
-
Fai clic su Aggiungi server in alto a destra nella finestra.
-
Immettere un nome per il server.
-
Per il tipo, selezionare HTTP semplificabile.
-
Impostare l’URL del server MCP:
code language-none https://mcp.workfront.adobe.com/mcp/v1/workfront -
Fai clic su Salva.
-
Nell’elenco visualizzato fare clic su Autentica per il server MCP che si sta aggiungendo.
-
Accedi a Workfront.
-
In ChatGPT, nell’elenco dei server MCP, assicurati che l’interruttore a destra del nuovo server MCP rimanga attivato.
Connettersi a ChatGPT sul web
-
Accedi a ChatGPT utilizzando le tue credenziali.
-
In basso a sinistra, seleziona il tuo nome, quindi seleziona Impostazioni.
-
Nel menu di navigazione a sinistra, seleziona Protezione e accesso.
-
Vai alla pagina dei plug-in di ChatGPT all’indirizzo https://chatgpt.com/plugins.
-
Fai clic sull’icona Più in alto a destra nella pagina Plugin.
-
Nel campo Nome immettere un nome per il server MCP.
-
Nel campo Connessione, selezionare URL server e immettere l’URL del server MCP:
code language-none https://mcp.workfront.adobe.com/mcp/v1/workfront -
Verificare che l’autenticazione sia impostata su OAuth (impostazione predefinita).
-
Leggere il messaggio di rischio e selezionare la casella per indicare che è stato letto.
-
Fai clic su Crea.
-
Dopo la creazione dell’app, viene visualizzata una finestra di accesso di Workfront. Esegui l’autenticazione utilizzando le credenziali di Adobe ID. Se appartieni a più istanze, assicurati di selezionare l’istanza Workfront desiderata.
Personalizzare il comportamento di ChatGPT con GPT personalizzati
ChatGPT supporta gli assistenti creati dall’utente denominati GPT personalizzati. Puoi utilizzare un GPT personalizzato per personalizzare il comportamento di ChatGPT con il connettore. Ad esempio, puoi creare un GPT personalizzato che comunichi a ChatGPT di recuperare sempre dati aggiornati dal servizio connesso, invece di fare affidamento sui risultati precedenti.
Per ulteriori informazioni sugli GPT personalizzati, consulta la documentazione utente di ChatGPT o chiedi a ChatGPT di fornire assistenza sugli GPT personalizzati.
Connetti Workfront a Copilot
Per creare un agente Copilot personalizzato a cui Workfront MCP può connettersi, utilizzare Copilot Studio.
-
In Copilot Studio fare clic su Crea agente vuoto.
-
Assegna un nome all’agente e fai clic su Crea.
Viene visualizzata la finestra dell’agente. -
Nel campo Istruzioni, descrivi le operazioni che desideri eseguire l’agente. Includi informazioni quali i processi e il modo in cui utilizzi Workfront. Si consiglia di fornire una grande quantità di dettagli.
-
Nella navigazione in alto, fai clic su Strumenti, quindi su Aggiungi uno strumento.
-
Selezionare il riquadro Protocollo di contesto modello.
-
Nel pannello visualizzato, immetti un nome e una descrizione per la connessione.
-
Nel campo URL server, immetti l’URL:
https://mcp.workfront.adobe.com/mcp/v1/workfront`
-
Per Autorizzazione, seleziona OAuth 2.0, quindi seleziona Individuazione dinamica.
-
Fai clic su Crea nella parte inferiore del pannello.
L’app è registrata.
-
Dopo la registrazione dell’app, nel pannello visualizzato fare clic su Non connesso, quindi su Crea una nuova connessione e infine su Crea.
-
Nel pannello di accesso visualizzato, accedi a Workfront, quindi seleziona Continua quando viene visualizzata l’istanza di Workfront che desideri utilizzare.
-
Nel pannello che visualizza il server, fai clic su Aggiungi e configura.
Ora puoi iniziare a utilizzare e configurare gli strumenti per il server MCP.
-
Quando uno strumento viene configurato e testato, fare clic su Pubblica.
Potresti non disporre delle autorizzazioni necessarie per pubblicare. In questo caso, contattare l’amministratore Copilot.
Collegare Workfront a una soluzione MCP personalizzata
Se si sta creando un’applicazione o un agente personalizzato, è possibile connettersi direttamente al server MCP di Workfront.
Esistono due modi per connettersi:
Connettersi con un token di servizio
-
Crea una credenziale di servizio utilizzando Adobe Developer Console. Per informazioni, vedere Autenticazione da server a server.
-
Connettersi al server Workfront MCP utilizzando le informazioni seguenti:
-
URL:
https://mcp.workfront.adobe.com/mcp/v1/workfront -
Intestazioni:
Authorization: Bearer <access_token>wf-url: <your_subdomain>.my.workfront.com(obbligatorio se le credenziali hanno accesso a più istanze di Workfront, ad esempio Anteprima e Produzione).
-
Connessione con OAuth
Il supporto self-service per le integrazioni OAuth personalizzate non è ancora disponibile per Workfront.
Verifica la connessione
Per verificare che la piattaforma di gestione dell’intelligenza artificiale sia connessa a Workfront, chiedi alla piattaforma di gestione dell’intelligenza artificiale di elencare le azioni che il server Workfront MCP rende disponibili. Ad esempio:
- Quali azioni puoi intraprendere Workfront?
- Elenca gli strumenti di Workfront a cui hai accesso.
È inoltre possibile visualizzare l’elenco completo degli strumenti in Strumenti server Adobe Workfront MCP.
Strumenti disponibili
Il server MCP di Workfront espone un set di strumenti richiamati dalla piattaforma dell’agente di intelligenza artificiale connesso, ad esempio strumenti per cercare in Workfront, creare elementi, aggiornare campi e gestire le approvazioni. Per l’elenco completo dei riferimenti, raggruppati per area Workfront, vedere Strumenti server MCP di Adobe Workfront.
Passa a un’altra istanza di Workfront
Ogni connessione autentica la piattaforma dell’agente di intelligenza artificiale in una singola istanza di Workfront. Per utilizzare un’istanza diversa, disconnettiti e riconnettiti.
Per connettersi a un’altra istanza di Workfront:
- Nella piattaforma dell’agente di intelligenza artificiale, disconnetti il server MCP di Workfront.
- Ricollegare il connettore.
- Esegui l’autenticazione alla nuova istanza di Workfront.
- La disconnessione da sola non cambia l’istanza di Workfront. È necessario disconnettere e ricollegare il connettore.
Risoluzione dei problemi di configurazione e autenticazione
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 | ||
|---|---|---|
| Problema | Probabile causa | Correggi |
| Impossibile trovare il connettore Adobe Workfront in Claude. | L’amministratore Claude non l’ha abilitato. | Contattare l’amministratore Claude (non l’amministratore Workfront) e richiedere l’attivazione del connettore Adobe Workfront. |
| Ti sei connesso, ma non puoi vedere i tuoi dati. | Hai eseguito l’autenticazione nell’istanza di Workfront errata. | Scollegare il connettore, riconnettersi e autenticarsi nell’istanza corretta. |
| Autenticazione non riuscita o connessione interrotta. | La sessione di autenticazione è scaduta o si è verificato un errore di connessione. | Scollegare e ricollegare il connettore. |
| Desideri passare a un’istanza di Workfront diversa. | Una singola connessione ti collega a un’istanza. | Disconnetti, riconnetti e autentica la nuova istanza. |
| Non è possibile connettersi a Workfront oppure viene visualizzato un messaggio che indica che l’accesso al server MCP è disabilitato. | L’amministratore di Workfront ha disattivato l’accesso al server MCP per l’istanza. | Contattare l’amministratore di Workfront e chiedere di abilitare l’accesso al server MCP in Preferenze di sistema. |
| La piattaforma dell’agente di intelligenza artificiale può trovare i tuoi elementi Workfront, ma non può crearli, aggiornarli o eliminarli. | L’amministratore di Workfront ha disabilitato le azioni di scrittura per il server Workfront MCP. | Contatta l’amministratore di Workfront e chiedi di abilitare le azioni di scrittura nelle Preferenze di sistema. |
Per la risoluzione dei problemi quotidiani dopo la connessione (ad esempio, risultati non aggiornati o comportamenti imprevisti), vedere Utilizzare il server Adobe Workfront MCP.
Domande frequenti sulla configurazione
- È possibile connettersi a più istanze di Workfront contemporaneamente?
- Quale amministratore abilita questa impostazione?
- Posso utilizzare il server Workfront MCP se la mia istanza Workfront non è abilitata su Adobe Identity Management System (IMS)?
È possibile connettersi a più istanze di Workfront contemporaneamente?
No. Ogni connessione collega una piattaforma AI agente a una singola istanza Workfront. Per passare, disconnettersi e riconnettersi, eseguire l’autenticazione nella nuova istanza.
Quale amministratore abilita questa impostazione?
Sia l’amministratore di Workfront che l’amministratore della piattaforma di intelligenza artificiale. L’amministratore di Workfront abilita l’accesso al server MCP sul lato Workfront. L’amministratore della piattaforma di intelligenza artificiale consente l’accesso a Workfront dal lato della piattaforma. Per Claude, l’amministratore Enterprise di Claude abilita il connettore Adobe Workfront.
Posso utilizzare il server Workfront MCP se la mia istanza Workfront non è abilitata su Adobe Identity Management System (IMS)?
No. Per utilizzare il server MCP di Workfront, l’istanza di Workfront deve essere abilitata su Adobe Identity Management System (IMS). Se non sei sicuro se la tua istanza è abilitata su IMS, contatta il tuo amministratore Workfront.