# SciFig MCP 서버 설치

AI 어시스턴트를 SciFig에 연결합니다. 서버 URL: https://mcp.scifig.ai/mcp. 개요: https://scifig.ai/ko/mcp. 참조 문서: https://scifig.ai/ko/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_…` 헤더를 추가할 수 있습니다.