> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmgenerator.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 서버

> Claude, Cursor, Windsurf 및 MCP 호환 AI 에이전트에서 직접 LLMGenerator를 사용하세요. 채팅을 떠나지 않고 llms.txt 파일을 생성하세요.

LLMGenerator MCP(모델 컨텍스트 프로토콜) 서버를 사용하면 AI 에이전트가 채팅을 떠나지 않고 대신 `llms.txt` 파일을 생성, 검사, 검증할 수 있습니다.

**엔드포인트**: `https://mcp.llmgenerator.com/mcp`

***

## 사전 조건

LLMGenerator API 키가 필요합니다. [API 키 설정](https://app.llmgenerator.com/settings/api-keys)에서 발급받으세요.

키 형식은 다음과 같습니다: `llmgen_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

***

## 설정

<Tabs>
  <Tab title="Claude Desktop">
    설정 파일을 편집하세요:

    * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows / Linux**: `~/.config/claude/claude_desktop_config.json`

    ```json theme={null}
    {
      "mcpServers": {
        "llmgenerator": {
          "url": "https://mcp.llmgenerator.com/mcp",
          "headers": {
            "Authorization": "Bearer llmgen_당신의_API_키"
          }
        }
      }
    }
    ```

    Claude Desktop을 재시작하세요. 채팅의 도구 아이콘 아래에 LLMGenerator 도구가 표시됩니다.
  </Tab>

  <Tab title="Claude Code CLI">
    ```bash theme={null}
    claude mcp add llmgenerator \
      --url https://mcp.llmgenerator.com/mcp \
      --header "Authorization: Bearer llmgen_당신의_API_키"
    ```
  </Tab>

  <Tab title="Cursor">
    **설정 → MCP**를 열고 새 서버를 추가하세요:

    * **이름**: `llmgenerator`
    * **URL**: `https://mcp.llmgenerator.com/mcp`
    * **헤더**: `Authorization: Bearer llmgen_당신의_API_키`
  </Tab>

  <Tab title="Windsurf">
    **설정 → AI → MCP 서버**를 열고 추가하세요:

    * **URL**: `https://mcp.llmgenerator.com/mcp`
    * **Authorization 헤더**: `Bearer llmgen_당신의_API_키`
  </Tab>
</Tabs>

***

## 사용 가능한 도구

연결 후 AI 에이전트는 9가지 도구에 접근할 수 있습니다:

| 도구                      | 설명                            |
| ----------------------- | ----------------------------- |
| `generate_llms_txt`     | 모든 웹사이트 URL의 `llms.txt` 생성 시작 |
| `get_generation_status` | 완료될 때까지 작업 상태 폴링              |
| `list_sites`            | 생성된 모든 사이트 목록 조회              |
| `get_site`              | 한 사이트의 세부 정보와 파일 URL 가져오기     |
| `get_llms_txt_content`  | 실제 `llms.txt` 텍스트 내용 가져오기     |
| `discover_urls`         | 사이트를 크롤링하여 URL 검색             |
| `get_discovered_urls`   | 검색 작업에서 URL 목록 가져오기           |
| `get_credit_balance`    | 크레딧 잔액 및 최근 거래 내역 확인          |
| `validate_llms_txt`     | `llms.txt` 내용을 검증하고 품질 점수 받기  |

***

## 예시 프롬프트

연결 후 AI 에이전트에게 자연스럽게 요청할 수 있습니다:

<AccordionGroup>
  <Accordion title="웹사이트의 llms.txt 생성">
    > "stripe.com의 llms.txt 파일을 생성해줘"

    에이전트가 `generate_llms_txt`를 호출하고, 완료될 때까지 `get_generation_status`를 폴링한 후 결과를 반환합니다.
  </Accordion>

  <Accordion title="기존 파일 목록 보기 및 읽기">
    > "내가 생성한 모든 사이트를 보여주고, 가장 최근 것의 llms.txt 내용을 가져와줘"

    에이전트가 `list_sites`를 호출한 후 `get_llms_txt_content`를 호출합니다.
  </Accordion>

  <Accordion title="llms.txt 내용 검증">
    > "이 llms.txt를 검증하고 개선 방법을 알려줘: \[내용 붙여넣기]"

    에이전트가 `validate_llms_txt`를 호출하고 구체적인 제안과 함께 점수(0–100)를 반환합니다.
  </Accordion>

  <Accordion title="생성 전 사이트 URL 검색">
    > "docs.example.com의 URL을 검색하고 어떤 것을 포함할지 결정할게"

    에이전트가 `discover_urls`를 호출한 후 `get_discovered_urls`를 호출하여 목록을 보여줍니다.
  </Accordion>

  <Accordion title="크레딧 확인">
    > "크레딧이 얼마나 남았어?"

    에이전트가 `get_credit_balance`를 호출하여 잔액과 최근 사용량을 보여줍니다.
  </Accordion>
</AccordionGroup>

***

## 작동 방식

MCP 서버는 Cloudflare Workers에서 실행되며 LLMGenerator REST API 위의 얇은 프록시로 작동합니다. API 키는 각 요청과 함께 전달되며 — 서버 자체는 아무것도 저장하지 않습니다.

```
AI 에이전트 → mcp.llmgenerator.com → api.llmgenerator.com
                  (MCP 프로토콜)           (REST API)
```

**속도 제한**: API 키당 분당 60개 요청. 초과 시 명확한 메시지와 함께 `429` 오류가 반환됩니다.

***

## 크레딧 사용량

MCP 도구 호출은 직접 API 호출과 동일한 크레딧을 소모합니다:

| 도구                                    | 크레딧             |
| ------------------------------------- | --------------- |
| `generate_llms_txt` (단순 방식)           | 크레딧 1개          |
| `generate_llms_txt` (향상된 방식)          | 크레딧 2개          |
| `discover_urls` (첫 번째 스캔)             | 무료              |
| `discover_urls` (재스캔)                 | URL 10개당 크레딧 1개 |
| 모든 읽기 도구 (`list_sites`, `get_site` 등) | 무료              |
| `validate_llms_txt`                   | 무료              |

***

## 문제 해결

<AccordionGroup>
  <Accordion title="AI 클라이언트에 도구가 표시되지 않음">
    1. URL이 정확히 `https://mcp.llmgenerator.com/mcp`인지 확인하세요 (`/mcp` 경로 주의)
    2. API 키가 `llmgen_`으로 시작하는지 확인하세요
    3. 설정 저장 후 AI 클라이언트를 재시작하세요
    4. 연결을 직접 테스트하세요:

    ```bash theme={null}
    curl -s -X POST https://mcp.llmgenerator.com/mcp \
      -H "Accept: application/json, text/event-stream" \
      -H "Authorization: Bearer llmgen_당신의_키" \
      -H "Content-Type: application/json" \
      -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
    ```
  </Accordion>

  <Accordion title="401 인증 오류">
    API 키가 없거나 유효하지 않습니다. `Authorization` 헤더가 `Bearer llmgen_your_key`로 설정되어 있는지 확인하세요 — `Bearer ` 접두사 포함. [API 키 설정](https://app.llmgenerator.com/settings/api-keys)에서 새 키를 발급받으세요.
  </Accordion>

  <Accordion title="429 속도 제한 초과">
    같은 API 키로 1분 내에 60개 이상의 요청을 보냈습니다. 60초 후에 다시 시도하세요. 더 높은 한도가 필요하다면 [문의해주세요](mailto:llmgenerator@gmail.com).
  </Accordion>

  <Accordion title="생성 작업이 'processing' 상태에서 멈춤">
    대용량 사이트의 경우 생성에 1–3분이 걸릴 수 있습니다. 에이전트가 자동으로 `get_generation_status`를 계속 폴링해야 합니다. 5분 이상 멈춰 있다면 재생성을 시도하세요.
  </Accordion>
</AccordionGroup>

***

## 프로토콜 세부 정보

MCP 서버를 프로그래밍 방식으로 통합하는 개발자를 위한 정보:

* **전송**: [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) (상태 없음, 세션 없음)
* **프로토콜 버전**: MCP `2024-11-05`
* **인증**: `Authorization: Bearer llmgen_xxx` 헤더
* **Content-Type**: 요청에 `Accept: application/json, text/event-stream` 포함 필수

<Info>
  OAuth 2.1 브라우저 기반 로그인이 로드맵에 포함되어 있습니다. 출시되면 API 키를 수동으로 복사하지 않고도 연결할 수 있습니다.
</Info>