Configurar o servidor MCP do Adobe Workfront
O servidor MCP do Adobe Workfront permite que você trabalhe com seus dados do Workfront por meio de conversas em linguagem natural em uma plataforma de agente de IA com suporte.
Antes de conectar uma plataforma de agente de IA ao Workfront, um administrador do Workfront deve habilitar o acesso ao servidor MCP na instância do Workfront. As etapas exatas para conectar uma plataforma de agente de IA são diferentes para cada plataforma de agente de IA compatível.
Plataformas de IA compatíveis
O servidor de MCP do Workfront funciona com qualquer plataforma de agente de IA compatível com o protocolo de contexto de modelo (MCP).
Este artigo aborda as etapas de conexão para:
- Claude
- ChatGPT
Se você usar uma plataforma de agente de IA compatível com MCP diferente (por exemplo, Gemini ou Microsoft Copilot), siga as etapas na documentação dessa plataforma para adicionar um servidor MCP personalizado. Quando for solicitado o URL do servidor MCP, insira:
https://mcp.workfront.adobe.com/mcp/v1/workfront
Pré-requisitos
Antes de conectar o Workfront a uma plataforma de agente de IA, é necessário:
- Ter uma conta Adobe Workfront ativa com permissão para acessar os dados com os quais deseja trabalhar
- Ter acesso a uma plataforma de agente de IA como o Claude
- Sua instância do Workfront deve estar ativada no Adobe Identity Management System (IMS).
- Para usar o MCP com o Workfront Planning, sua organização deve estar em um pacote do Workfront que inclua o Adobe Workfront Planning.
Pré-requisitos do administrador
O acesso ao servidor MCP é restringido por dois administradores separados.
-
O administrador do Workfront controla o acesso ao servidor MCP para sua instância do Workfront por meio de dois alternadores nas Preferências do Sistema: Ferramentas MCP somente leitura (habilitadas por padrão) e Ferramentas MCP de gravação (desabilitadas por padrão). Se você puder encontrar itens do Workfront por meio da plataforma de agente de IA, mas não puder criá-los, atualizá-los ou excluí-los, peça ao administrador do Workfront para habilitar ações de gravação.
Para obter mais informações, consulte Configurar preferências do sistema.
-
Se você usar uma versão corporativa de uma plataforma de agente de IA, o administrador dessa plataforma deverá habilitar o conector Adobe Workfront para sua organização ou fornecer acesso de URL personalizado para se conectar ao servidor MCP do Workfront.
Conectar o Workfront ao Claude
Você se conecta ao Workfront uma vez a cada conta Claude. A conexão é autenticada em uma instância específica do Workfront e você permanece conectado até que opte por se desconectar.
Conectar-se ao Claude Desktop a partir do diretório connectors
Para conectar o Workfront a Claude:
-
Abrir Claude.
-
Clique em Personalizar.
-
Na navegação à esquerda, clique em Conectores.
-
Localize Adobe Workfront na lista de conectores.
Caso não o veja, consulte Pré-requisitos de administração neste artigo.
-
Clique em Conectar.
-
Quando solicitado, faça logon na instância do Workfront. Talvez seja necessário selecionar um perfil e uma instância do Workfront. O perfil selecionado determina qual espaço de trabalho está conectado.
Após a conclusão da autenticação, o servidor MCP do Workfront é conectado.
Conectar-se a Claude com um URL
| note |
|---|
| NOTE |
| Você deve ser um proprietário em um ambiente corporativo do Claude para executar esse procedimento. |
| Para obter a declaração de Claude sobre o requisito de proprietário, consulte Adicionar um conector personalizado na documentação do Claude. |
Para conectar o Workfront a Claude com uma URL:
-
Faça login em Claude usando suas credenciais.
-
No menu esquerdo, selecione o ícone Personalizar.
-
Na navegação à esquerda, selecione Conectores.
-
Selecione o ícone + e selecione Adicionar conector personalizado.
-
Dê ao conector um nome desejado (como “Workfront”) e insira o URL do servidor MCP:
code language-none https://mcp.workfront.adobe.com/mcp/v1/workfront -
Clique em Conectar.
Uma janela de logon do Workfront é exibida. -
Autentique usando suas credenciais da Adobe ID.
Talvez seja necessário selecionar um perfil e uma instância do Workfront. O perfil selecionado determina qual espaço de trabalho está conectado.
Personalizar o comportamento do Claude com habilidades
Claude dá suporte a conjuntos de instruções criados pelo usuário chamados habilidades. Você pode usar uma habilidade para personalizar como Claude se comporta com o Workfront. Por exemplo, você pode criar uma habilidade que diga a Claude para sempre buscar dados novos do Workfront em vez de depender de resultados anteriores.
Para saber mais sobre Claude habilidades, consulte a documentação do usuário do Claude ou peça ajuda ao Claude com as habilidades.
Conectar-se ao ChatGPT
O procedimento para conectar o servidor de MCP do Workfront com o ChatGPT difere conforme você esteja usando o ChatGPT Desktop ou Codex, ou o ChatGPT na Web.
Conectar-se ao ChatGPT Desktop ou ao Códex ChatGPT
-
No ChatGPT, abra Configurações.
-
Clique em Plug-ins na navegação à esquerda.
-
Clique em Adicionar servidor próximo ao canto superior direito da janela.
-
Insira um nome para o servidor.
-
Para o tipo, selecione HTTP transmissível.
-
Defina o URL do servidor MCP:
code language-none https://mcp.workfront.adobe.com/mcp/v1/workfront -
Clique em Salvar.
-
Na lista exibida, clique em Autenticar para o servidor MCP que você está adicionando.
-
Faça logon no Workfront.
Talvez seja necessário selecionar um perfil e uma instância do Workfront. O perfil selecionado determina qual espaço de trabalho está conectado. -
No ChatGPT, na lista de servidores MCP, certifique-se de que a alternância à direita do novo servidor MCP permaneça ativada.
Conectar-se ao ChatGPT na Web
-
Faça logon em ChatGPT usando suas credenciais.
-
Na parte inferior esquerda, selecione seu nome e, em seguida, selecione Configurações.
-
Na navegação à esquerda, selecione Segurança e logon.
-
Vá para a página de plug-ins do ChatGPT em https://chatgpt.com/plugins.
-
Clique no ícone de adição próximo ao canto superior direito da página Plug-ins.
-
No campo Nome, digite um nome para o servidor MCP.
-
No campo Conexão, selecione URL do Servidor e insira a URL do Servidor MCP:
code language-none https://mcp.workfront.adobe.com/mcp/v1/workfront -
Verifique se Autenticação está definida como OAuth (definido por padrão).
-
Leia a mensagem de risco e marque a caixa para mostrar que você a leu.
-
Clique em Criar.
-
Após a criação do aplicativo, uma janela de logon do Workfront é exibida. Autentique usando suas credenciais da Adobe ID. Talvez seja necessário selecionar um perfil e uma instância do Workfront. O perfil selecionado determina qual espaço de trabalho está conectado.
Personalizar o comportamento do ChatGPT com GPTs personalizados
O ChatGPT oferece suporte a assistentes criados pelo usuário chamados de GPTs personalizados. Você pode usar um GPT personalizado para personalizar como o ChatGPT se comporta com seu conector. Por exemplo, você pode criar um GPT personalizado que instrui o ChatGPT a sempre buscar dados novos do serviço conectado, em vez de depender de resultados anteriores.
Para saber mais sobre GPTs Personalizados, consulte a documentação do usuário do ChatGPT ou peça ajuda ao ChatGPT para obter GPTs Personalizados.
Conectar o Workfront ao Copilot
Para criar um agente Copilot personalizado ao qual o MCP do Workfront pode se conectar, use o Copilot Studio.
-
No Copilot Studio, clique em Criar agente em branco.
-
Nomeie o agente e clique em Criar.
A janela do agente é aberta. -
No campo Instruções, descreva o que você deseja que o agente faça. Inclua informações como seus processos e como você usa o Workfront. Recomendamos fornecer uma grande quantidade de detalhes.
-
Na navegação superior, clique em Ferramentas e em Adicionar uma ferramenta.
-
Selecione o bloco Protocolo de contexto do modelo.
-
No painel exibido, digite um nome e uma descrição para essa conexão.
-
No campo URL do servidor, digite o URL:
code language-none https://mcp.workfront.adobe.com/mcp/v1/workfront` -
Para Autenticação, selecione OAuth 2.0 e Descoberta dinâmica.
-
Clique em Criar na parte inferior do painel.
O aplicativo está registrado.
-
Depois que o aplicativo for registrado, no painel que aparece, clique em Não conectado, em seguida, clique em Criar uma nova conexão e em Criar.
-
Configure uma conexão clicando em Não conectado, depois em Criar nova conexão e depois em Criar.
-
No painel de logon exibido, faça logon no Workfront, selecione a instância que deseja usar (se você tiver acesso a mais de uma instância) e clique em Continuar.
-
No painel que exibe seu servidor, clique em Adicionar e configurar.
Agora você pode começar a usar e configurar ferramentas para o servidor MCP.
-
Quando uma ferramenta for configurada e testada, clique em Publicar.
Talvez você não tenha permissões para publicar. Se esse for o caso, entre em contato com o administrador do Copilot.
Conectar o Workfront a uma solução MCP personalizada
Se estiver criando seu próprio aplicativo ou agente personalizado, você poderá se conectar diretamente ao servidor Workfront MCP.
Há duas maneiras de se conectar:
Conectar-se com um token de serviço para serviço
-
Crie uma credencial de serviço usando o Adobe Developer Console. Para obter informações, consulte Autenticação de Servidor para Servidor.
-
Conecte-se ao servidor MCP do Workfront usando as seguintes informações:
-
URL:
https://mcp.workfront.adobe.com/mcp/v1/workfront -
cabeçalhos:
Authorization: Bearer <access_token>wf-url: <your_subdomain>.my.workfront.com(obrigatório se sua credencial tiver acesso a mais de uma instância do Workfront, como Pré-visualização e Produção).
-
Conectar-se ao OAuth
O suporte de autoatendimento para integrações OAuth personalizadas ainda não está disponível para o Workfront.
Verifique sua conexão
Para confirmar se a plataforma do agente de IA está conectada ao Workfront, peça à plataforma do agente de IA para listar as ações que o servidor MCP do Workfront disponibiliza. Por exemplo:
- Que ações do Workfront você pode realizar?
- Listar as ferramentas do Workfront às quais você tem acesso.
Você também pode ver a lista completa de ferramentas em ferramentas de servidor MCP do Adobe Workfront.
Ferramentas disponíveis
O servidor MCP do Workfront expõe um conjunto de ferramentas que a plataforma de agente de IA conectada chama em seu nome — por exemplo, ferramentas para pesquisar no Workfront, criar itens, atualizar campos e gerenciar aprovações. Para obter a lista de referência completa, agrupada por área do Workfront, consulte Ferramentas de servidor MCP do Adobe Workfront.
Alternar para uma instância diferente do Workfront
Cada conexão autentica a plataforma de IA em uma única instância do Workfront. Para usar uma instância diferente, desconecte e reconecte.
Para se conectar a uma instância diferente do Workfront:
- Na plataforma do agente de IA, desconecte o servidor MCP do Workfront.
- Reconecte o conector.
- Autentique para a nova instância do Workfront.
- Fazer logoff sozinho não alterna a instância do Workfront. Você deve desconectar e reconectar o conector.
Solução de problemas de configuração e autenticação
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 | ||
|---|---|---|
| Problema | Causa provável | Corrigir |
| Você não pode encontrar o conector Adobe Workfront em Claude. | O administrador do Claude não o habilitou. | Contate o administrador do Claude (não o administrador do Workfront) e peça que ele habilite o conector Adobe Workfront. |
| Você se conectou, mas não pode ver seus dados. | Você autenticou na instância incorreta do Workfront. | Desconecte o conector, reconecte e autentique na instância correta. |
| Falha na autenticação ou a conexão parou de funcionar. | Sua sessão de autenticação expirou ou há um erro de conexão. | Desconecte e reconecte o conector. |
| Você deseja alternar para uma instância diferente do Workfront. | Uma única conexão vincula você a uma instância. | Desconecte, reconecte e autentique na nova instância. |
| Você não pode se conectar ao Workfront ou vê uma mensagem informando que o acesso ao servidor MCP está desativado. | O administrador do Workfront desativou o acesso ao servidor MCP para sua instância. | Entre em contato com o administrador do Workfront e solicite que ele ative o acesso ao servidor MCP nas Preferências do sistema. |
| A plataforma do agente de IA pode encontrar seus itens do Workfront, mas não pode criá-los, atualizá-los ou excluí-los. | O administrador do Workfront desativou as ações de gravação do servidor MCP do Workfront. | Entre em contato com o administrador do Workfront e solicite que ele ative ações de gravação nas Preferências do sistema. |
Para obter uma solução de problemas diária depois de se conectar (por exemplo, resultados obsoletos ou comportamento inesperado), consulte Usar o servidor MCP do Adobe Workfront.
Perguntas frequentes sobre configuração
- Posso me conectar a várias instâncias do Workfront ao mesmo tempo?
- Qual administrador habilita isto?
- Posso usar o servidor MCP do Workfront se minha instância do Workfront não estiver ativada no Adobe Identity Management System (IMS)?
Posso me conectar a várias instâncias do Workfront ao mesmo tempo?
Não. Cada conexão vincula uma plataforma de IA a uma única instância do Workfront. Para alternar, desconecte e reconecte, autenticando para a nova instância.
Qual administrador habilita isto?
O administrador do Workfront e o administrador da plataforma de agente de IA. O administrador do Workfront habilita o acesso ao servidor MCP no Workfront. O administrador da sua plataforma de agente de IA habilita o acesso ao Workfront no lado dessa plataforma. Para Claude, o administrador corporativo Claude habilita o conector Adobe Workfront.
Posso usar o servidor MCP do Workfront se minha instância do Workfront não estiver ativada no Adobe Identity Management System (IMS)?
Não. Sua instância do Workfront deve estar ativada no Adobe Identity Management System (IMS) para usar o servidor MCP do Workfront. Se não tiver certeza se sua instância está ativada no IMS, entre em contato com o administrador do Workfront.