# 문서 MCP

문서를 코딩 어시스턴트에 연결하세요. 연동 코드를 작성할 때 기억에 의존해 추측하는 대신 최신 파라미터, 요금, 오류 코드를 직접 찾아봅니다.

> https://nezhagate.com/ko/docs/integrations/docs-mcp

## 할 수 있는 일

아래 주소의 읽기 전용 MCP 서버입니다. API 키가 필요 없고, 공개 문서만 제공하며 계정에는 전혀 접근하지 않습니다.

| 도구 | 기능 |
| --- | --- |
| `search_docs` | 키워드로 문서를 검색합니다. 가이드, 모든 모델 문서, 엔드포인트, 연동, 자주 묻는 질문에서 찾아 제목과 링크를 돌려줍니다. |
| `read_doc` | 문서 페이지 하나를 Markdown으로 읽습니다. 예: /en/docs/api, /en/docs/nano-banana-2, /en/docs/guide/errors. |
| `list_models` | 판매 중인 모든 모델의 ID, 제공사, 분류, 가격, 문서 링크를 나열합니다. |

MCP`https://nezhagate.com/mcp`

전송 방식은 Streamable HTTP(MCP 2025-06-18, 2025-03-26과 2024-11-05도 호환)이며, 응답은 일반 JSON이고 세션을 유지하지 않습니다.

## Claude Code

터미널에서 아래 명령을 실행하면 다음에 시작하는 Claude Code 세션부터 쓸 수 있습니다.

```
claude mcp add --transport http nezhagate-docs https://nezhagate.com/mcp
```

Claude Code에서 `/mcp`를 입력하면 nezhagate-docs가 연결되었는지 확인할 수 있습니다.

## Cursor

`~/.cursor/mcp.json`(전역) 또는 프로젝트의 `.cursor/mcp.json`에 다음을 추가하세요:

```
{
  "mcpServers": {
    "nezhagate-docs": { "url": "https://nezhagate.com/mcp" }
  }
}
```

## VS Code

프로젝트의 `.vscode/mcp.json`에 다음을 추가하세요:

```
{
  "servers": {
    "nezhagate-docs": { "type": "http", "url": "https://nezhagate.com/mcp" }
  }
}
```

Streamable HTTP 방식의 MCP를 지원하는 다른 클라이언트도 같은 주소로 쓸 수 있습니다.

## 이렇게 물어보세요

- nezhagate 문서를 확인해 줘. Nano Banana 2는 어떤 비율과 해상도를 지원해? 16:9 2K 이미지를 만드는 Python 스크립트를 작성해 줘.

- nezhagate-docs에서 영상 작업의 상태와 오류 코드를 찾아서, 내 코드에 주기적 상태 조회와 실패 처리를 추가해 줘.

- nezhagate의 모든 Claude 모델과 가격을 나열하고, 코딩을 잘하면서 저렴한 모델을 하나 추천해 줘.

## 터미널에서 테스트하기

클라이언트를 설치하지 않고도 바로 호출할 수 있습니다:

```
curl https://nezhagate.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "search_docs", "arguments": {"query": "webhook"}}}'
```

IP당 분당 최대 120회까지 요청할 수 있으며, 넘으면 429가 돌아옵니다.