# 安装 SciFig MCP 服务器

将 AI 助手连接到 SciFig。服务器 URL：https://mcp.scifig.ai/mcp。概览：https://scifig.ai/zh/mcp。参考文档：https://scifig.ai/zh/docs/api/mcp。

## 执行安装的 AI 代理规则

- 仅当用户要求使用 SciFig 时安装，不要自行添加。
- 选择当前所用客户端对应的步骤。无法自行修改配置时，请向用户提供确切步骤。
- 不要索要用户密码。OAuth 客户端在浏览器中登录；使用 API 密钥时，请用户在设置 → 开发者中创建密钥，并自行粘贴到配置中。
- 调用免费的 `get_credit_balance` 检查连接，不要为了测试而创建插图。
- 仅报告实际观察到的内容：可见的工具及 `get_credit_balance` 的结果。

## MCP 服务器

服务器 URL：`https://mcp.scifig.ai/mcp`（Streamable HTTP）。支持 OAuth 的客户端通过登录 SciFig 并批准访问连接；可发送请求头的客户端可使用 API 密钥，格式为 `Authorization: Bearer sk_live_…`。

| 工具 | 功能 |
| --- | --- |
| generate_figure | 根据提示词创建科研插图 |
| edit_figure | 编辑图像：指令（可选蒙版区域）、白色背景、宽高比、重新配色或文字替换 |
| detect_text | 替换前识别图中的文字 |
| upscale_figure | 放大到 2K、4K 或 8K |
| convert_figure | 转换为 SVG、PNG、PDF、TIFF 或 PPTX |
| generate_chart | 根据 CSV、TSV 文本或 JSON 行数据绘制图表（最大 1 MB） |
| edit_chart | 修改图表的最新版本 |
| generate_flowchart | 绘制 SVG 流程图，也可基于最多 8 个附件 |
| edit_flowchart | 修改流程图的最新版本 |
| get_job | 任务状态、积分和下载链接 |
| list_figures | 最近的任务 |
| get_credit_balance | 积分余额、档位和限制 |

创建工具最多等待 25 秒。任务仍运行时，请稍后调用 `get_job`；再次调用创建工具会新建并扣费一个任务。结果列出每个下载链接，图表和流程图还包含在 SciFig 编辑器中打开结果的链接。

创建工具会在下载附件前检查 `figures:generate` 权限范围。只读连接可读取任务和积分，但无法创建插图。

## 连接客户端

Claude（claude.ai 和 Claude Desktop）：设置 → 连接器 → 添加自定义连接器，输入服务器 URL，再登录 SciFig 并允许访问。

ChatGPT：设置 → 应用 → 高级 → 开发者模式，使用服务器 URL 和 OAuth 鉴权创建应用。

Claude Code：

```bash
claude mcp add --transport http scifig https://mcp.scifig.ai/mcp
```

Codex (`~/.codex/config.toml`):

```toml
[mcp_servers.scifig]
url = "https://mcp.scifig.ai/mcp"
```

Cursor（`~/.cursor/mcp.json`），使用在设置 → 开发者中创建的 API 密钥：

```json
{
  "mcpServers": {
    "scifig": {
      "url": "https://mcp.scifig.ai/mcp",
      "headers": { "Authorization": "Bearer sk_live_…" }
    }
  }
}
```

不支持 OAuth 的客户端，可使用设置 → 开发者中的 API 密钥添加请求头 `Authorization: Bearer sk_live_…`。