配置Adobe Workfront MCP服务器

Adobe Workfront MCP服务器允许您在受支持的AI代理平台上通过自然语言对话处理Workfront数据。

在将AI代理平台连接到Workfront之前,Workfront管理员必须在Workfront实例中启用MCP服务器访问。 对于每个受支持的AI代理平台,连接AI代理平台的确切步骤有所不同。

支持的AI代理平台

Workfront MCP服务器可与支持模型上下文协议(MCP)的任何AI代理平台配合使用。

本文逐步介绍的连接步骤:

  • Claude
  • ChatGPT

如果您使用其他MCP兼容的AI代理平台(例如,Gemini或Microsoft Copilot),请按照该平台文档中的步骤添加自定义MCP服务器。 当系统提示输入MCP服务器URL时,请输入:

https://mcp.workfront.adobe.com/mcp/v1/workfront

先决条件

在将Workfront连接到AI代理平台之前,您必须:

  • 拥有活动Adobe Workfront帐户,该帐户具有访问要使用的数据的权限
  • 有权访问AI代理平台,如Claude
  • 必须在Adobe Identity Management System (IMS)上启用您的Workfront实例。
  • 要将MCP与Workfront Planning结合使用,您的组织必须位于包含Adobe Workfront Planning的Workfront程序包上。

管理员先决条件

MCP服务器访问由两个不同的管理员控制。

  • 您的Workfront管理员通过系统首选项中的两个切换控制Workfront实例的MCP服务器访问:只读MCP工具(默认启用)和​写入MCP工具(默认禁用)。 如果您可以通过AI代理平台找到Workfront项目,但无法创建、更新或删除它们,请让Workfront管理员启用写入操作。

    有关详细信息,请参阅配置系统首选项

  • 如果您使用企业版AI代理平台,则该平台的管理员必须为您的组织启用Adobe Workfront连接器,或为您提供自定义URL访问权限以连接到Workfront MCP服务器。

将Workfront连接到克劳德

您为每个Claude帐户连接到Workfront一次。 该连接会向您验证特定Workfront实例,在您选择断开连接之前,您会一直保持连接。

从连接器目录连接到Claude desktop

展开以查看有关将Workfront连接到Claude的分步说明。

要将Workfront连接到Claude,请执行以下操作:

  1. 打开Claude。

  2. 单击​自定义

  3. 在左侧导航中,单击​连接器

  4. 在连接器列表中查找​Adobe Workfront

    如果您没有看到此项,请参阅本文中的管理员先决条件

  5. 单击​连接

  6. 出现提示时,登录到您的Workfront实例。 您可能需要选择配置文件和Workfront实例。 您选择的配置文件决定了连接的工作区。

    身份验证完成后,将连接Workfront MCP服务器。

使用URL连接到Claude

展开以查看使用URL将Workfront连接到Claude的分步说明。
note
NOTE
您必须是企业Claude环境中的所有者才能执行此过程。
有关Claude关于所有者要求的声明,请参阅Claude文档中的添加自定义连接器

要使用URL将Workfront连接到Claude,请执行以下操作:

  1. 使用您的凭据登录Claude

  2. 在左侧菜单中,选择​ 自定义 ​图标。

  3. 在左侧导航中选择​连接器

  4. 选择​ + ​图标,然后选择​添加自定义连接器

  5. 为连接器指定所需的名称(如“Workfront”),并输入MCP服务器URL:

    code language-none
    https://mcp.workfront.adobe.com/mcp/v1/workfront
    
  6. 单击​连接
    此时将显示Workfront登录窗口。

  7. 使用您的Adobe ID凭据进行身份验证。
    您可能需要选择配置文件和Workfront实例。您选择的配置文件决定了连接的工作区。

使用技能自定义克劳德行为

Claude支持由用户创建的称为“技能”的说明集。 您可以使用技能自定义Claude在Workfront中的行为方式。 例如,您可以创建一项技能,告知Claude始终从Workfront中获取最新数据,而不是依赖以前的结果。

要了解有关Claude技能的更多信息,请参阅Claude用户文档或向Claude寻求技能帮助。

连接到ChatGPT

