Ferramentas de servidor Adobe Workfront MCP

Este artigo lista as ferramentas que o servidor MCP Adobe Workfront expõe a uma plataforma de agente de IA conectada. A plataforma chama essas ferramentas em seu nome quando você solicita que elas encontrem, criem, atualizem ou excluam itens do Workfront.

Para obter informações sobre como usar essas ferramentas por meio de uma plataforma de agente de IA, consulte Usar o servidor MCP do Adobe Workfront. Para obter informações sobre como configurar a conexão, consulte Configurar o servidor MCP do Adobe Workfront.

IMPORTANT
A plataforma do agente de IA atua no Workfront usando sua conta da Workfront, o nível de acesso e as permissões do objeto. Uma ferramenta só funciona se você tiver o acesso correspondente no Workfront. A Adobe não se responsabiliza pelas alterações que a plataforma de IA Agent faz nos dados do Workfront.

Ações de leitura e gravação

Cada ferramenta nas tabelas a seguir é classificada na coluna Ação como uma ação de Leitura ou Gravação:

  • Leitura: recupera informações do Workfront sem alterar seus dados. Por exemplo, localizar um projeto, listar documentos ou obter os detalhes de um registro.
  • Gravação: cria, atualiza ou exclui dados do Workfront. Por exemplo, criar um projeto, atualizar um registro ou excluir um modo de exibição.

O administrador do Workfront controla quais categorias de ferramentas a plataforma de IA pode usar por meio de dois botões nas Preferências do sistema:

  • Ferramentas MCP somente leitura (habilitado por padrão)
  • Gravar ferramentas MCP (desabilitado por padrão)

Se a plataforma do agente de IA puder encontrar itens do Workfront, 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 Pré-requisitos de administração em Configurar o servidor MCP do Adobe Workfront.

Ferramentas de aprovação

Documentos

Título
Nome da ferramenta
O que faz
Ação
Localizar versão do documento por nome
approvals_find_document_version_by_name
Pesquisa a ID de versão atual de um documento por nome de arquivo. Suporta correspondências parciais.
Ler
Obter documento por ID de versão
approvals_get_document_by_version_id
Busca detalhes do documento (nome, tamanho, data de upload, carregador) para uma ID de versão de documento conhecida.
Ler
Obter documentos por projeto
approvals_get_documents_by_project
Lista documentos dentro de um projeto Workfront, com cada ID de versão atual do documento.
Ler
Resolver escopo do documento
approvals_resolve_document_scope
Expande um projeto ou pasta para a lista de IDs de versão de documento que ela contém. Suporta escopos de projeto, pasta e pasta por nome.
Ler

Fluxos de trabalho de aprovação

Título
Nome da ferramenta
O que faz
Ação
Obter informações de fluxo de trabalho de aprovação
approvals_get_approval_info
Retorna o fluxo de trabalho de aprovação atual (estágios, participantes, status) para uma versão do documento.
Ler
Criar ou atualizar fluxo de trabalho de aprovação
approvals_create_or_update_approval_workflow
Cria ou atualiza os estágios do fluxo de trabalho de aprovação para uma versão do documento. Suporta dependências de estágio linear e paralelo (gráfico).
Gravar
Criar aprovação a partir do modelo
approvals_create_approval_from_template
Cria um fluxo de trabalho de aprovação em um documento usando um modelo existente.
Gravar
Excluir estágio de aprovação
approvals_delete_approval_stage
Exclui um único estágio de um fluxo de trabalho de aprovação por nome ou posição. Somente estágios não iniciados podem ser excluídos.
Gravar

Lembretes

Título
Nome da ferramenta
O que faz
Ação
Enviar lembrete aos participantes
approvals_send_reminder_to_participants
Envia emails de lembrete para participantes específicos em um estágio de aprovação. Funciona somente para estágios iniciados, não concluídos e não bloqueados.
Gravar
Enviar lembrete para participantes indecisos
approvals_send_reminder_to_undecided
Envia emails de lembrete para todos os participantes indecisos (notificados, abertos ou comentados) em um estágio de aprovação.
Gravar

Modelos de aprovação

Título
Nome da ferramenta
O que faz
Ação
Listar modelos de aprovação
approvals_list_templates
Lista os modelos de aprovação disponíveis nesta instância do Workfront. Suporta filtragem por criador, participante e classificação por uso.
Ler
Pesquisar modelo por nome
approvals_search_template_by_name
Localiza modelos de aprovação por nome (não diferencia maiúsculas de minúsculas).
Ler
Criar modelo de aprovação
approvals_create_template
Cria um novo modelo de aprovação com dependências de estágio lineares ou baseadas em gráfico.
Gravar
Atualizar modelo de aprovação
approvals_update_template
Atualiza um modelo existente com modificações estruturadas (adicionar ou remover participantes, renomear estágios, definir prazos, etc.).
Gravar

