> ## 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（Model Context Protocol）サーバーを使うと、AIエージェントがあなたの代わりに`llms.txt`ファイルを生成・確認・検証できます — チャットを離れる必要はありません。

**エンドポイント**: `https://mcp.llmgenerator.com/mcp`

***

## 前提条件

LLMGeneratorのAPIキーが必要です。[APIキー設定](https://app.llmgenerator.com/settings/api-keys)から取得してください。

APIキーの形式は次のとおりです: `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`     | 任意のWebサイトURLの`llms.txt`生成を開始する |
| `get_generation_status` | ジョブが完了するまでポーリングする              |
| `list_sites`            | 生成済みのすべてのサイトを一覧表示する            |
| `get_site`              | 1つのサイトの詳細とファイル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="Webサイトの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を検出してから、どのURLを含めるか決めたい"

    エージェントは`discover_urls`を呼び出してから`get_discovered_urls`を呼び出し、URLを一覧表示します。
  </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キーごとに1分あたり60リクエスト。超過すると明確なメッセージとともに`429`エラーが返されます。

***

## クレジット使用量

MCPツールの呼び出しは、直接APIを呼び出す場合と同じクレジットを消費します:

| ツール                                    | クレジット          |
| -------------------------------------- | -------------- |
| `generate_llms_txt`（シンプル方式）            | 1クレジット         |
| `generate_llms_txt`（拡張方式）              | 2クレジット         |
| `discover_urls`（初回スキャン）                | 無料             |
| `discover_urls`（再スキャン）                 | 10URLあたり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 Unauthorized エラー">
    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>