> ## 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 等 AI Agent 经 MCP 读取作业数据辅助调参

MCP（Model Context Protocol）把作业配置、超参、指标、日志、验证样本暴露给你的 AI 编程助手——在 Cursor / Claude 里直接问「分析 job xxx 的 reward 曲线，建议怎么调 lr 和 KL」。

## 配置步骤

<Steps>
  <Step title="打开 MCP 页">
    控制台 → **MCP**（`/mcp`）。
  </Step>

  <Step title="复制客户端配置">
    选择你的客户端（Cursor / Claude / VS Code 等），复制生成的 JSON snippet 到客户端 MCP 配置。
  </Step>

  <Step title="OAuth 授权">
    客户端 Connect 时自动跳浏览器完成 OAuth 2.1 + PKCE 授权，无需手动填 token。
  </Step>

  <Step title="开始提问">
    <br />

    ```text theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
    分析 job lab-grpo-20260816 的 reward 曲线与 KL，
    对比同项目上一个 run，给出下一步调参建议。
    ```
  </Step>
</Steps>

## 工具与权限

MCP 页可逐个开关工具。**读工具**默认开放；**写工具**默认关闭，需显式启用。

| 类别       | 工具                                                                                                                             |
| -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| 作业观测     | `list_jobs` `get_job` `get_metrics` `get_metrics_summary` `get_logs` `get_hardware` `get_environment` `get_validation_samples` |
| 配置与对比    | `get_job_config` `get_hyperparams` `compare_jobs` `get_job_diagnosis` `get_project_memory` `list_projects`                     |
| 平台能力     | `list_methods`（方法目录与超参声明）`get_benchmarks`（基准分数矩阵）`get_sweep`（sweep 变体对比）`list_servings`（Playground 服务）                         |
| 写操作（默认关） | `stop_job` `submit_job`（改参重提）`create_submit_plan`（写入审批队列）                                                                      |

<Warning>
  启用写工具意味着你的 AI Agent 可以真实提交作业（走完整配额与校验，且平台会先生成提交计划供确认）。团队共享环境请谨慎开放。
</Warning>

## 端点与协议

* 传输：Streamable HTTP MCP（[协议 2026-07-28](https://modelcontextprotocol.io/specification/2026-07-28)）
* 双时代：同一端点同时服务新客户端（无握手，`server/discover`）与 2025-11-25 及更早的 `initialize` 客户端
* 鉴权：OAuth 2.1 + PKCE。优先 [Client ID Metadata Documents](https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization/client-registration)；Dynamic Client Registration 仍作为兼容回退。授权码重定向带 RFC 9207 `iss`（`FORGE_NO_AUTH=1` 本机调试模式下跳过鉴权）

控制台路径：`/mcp`