将Workfront MCP服务器与ChatGPT连接的过程因您在网站上使用ChatGPT Desktop、Codex或ChatGPT而有所不同。

连接到ChatGPT桌面或ChatGPT代码

展开以查看将Workfront连接到ChatGPT Desktop或ChatGPT代码的分步说明。
  1. 在ChatGPT中,打开​设置

  2. 在左侧导航中单击​插件

  3. 单击窗口右上角附近的​添加服务器

  4. 输入服务器的名称。

  5. 对于类型,选择​可流式处理HTTP

  6. 设置MCP服务器URL:

    code language-none
    https://mcp.workfront.adobe.com/mcp/v1/workfront
    
  7. 单击​保存

  8. 在显示的列表中,为要添加的MCP服务器单击​身份验证

  9. 登录到Workfront。
    您可能需要选择配置文件和Workfront实例。您选择的配置文件决定了连接的工作区。

  10. 在ChatGPT的MCP服务器列表中,确保新MCP服务器右侧的切换保持切换状态。

连接到Web上的ChatGPT

展开以查看将Workfront连接到Web上的ChatGPT的分步说明。
  1. 使用您的凭据登录到ChatGPT

  2. 在左下方,选择您的姓名,然后选择​设置

  3. 在左侧导航中,选择​安全和登录

  4. 转到ChatGPT插件页面,网址为https://chatgpt.com/plugins。

  5. 单击“插件”页面右上角附近的加号图标。

  6. 在​ 名称 ​字段中,输入MCP服务器的名称。

  7. 在​ 连接 ​字段中,选择​ 服务器URL ​并输入MCP服务器URL:

    code language-none
    https://mcp.workfront.adobe.com/mcp/v1/workfront
    
  8. 确保将身份验证设置为​OAuth(默认设置)。

  9. 阅读风险消息并勾选方框,显示您已阅读该消息。

  10. 单击​创建

  11. 创建应用程序后,会显示Workfront登录窗口。 使用您的Adobe ID凭据进行身份验证。 您可能需要选择配置文件和Workfront实例。 您选择的配置文件决定了连接的工作区。

使用自定义GPT自定义ChatGPT行为

ChatGPT支持用户创建的称为自定义GPT的助理。 您可以使用自定义GPT自定义ChatGPT与连接器的行为方式。 例如,您可以创建一个自定义GPT,告诉ChatGPT始终从连接的服务中获取最新数据,而不是依赖以前的结果。

要了解有关自定义GPT的更多信息,请参阅ChatGPT用户文档或向ChatGPT寻求有关自定义GPT的帮助。

将Workfront连接到Copilot

展开以查看有关将Workfront连接到Copilot的分步说明。

要构建Workfront MCP可以连接的自定义Copilot代理,请使用Copilot Studio。

  1. 在Copilot Studio中,单击​创建空白代理

  2. 为代理命名,然后单击​创建
    此时将打开座席窗口。

  3. 在​ 说明 ​字段中,说明您希望代理执行的操作。 包括诸如您的流程以及如何使用Workfront等信息。 我们建议您提供大量详细信息。

  4. 在顶部导航中,单击​工具,然后单击​添加工具

  5. 选择​ 模型上下文协议 ​磁贴。

  6. 在显示的面板中,输入此连接的名称和说明。

  7. 在服务器URL字段中,输入URL:

    code language-none
    https://mcp.workfront.adobe.com/mcp/v1/workfront`
    
  8. 对于身份验证,请选择​OAuth 2.0,然后选择​动态发现

  9. 单击面板底部的​创建

    应用程序已注册。

  10. 注册应用程序后,在显示的面板中单击​未连接,然后单击​创建新连接,然后单击​创建

  11. 通过单击​未连接新建连接创建​来设置连接。

  12. 在出现的登录面板中,登录到Workfront,选择要使用的实例(如果您有权访问多个实例),然后单击​继续

  13. 在显示服务器的面板中,单击​添加并配置

    您现在可以开始为MCP服务器使用和配置工具。

  14. 配置并测试工具后,单击​发布

    您可能没有发布权限。 如果是这种情况,请联系您的Copilot管理员。

