> ## Documentation Index
> Fetch the complete documentation index at: https://starforge.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 接入

> 让 Cursor、Claude 或 Codex 读到你的作业配置、指标和日志。

MCP 把作业数据暴露给 AI 客户端，这样你可以在自己本来就在工作的地方问某次 run 的事，
而不用把日志片段复制粘贴到聊天窗口里。

<Frame caption="MCP 连接信息与各客户端配置。">
  <img src="https://mintcdn.com/starforge/GatXR2rI5-_Vm4_H/images/console/mcp.png?fit=max&auto=format&n=GatXR2rI5-_Vm4_H&q=85&s=c479f9fcb67354efbb9478fd45c016a5" alt="StarForge MCP page" width="2160" height="1350" data-path="images/console/mcp.png" />
</Frame>

## 你会看到什么

| 区域        | 显示什么                                                |
| --------- | --------------------------------------------------- |
| **连接**    | MCP 端点，走 Streamable HTTP                            |
| **配置客户端** | Cursor、Claude Desktop、Claude Code、Codex 的现成配置，可直接粘贴 |
| **可用工具**  | 你的账号允许哪些工具，以一组开关呈现                                  |

## 接入

<Steps>
  <Step title="选客户端">
    页面会给每种客户端生成对应配置：Cursor 写 `~/.cursor/mcp.json`，
    Claude Desktop 走 `mcp-remote`，Claude Code 和 Codex 用命令行添加。
  </Step>

  <Step title="保存配置，然后点 Connect">
    认证走 OAuth 2.1 + PKCE。第一次连接会打开浏览器授权，之后客户端自己持有 token。
  </Step>

  <Step title="问一个作业的事">
    工具覆盖作业配置、超参、指标和日志。
  </Step>
</Steps>

<Info>
  工具权限对你的 MCP 账号全局生效——你接入的每个客户端共用同一套。
  在这里关掉一个工具，就是在所有地方关掉它。
</Info>

## 暴露了什么，没暴露什么

默认只有读工具。写工具除非你自己打开，否则是关的；
部署还可以用 `FORGE_PREMIUM_PUBLIC` 把 MCP 完全限制为管理员专用。

MCP 客户端能看到的，就是你的账号能看到的——不多一分。它不是绕过数据集治理的办法：
受保护数据集的记录在控制台上读不到，在这里同样读不到。

<Warning>
  关闭了认证的部署会完全跳过 OAuth。那是给本地开发用的，页面在这种情况下会明确提示。
</Warning>