MCP（模型上下文协议）是一种开放标准，允许 AI 应用通过通用协议连接到外部工具和数据源。 通过 Revizto MCP 服务器可以将 AI 工具安全地连接到您的 Revizto 项目数据。 连接后，您可以直接向所选的 AI 助手提问、获取项目洞察，并按照指导执行操作。

• 要求
• 连接参数
• Revizto MCP 服务器 URL
• 设置 MCP 连接
• 限制
• 最佳实践
• 故障排除

另请参阅：

• Revizto 开发者门户

要求

在连接到 Revizto MCP 服务器之前，请确认您具备以下条件：

• 能够访问存储您项目数据的 Revizto 地区。
• 能够访问可连接到远程 MCP 服务器的受支持 AI 工具。
• 您所在地区的 Revizto MCP 服务器 URL。

您还需要确保为您的组织账户启用 Revizto MCP Server 应用，然后才能将服务器添加到您的 AI 工具中。 要检查您的账户是否已启用 Revizto MCP Server 应用：

• 账户所有者和账户管理员：前往“管理账户信息 > 开发者门户”。
• 标准用户：前往“账户信息 > 应用集成”。

如果 Revizto MCP Server 应用未处于活动状态，请让账户所有者或管理员将其激活。 账户所有者和账户管理员可按照 Revizto 开发者门户中的步骤在开发者门户启用 Revizto MCP Server 应用。

为确保您的 Revizto 数据安全，请始终遵循您组织的内部安全策略。

• 仅在您信任的 AI 工具中连接到 Revizto MCP 服务器。
• 使用正确的地区 Revizto MCP 服务器 URL。
• 确保写入操作基于审核机制。 让 AI 助手先显示计划的更改，然后再应用更改。
• Revizto MCP 服务器使用您的 Revizto 访问权限。 管理操作需要管理员级 Revizto 访问权限。
• 遵循您组织的 AI 使用策略。 在连接 Revizto 数据之前，确认哪些 AI 工具已获批准。

连接参数

Revizto MCP 服务器使用 Streamable HTTP 进行连接。 尽管不同 AI 平台中的具体字段名称可能有所不同，但主要的连接要求是相同的。 此外，一些基于云的 AI 工具将 MCP 服务器设置为自定义连接器。 为了简化身份验证流程，Revizto MCP 使用 OAuth 客户端 ID。 

在设置连接时，请参考表格中的参数值。 

对于配置文件，请使用以下标准 Streamable HTTP 结构，并替换为您所在地区的 URL：

{
  "mcpServers": {
    "<您的服务器名称>": {
      "type": "http",
      "url": "https://api.<服务器地区>.revizto.com/mcp",
      "oauth": {
        "clientID": "revizto-mcp"
      }
    }
  }
}

Revizto MCP 服务器 URL

将 AI 工具连接到 Revizto MCP 服务器时，您需要使用您的 Revizto 数据所在地区的 MCP 服务器 URL。

如果您有多个 Revizto 账户托管在不同的地区，可以在同一 AI 工具中添加多个 Revizto MCP 服务器。 添加您使用的每个地区的 MCP 服务器 URL，然后授权每个连接。 之后，您可以让 AI 助手在连接的地区之间协同工作，例如比较问题计数、总结项目风险，或准备跨地区的协调简报。

这使得 AI 工具能够在一次对话中合并来自多个授权地区连接的数据。 Revizto 数据仍保留在其原始地区，且助手只能访问您的 Revizto 用户被允许访问的账户、许可证和项目。

设置 MCP 连接

Revizto MCP Server 是使用 HTTPS 的远程 MCP 服务器。 在要求选择传输类型的工具中，使用 Streamable HTTP 或远程 MCP 服务器。

设置步骤因工具而异，但典型流程是：

1. 打开工具的设置。
2. 在设置中找到连接器、应用、MCP、工具或集成。
3. 添加新的自定义连接器、自定义应用或 MCP 服务器。
4. 找到 URL 设置，并提供您所在地区的 Revizto MCP 服务器 URL。
5. 找到 OAuth 客户端 ID 字段，并提供 Revizto MCP 客户端 ID。
6. 将 OAuth 客户端密钥留空。
7. 保存连接。
8. 当系统要求您进行身份验证时，登录您的 Revizto 账户。
9. 让 AI 助手列出可用的 Revizto 工具或确认连接。

根据 AI 工具的不同，在您添加 MCP 服务器后或发送第一个需要 Revizto 数据的提示词后，您可能立即被要求登录 Revizto 账户。 身份验证开始时，您的 AI 工具将打开一个 Revizto 登录窗口。 使用您的 Revizto 账户所需的身份验证方法登录，例如电子邮件和密码或者 SSO。

授权完成后，AI 工具仅获得已通过身份验证的 Revizto 用户的访问权限。 这意味着它将遵循该用户的账户、许可证和项目的访问权限，并且只能使用允许该用户访问的数据和操作。

以下各节提供了流行 AI 工具的更多设置详情。

