模型上下文协议 (MCP)

模型上下文协议 (MCP) 是一个让 LLM 与开发环境交互的标准。MCP 使 Claude、Claude Code 以及 Zed、Cursor 或 VS Code 等编辑器能够与外部服务和数据源互操作。

Tuist 在 https://tuist.dev/mcp 托管了一个服务端 MCP 端点。通过将你的 MCP 客户端连接到它，AI 代理可以访问你的 Tuist 项目数据，包括测试洞察、flaky 测试分析等。

MCP 与 Skills

MCP 和 Skills 在功能上可能有重叠。鉴于两者之间目前存在重叠，建议每个工作流选择一种方法并一致使用（要么 MCP 要么 skills），而不是在同一个流程中混合使用两者。

在你的客户端中添加 https://tuist.dev/mcp 作为远程 MCP 服务器。认证通过 OAuth 自动进行。MCP 端点使用 mcp 作用域组，授予对你所有项目的只读访问权限。详细信息请参阅作用域组文档。

::: details Claude Code 运行：

claude mcp add --transport http tuist https://tuist.dev/mcp

:::

::: details Claude Desktop 打开 设置 → 连接器 → 添加自定义连接器，然后设置：

出现提示时在浏览器中完成 OAuth。 :::

::: details OpenCode 将 Tuist MCP 服务器添加到 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tuist": {
      "type": "remote",
      "url": "https://tuist.dev/mcp"
    }
  }
}

然后对服务器进行身份验证：

opencode mcp auth tuist

:::

::: details Cursor 打开 Cursor 设置 → 工具和集成 → MCP 工具 并添加：

::: details VS Code 使用 命令面板 → MCP：添加服务器，然后配置一个 HTTP 服务器：

::: details Zed 打开 代理面板 → 设置 → 添加自定义服务器，然后设置：

以下工具可通过 Tuist MCP 服务器使用：

工具	描述	必需参数
`list_projects`	列出已认证用户可访问的所有项目。	无

工具	描述	必需参数
`list_xcode_builds`	列出项目的 Xcode 构建运行。	`account_handle`, `project_handle`
`get_xcode_build`	获取特定 Xcode 构建运行的详细信息。接受构建 ID 或 Tuist 仪表板 URL。	`build_run_id`
`list_xcode_build_targets`	列出特定 Xcode 构建运行的构建目标。	`build_run_id`
`list_xcode_build_files`	列出特定 Xcode 构建运行编译的文件。	`build_run_id`
`list_xcode_build_issues`	列出特定构建运行的构建问题（警告和错误）。	`build_run_id`
`list_xcode_build_cache_tasks`	列出特定 Xcode 构建运行的可缓存任务（缓存命中/未命中）。	`build_run_id`
`list_xcode_build_cas_outputs`	列出特定 Xcode 构建运行的 CAS（内容寻址存储）输出。	`build_run_id`

工具	描述	必需参数
`list_gradle_builds`	列出项目的 Gradle 构建运行。	`account_handle`, `project_handle`
`get_gradle_build`	获取特定 Gradle 构建运行的详细信息。	`build_run_id`
`list_gradle_build_tasks`	列出特定 Gradle 构建运行的任务，包括结果和缓存状态。	`build_run_id`

工具	描述	必需参数
`list_test_runs`	列出项目的测试运行。	`account_handle`, `project_handle`
`get_test_run`	获取测试运行的详细指标。	`test_run_id`
`list_test_module_runs`	列出特定测试运行的测试模块运行。	`test_run_id`
`list_test_suite_runs`	列出特定测试运行的测试套件运行，可按模块过滤。	`test_run_id`
`list_test_cases`	列出项目的测试用例（支持按 `flaky` 等过滤）。	`account_handle`, `project_handle`
`get_test_case`	获取测试用例的详细指标，包括可靠性率、flaky 率和运行次数。	`test_case_id` 或 `identifier` + `account_handle` + `project_handle`
`list_test_case_runs`	列出测试用例运行，可按测试用例或测试运行过滤。	`account_handle`, `project_handle`
`get_test_case_run`	获取特定测试用例运行的失败详情和重复次数。	`test_case_run_id`
`list_test_case_run_attachments`	列出测试用例运行的附件。每个附件包含一个临时下载 URL。	`test_case_run_id`

工具	描述	必需参数
`list_bundles`	列出项目的 bundle（应用二进制文件）。	`account_handle`, `project_handle`
`get_bundle`	获取特定 bundle 的详细信息。	`bundle_id`
`get_bundle_artifact_tree`	获取 bundle 的完整工件树，作为按路径排序的扁平列表。	`bundle_id`

工具	描述	必需参数
`list_generations`	列出项目的生成运行。	`account_handle`, `project_handle`
`get_generation`	获取特定生成运行的详细信息。	`generation_id`

工具	描述	必需参数
`list_cache_runs`	列出项目的缓存运行。	`account_handle`, `project_handle`
`get_cache_run`	获取特定缓存运行的详细信息。	`cache_run_id`
`list_xcode_module_cache_targets`	列出生成或缓存运行的模块缓存目标，显示每个目标的缓存命中/未命中状态。	`run_id`

提示词	描述
`fix_flaky_test`	通过分析失败模式、识别根本原因并应用针对性修复，引导你完成修复 flaky 测试的过程。
`compare_builds`	引导你完成比较两次构建运行以识别性能回归、缓存变化和构建问题的过程。适用于 Xcode 和 Gradle 项目。
`compare_test_runs`	引导你完成比较两次测试运行以识别回归、新失败和 flaky 测试的过程。
`compare_bundles`	引导你完成比较两个 bundle 以识别整个工件树中的大小变化的过程。
`compare_test_case`	引导你完成跨两个分支或时间段比较测试用例行为的过程。
`compare_generations`	引导你完成比较两次生成运行以识别性能回归和模块缓存变化的过程。
`compare_cache_runs`	引导你完成比较两次缓存运行以识别缓存效果变化和目标级回归的过程。

所有提示词都接受 account_handle 和 project_handle 将调查范围限定到特定项目。比较提示词还接受 base 和 head 参数来指定要比较的两个项目（通过 ID、仪表板 URL 或分支名称）。