将Workfront连接到自定义MCP解决方案

如果您正在构建自己的自定义应用程序或代理,则可以直接连接到Workfront MCP服务器。

连接方式有两种:

使用服务到服务令牌连接

  1. 使用Adobe Developer Console创建服务凭据。 有关信息,请参阅服务器到服务器身份验证

  2. 使用以下信息连接到Workfront MCP服务器:

    • URLhttps://mcp.workfront.adobe.com/mcp/v1/workfront

    • 标头

      • Authorization: Bearer <access_token>
      • wf-url: <your_subdomain>.my.workfront.com (如果您的凭据有权访问多个Workfront实例,例如预览和生产,则此为必填字段)。

与OAuth连接

Workfront尚不支持自定义OAuth集成的自助服务。

验证您的连接

要确认AI代理平台已连接到Workfront,请要求AI代理平台列出Workfront MCP服务器可执行的操作。 例如:

  • 您可以执行哪些Workfront操作?
  • 列出您有权访问的Workfront工具。

您还可以在Adobe Workfront MCP服务器工具中查看完整的工具列表。

可用工具

Workfront MCP服务器公开由连接的AI代理平台代表您调用的一组工具 — 例如,用于搜索Workfront、创建项目、更新字段和管理审批的工具。 有关按Workfront区域分组的完整参考列表,请参阅Adobe Workfront MCP服务器工具

切换到其他Workfront实例

每个连接都向单个Workfront实例验证AI代理平台。 要使用其他实例,请断开并重新连接。

连接到其他Workfront实例:

  1. 在AI代理平台中,断开Workfront MCP服务器的连接。
  2. 重新连接连接器。
  3. 对新的Workfront实例进行身份验证。
NOTE
  • 仅注销不会切换Workfront实例。 必须断开并重新连接连接器。

设置和身份验证疑难解答

展开以查看有关Workfront MCP服务器的设置和身份验证的疑难解答提示。
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3
问题 可能的原因 修复
在Claude中找不到Adobe Workfront连接器。 您的Claude管理员尚未启用它。 请联系您的Claude管理员(而不是Workfront管理员),要求他们启用Adobe Workfront连接器。
您已连接,但看不到您的数据。 您使用了错误的Workfront实例进行身份验证。 断开连接器,重新连接并验证正确的实例。
身份验证失败,或连接停止工作。 您的身份验证会话已过期或存在连接错误。 断开并重新连接连接器。
您希望切换到其他Workfront实例。 单个连接会将您绑定到一个实例。 断开新实例的连接、重新连接并进行身份验证。
您无法连接到Workfront,或者您看到一条消息,表明MCP服务器访问被禁用。 您的Workfront管理员已关闭实例的MCP服务器访问。 请与Workfront管理员联系,要求他们在“系统首选项”中启用MCP服务器访问。
AI代理平台可以找到您的Workfront项目,但无法创建、更新或删除它们。 您的Workfront管理员已禁用Workfront MCP服务器的写入操作。 联系Workfront管理员,要求他们在“系统首选项”中启用写入操作。

有关连接后的日常故障排除(例如,陈旧的结果或意外行为),请参阅使用Adobe Workfront MCP服务器

有关设置的常见问题解答

展开以查看有关设置Workfront MCP服务器的常见问题解答。

我是否可以同时连接到多个Workfront实例?

不可以。 每个连接都将AI代理平台绑定到单个Workfront实例。 要切换,请断开并重新连接,对新实例进行身份验证。

由哪个管理员启用此功能?

Workfront管理员和AI代理平台管理员。 您的Workfront管理员可以在Workfront端启用MCP服务器访问。 AI代理平台的管理员可在该平台上启用Workfront访问权限。 对于Claude,Claude企业管理员启用Adobe Workfront连接器。

如果未在Workfront Identity Management System (IMS)上启用我的Workfront实例,我能否使用Adobe MCP服务器?

不可以。 必须在Adobe Identity Management System (IMS)上启用Workfront实例,才能使用Workfront MCP服务器。 如果您不确定实例是否已在IMS中启用,请与Workfront管理员联系。

recommendation-more-help
workfront-help-quicksilver