{
  "servers": {
    "<您的服务器名称>": {
      "type": "http",
      "url": "https://api.<服务器地区>.revizto.com/mcp",
      "oauth": {
        "clientId": "Revizto MCP"
      }
    }
  }
}

要确认设置是否正确生效，请使用以下提示词： 

检查我的 Revizto MCP 连接。 告诉我你可以访问哪个 Revizto 账户和地区，然后用通俗易懂的语言列出可用的 Revizto 工具。

如果 AI 助手表示无法访问 Revizto，请检查以下各项：

• 已为您的账户激活 Revizto MCP Server。 标准账户成员可以查看应用集成。 账户所有者和管理员可以查看开发者门户。
• 您使用了正确的区域 URL。
• 您完成了 Revizto OAuth 登录。
• 您的 AI 工具支持远程 MCP 服务器。
• 您的 Revizto 用户有权访问您所询问的账户、许可证和项目。

限制

尽管 Revizto MCP 服务器覆盖了许多协调工作流，但目前仍有一些限制需要注意。

• 模型和对象属性不会通过 MCP 公开，包括对象搜索、更改的元素、对象属性读取以及问题到对象的推理。 （即将推出！）
• 屏幕截图和图像不会通过 MCP 公开。
• 事件订阅和 Webhook 不会通过 MCP 公开。
• 项目、许可证和账户日志不会通过 MCP 公开。
• 模型导入和导出不会通过 MCP 公开。
• 大型项目可能需要仔细筛选，以避免 AI 响应缓慢或成本过高。
• 某些 AI 工具会限制同时可用的 MCP 工具数量。 如果缺少工具，请在您的 AI 工具中禁用未使用的 MCP 服务器或未使用的工具。

最佳实践

Revizto MCP 服务器设置完成后，您的 AI 助手可以使用 Revizto 工具读取协调数据，例如问题、评论、碰撞、图纸、报告、工作流、图章模板、许可证、项目和用户。 根据您的访问权限和最终版本配置，助手还可能帮助准备或应用选定的更新。

Revizto MCP 适用于三种工作流。

大型项目可能包含大量数据。 先从明确的提示词开始，然后进行后续提问。 这可以使 AI 工具的回答更迅速、更清晰，并且在按 Token 计费的模式下降低成本。

为了获得更好的结果，请遵循以下建议：

• 从一个项目、专业、分区或责任人开始。
• 在要求提供长列表之前，先询问计数和摘要。
• 让助手显示其使用的筛选器。
• 先要求提供前 10 个示例，然后根据需要再扩展。
• 对于写入操作，在提示词中包含“在应用更改之前等待批准”。
• 对于大型项目，避免一次性询问所有问题、评论、碰撞和图纸的提示词。
• 如果结果看起来出乎意料，请让助手显示其使用的源记录。

要开始使用，请尝试以下建议的提示词： 

• <项目名称> 中有多少张图纸？
• <项目名称> 中有多少个关键且未完成的问题？
• 在 <项目名称> 中，将 <用户 a> 的未完成问题重新分配给 <用户 b>，并在评论中注明“由 <用户 a> 重新分配”。 
• 关闭 <用户 a> 在 <项目名称> 中创建超过 30 天的已解决问题。
• 将 <用户 a> 在 <项目名称> 中的未完成问题的截止日期设置为下周五。
• 将 <用户 a> 在 <项目名称> 中的未完成问题移至“进行中”。 
• 将 <用户 a> 在 <项目名称> 中的“管道系统与结构”未完成问题设置为关键。

故障排除

问：AI 工具无法连接到 Revizto MCP 服务器。 

答：确认地区 URL 是否正确，以及 AI 工具是否支持远程 MCP 服务器。 

问：我有多个使用不同 SSO 身份验证方法的 Revizto 账户，但 MCP 服务器没有连接到所有这些账户。 如何对这些账户执行身份验证？

答：Revizto MCP Server 只能使用最近一次授权流程中所用的身份验证方法来访问账户。 要使用其他身份验证方法对账户授权，请转到 Revizto Workspace 中的个人资料，然后转到“活动会话 > API”并授权所需账户。

问：AI 工具要求我重新登录。 

答：完成 Revizto 登录流程。 如果您有多个使用不同 SSO 身份验证方法的 Revizto 账户，请在 Revizto Workspace 的个人资料中授权所需账户，然后转到“活动会话 > API”。

问：AI 助手看不到某个项目。

答：确认已为您的账户激活 Revizto MCP Server 应用，您已登录到项目的正确地区，并且通过身份验证的 Revizto 用户有权访问该项目。 如果需要激活 Revizto MCP Server，请在 AI 工具中重新进行身份验证，以确保该账户可通过 MCP 访问。 

问：某些工具不可用。

答：您的 AI 工具可能限制了活动工具的数量，或者您可能没有在 Revizto 中使用这些工具的相应权限。 

问：写入操作失败。 

答：确认您的 Revizto 角色允许在您要写入的账户、许可证或项目中执行该操作。 

问：响应很慢或成本太高。 

答：按项目、日期、状态、责任人、分区或优先级计数限制来缩小提示词范围。 请参阅最佳实践以获取更多建议。