Pesquisas e usuários

Título
Nome da ferramenta
O que faz
Ação
Obter usuário atual
approvals_get_current_user
Retorna a identidade do Workfront do usuário que faz a chamada, incluindo nome, ID de usuário, nome da equipe inicial e ID da equipe inicial.
Ler
Localizar usuário por nome
approvals_find_user_by_name
Pesquisa a ID de um usuário do Workfront por nome (correspondência difusa ou parcial). Retorna nome, ID, email, título e URL do avatar.
Ler
Localizar equipe por nome
approvals_find_team_by_name
Pesquisa a ID de uma equipe do Workfront por nome (correspondência difusa ou parcial).
Ler
Localizar projeto por nome
approvals_find_project_by_name
Procura projetos do Workfront por correspondência de nome parcial no sistema.
Ler
Obter projetos por proprietário
approvals_get_projects_by_owner
Lista os projetos do Workfront dos quais o usuário que faz a chamada é o proprietário.
Ler
Obter região do Adobe
approvals_get_adobe_region
Retorna o nome da Adobe de uma região do provedor de nuvem.
Ler

Ferramentas de planejamento

IMPORTANT
  • Para usar o MCP com o Workfront Planning, sua organização deve estar em um pacote do Workfront que inclua o Adobe Workfront Planning.

Espaços de trabalho

Título
Nome da ferramenta
O que faz
Ação
Obter espaço de trabalho
planning_get_workspace
Recupera detalhes completos de um espaço de trabalho por ID ou alias.
Ler
Obter lista do espaço de trabalho
planning_get_workspace_list
Lista todos os espaços de trabalho disponíveis com paginação baseada em cursor.
Ler
Criar espaço de trabalho
planning_create_workspace
Cria um novo espaço de trabalho vazio para organizar tipos de registro, campos e dados.
Gravar
Criar espaço de trabalho a partir do modelo
planning_create_workspace_from_template
Cria um novo espaço de trabalho pré-preenchido usando um modelo existente.
Gravar
Atualizar espaço de trabalho
planning_update_workspace
Atualiza parcialmente um espaço de trabalho — nome, descrição, ícone, seções ou proprietário.
Gravar
Excluir espaço de trabalho
planning_delete_workspace
Exclui permanentemente um espaço de trabalho e todos os seus dados.
Gravar
Converter espaço de trabalho em modelo
planning_convert_workspace_to_template
Salva um espaço de trabalho existente como um modelo reutilizável (requer admin).
Gravar
Obter compartilhamento do espaço de trabalho
planning_get_workspace_sharing
Retorna a configuração atual de compartilhamento e permissões de um espaço de trabalho.
Ler
Modificar compartilhamento do espaço de trabalho
planning_modify_workspace_sharing
Atualiza quem tem acesso a um espaço de trabalho e em qual nível de permissão.
Gravar

Tipos de registro

Título
Nome da ferramenta
O que faz
Ação
Obter tipo de registro
planning_get_record_type
Obtém detalhes completos de um tipo de registro, incluindo seus campos e visualizações.
Ler
Criar tipos de registro
planning_create_record_types
Cria um ou mais tipos de registro em uma seção do espaço de trabalho.
Gravar
Atualizar tipo de registro
planning_update_record_type
Atualiza parcialmente o nome, a descrição, o ícone ou a cor de um tipo de registro.
Gravar
Excluir um tipo de registro
planning_delete_record_type
Exclui permanentemente um tipo de registro e todos os seus registros, campos e visualizações.
Gravar
Listar tipos de registros globais
planning_list_global_record_types
Lista todos os tipos de registro (global) definidos centralmente visíveis para o usuário atual.
Ler
Listar tipos de registros globais que podem ser adicionados
planning_list_addable_global_record_types
Lista os tipos de registro global que podem ser adicionados a um espaço de trabalho específico.
Ler
Adicionar tipo de registro global ao espaço de trabalho
planning_add_global_record_type_to_workspace
Vincula um tipo de registro global a um espaço de trabalho especificado.
Gravar
Remover tipo de registro global do espaço de trabalho
planning_remove_global_record_type_from_workspace
Desvincula um tipo de registro global de um espaço de trabalho; exclui todos os seus registros nesse espaço de trabalho.
Gravar
Obter espaços de trabalho de registro externo
planning_get_external_record_workspaces
Localiza quais espaços de trabalho e tipos de registro estão conectados a um registro externo específico.
Ler
Obter compartilhamento de tipo de registro
planning_get_record_type_sharing
Retorna o compartilhamento e as permissões de um tipo de registro específico.
Ler
Modificar compartilhamento de tipo de registro
planning_modify_record_type_sharing
Atualiza quem pode acessar um tipo de registro e em qual nível de permissão.
Gravar

Registros

