连接适配器
将 MCP 适配器指向 Semaphore 实例，使用具备预期允许权限的 API 令牌。
还在手动搭建自动化？
助手可以协助编写脚本，但创建模板、设置输入和安排作业仍需要切换界面、重复提供上下文。
在同一次对话中操作 Semaphore
通过 MCP 从 AI 客户端配置 Semaphore、启动任务和查看结果。可以访问的资源和操作由配置的 API 身份决定。
配置自动化管理项目、模板、输入和计划
执行工作在 Semaphore 中启动或停止任务
分析结果查看任务输出与项目活动
将 Semaphore 连接到 Claude Code
连接一次后，即可从 Claude Code 操作 Semaphore。MCP 适配器向客户端提供调用 Semaphore API 的工具。
添加到 Claude Code
在 MCP 客户端中注册适配器，您可用的工具将出现在 Claude Code 中。
操作您的自动化
使用已启用的工具和权限创建模板、更新输入、安排作业或排查运行。
用一次失败运行试试看
“查找我项目中最近失败的任务，读取输出，并建议接下来检查什么。不要更改任何内容。”
适配器与客户端可以访问什么
围绕失败运行提出更有效的问题
助手可以将任务输出与适配器提供的相关模板和项目信息联系起来。有效的交互应指明任务，询问证据支持哪些结论，并区分问题诊断与拟议变更。工具覆盖范围随适配器版本而异，请确认所需的读取操作确实可用。
了解助手使用谁的权限
文档所述 MCP 适配器中，已配置的 SEMAPHORE_API_TOKEN 始终优先于客户端提供的令牌。如果没有该全局令牌，HTTP 请求可以转发各客户端的 Bearer 令牌。共享令牌意味着共享权限与 API 身份，无法可靠地将操作归因于使用助手的具体个人。
为变更设置明确的边界
适配器既包含读取工具，也包含修改工具。即使通过聊天发起，执行任务或修改模板仍属于运维操作。人工确认由客户端和工作流设计决定，MCP 本身不会强制要求确认。应从低风险排查开始，测试行为后再扩大允许的操作范围。
决定任务上下文可以发送到哪里
自托管 Semaphore 可以控制服务运行的位置，但不能阻止助手客户端将返回的日志或元数据发送给模型提供商。启用连接之前，应审查客户端和模型部署，避免含密钥的输出，并决定哪些上下文可以离开网络。
文档与相关功能
FAQ
MCP 集成是 Semaphore 内置的 AI 助手吗？
此处的配置使用独立 MCP 适配器与 Semaphore REST API 通信，并非内置的官方助手。适配器将受支持的操作提供给兼容客户端，对话体验则由客户端和模型提供。连接之前，请审查适配器的工具列表、身份验证和部署模型，因为其功能与维护状态可能独立于 Semaphore 版本变化。
助手使用哪位用户的权限？
它使用适配器实际选择的 API 令牌所对应的身份。在文档所述适配器实现中，已配置的全局 SEMAPHORE_API_TOKEN 优先于客户端令牌。如果没有该全局令牌，HTTP 模式可以转发每个客户端的 Bearer 令牌。因此，共享令牌意味着共享权限和 API 身份，并不能可靠地将操作归因于与助手对话的具体个人。在添加多个用户之前，请有意识地选择部署模式。
能从只读的任务排查开始吗？
可以，但应通过 Semaphore 身份和经过验证的适配器及客户端配置落实预期边界。聊天中要求“不要修改”，不能替代对底层令牌权限的限制。从具体任务和获取上下文、输出所需的读取操作开始。在将集成扩展到运维操作之前，先检查助手的解释是否符合返回的证据。
任务日志可能被发送到外部模型提供商吗？
可能会，具体取决于助手客户端和模型部署。自托管 Semaphore 决定应用在哪里运行，但不能阻止已连接客户端将返回的上下文转发到其他位置。请审查完整数据路径，包括日志、元数据、适配器托管和模型处理。任务输出可能包含敏感值，因此启用连接之前，应决定允许暴露的内容，并选择合适的凭据和项目访问权限。
关于失败的 Ansible 任务，可以向助手提什么问题？
从任务标识符开始，请助手通过适配器支持的工具读取状态和输出。助手可以根据返回的证据解释失败步骤并建议检查项。请对照原始任务日志核实建议，尤其是在更改 Playbook、凭据或目标基础设施之前。
MCP 会替代 Semaphore UI 或 REST API 吗？
不会。MCP 适配器使用 Semaphore REST API，将受支持的操作提供给兼容的助手客户端。任务仍在 Semaphore 中执行，结果也记录于此。您可以在 Web UI 中打开原始任务，独立于对话或模型解释查看输出。
能将现有 Semaphore 项目与适配器一起使用吗？
可以，前提是配置的 API 身份能够访问该项目，并且适配器支持所需操作。先选择一个已知任务，检查读取工具返回的信息。仅为通过集成查看现有执行记录，无需重写 Playbook 或脚本。
助手会自动修复或重新运行失败作业吗？
排查任务本身并不会重新执行或修复自动化。适配器可能提供修改工具，因此可用操作取决于其版本、客户端配置和 API 权限。请通过底层身份的权限确保所需的只读访问，并在允许任何执行操作之前核对具体项目和任务。