# 安裝 SciFig MCP 伺服器

將 AI 助手連線到 SciFig。伺服器 URL：https://mcp.scifig.ai/mcp。概覽：https://scifig.ai/zh-Hant/mcp。參考文件：https://scifig.ai/zh-Hant/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_…`。