Título
Nome da ferramenta
O que faz
Ação
Obter registro
planning_get_record
Recupera detalhes completos de um único registro por ID.
Ler
Pesquisar registros
planning_search_records
Pesquisa e filtra registros dentro de um tipo de registro.
Ler
Ações de registro em massa
planning_bulk_record_actions
Cria, atualiza, exclui ou restaura vários registros em uma única solicitação.
Gravar
Criar registro de conexão
planning_create_connection_record
Cria um novo registro em um sistema externo conectado (por exemplo, um projeto do Workfront).
Gravar
Atualizar ordem de registros
planning_update_records_order
Altera a ordem de exibição dos registros dentro de um tipo de registro.
Gravar
Obter log de alterações de registro
planning_get_record_change_log
Retorna o histórico de edição em nível de campo de um registro.
Ler
Obter compartilhamento de registros
planning_get_record_sharing
Retorna a configuração de compartilhamento de um registro específico.
Ler
Modificar compartilhamento de registros
planning_modify_records_sharing
Atualiza quem pode acessar um ou mais registros e em qual nível de permissão.
Gravar

Campos

Título
Nome da ferramenta
O que faz
Ação
Obter campo
planning_get_field
Recupera detalhes completos e o esquema de valor de um campo por ID.
Ler
Criar campos
planning_create_fields
Adiciona um ou mais campos (colunas) a um tipo de registro.
Gravar
Atualizar campo
planning_update_field
Atualiza parcialmente o nome, a descrição, as opções ou a configuração de um campo.
Gravar
Excluir campo
planning_delete_field
Remove permanentemente um campo e todos os seus dados de um tipo de registro.
Gravar

Exibições

Título
Nome da ferramenta
O que faz
Ação
Obter visualização
planning_get_view
Retorna detalhes completos de uma exibição por ID.
Ler
Criar visualização
planning_create_view
Cria uma nova tabela, linha do tempo ou exibição de calendário para um tipo de registro.
Gravar
Atualizar exibição
planning_update_view
Atualiza parcialmente a configuração, os filtros ou a classificação de uma visualização existente.
Gravar
Excluir visualização
planning_delete_view
Exclui permanentemente uma exibição (os registros não são afetados).
Gravar
Obter compartilhamento de visualização
planning_get_view_sharing
Retorna a configuração de compartilhamento de uma exibição específica.
Ler
Modificar compartilhamento de visualização
planning_modify_view_sharing
Atualiza quem pode acessar uma visualização e em qual nível de permissão.
Gravar

Modelos

Título
Nome da ferramenta
O que faz
Ação
Obter lista de modelos
planning_get_template_list
Lista todos os modelos de espaço de trabalho disponíveis com informações de resumo.
Ler
Obter modelo
planning_get_template
Recupera detalhes completos de um modelo específico por ID.
Ler

Busca e utilitários

Título
Nome da ferramenta
O que faz
Ação
Pesquisar recursos
planning_search_resources
Pesquisas em espaços de trabalho, tipos de registro e exibições por nome.
Ler
Pesquisar dados de compartilhamento
planning_search_sharing_data
Localiza usuários, grupos, equipes, funções e empresas por nome para compartilhamento e permissões.
Ler
Procurar usuários
planning_search_users
Pesquisa usuários com suporte à paginação.
Ler

Ferramentas de fluxo de trabalho

As ferramentas de fluxo de trabalho são ações de uso geral que a plataforma de IA usa para trabalhar com qualquer objeto do Workfront — projetos, tarefas, problemas, horas, atribuições, programas, portfólios e assim por diante.

Título
Nome da ferramenta
O que faz
Ação
Pesquisar objetos
workflow_search_any_object
Pesquisa por objetos do Workfront com parâmetros de filtro, ordenação e paginação flexíveis.
Ler
Criar objeto
workflow_create_any_object
Cria um novo objeto do Workfront, como um projeto, tarefa, problema, hora, atribuição, programa ou portfólio.
Gravar
Atualizar objeto
workflow_update_any_object
Atualiza campos em um objeto Workfront existente.
Gravar
Excluir objeto
workflow_delete_any_object
Exclui um objeto do Workfront por ID. Requer confirmação explícita do usuário antes que a ação seja executada.
Gravar
Resolver nomes de campo
workflow_resolve_field_names_any_object
Converte nomes de campo ou rótulos fornecidos pelo usuário em nomes de campo subjacentes da API do Workfront para que a plataforma do agente de IA possa criar solicitações precisas.
Ler

Como as ferramentas são atualizadas

Quando o Adobe lança uma nova versão do servidor MCP do Workfront, a plataforma de agente de IA usa o conjunto de ferramentas atualizado automaticamente. Você não precisa reconectar ou alterar nada em seu lado.

Ferramentas adicionais em breve

Estamos trabalhando para adicionar as seguintes ferramentas ao servidor MCP do Workfront no futuro:

  • Comentários
  • Quadros
recommendation-more-help
workfront-help-quicksilver