# SciFig MCP サーバーのインストール

AI アシスタントを SciFig に接続します。サーバー URL：https://mcp.scifig.ai/mcp。概要：https://scifig.ai/ja/mcp。リファレンス：https://scifig.ai/ja/docs/api/mcp。

## インストールを行うエージェントへの規則

- ユーザーが 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_…` ヘッダーを追加できます。