> ## 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-Server

> Verwenden Sie LLMGenerator direkt aus Claude, Cursor, Windsurf und jedem MCP-kompatiblen KI-Agenten. Generieren Sie llms.txt-Dateien, ohne den Chat zu verlassen.

Der LLMGenerator MCP-Server (Model Context Protocol) ermöglicht es KI-Agenten, `llms.txt`-Dateien in Ihrem Namen zu generieren, zu prüfen und zu validieren — ohne den Chat zu verlassen.

**Endpunkt**: `https://mcp.llmgenerator.com/mcp`

***

## Voraussetzungen

Sie benötigen einen LLMGenerator API-Schlüssel. Erstellen Sie einen in Ihren [API-Schlüssel-Einstellungen](https://app.llmgenerator.com/settings/api-keys).

Ihr Schlüssel hat folgendes Format: `llmgen_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

***

## Einrichtung

<Tabs>
  <Tab title="Claude Desktop">
    Bearbeiten Sie die Konfigurationsdatei:

    * **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_ihr_api_schlüssel"
          }
        }
      }
    }
    ```

    Starten Sie Claude Desktop neu. Die LLMGenerator-Tools erscheinen unter dem Tools-Symbol im Chat.
  </Tab>

  <Tab title="Claude Code CLI">
    ```bash theme={null}
    claude mcp add llmgenerator \
      --url https://mcp.llmgenerator.com/mcp \
      --header "Authorization: Bearer llmgen_ihr_api_schlüssel"
    ```
  </Tab>

  <Tab title="Cursor">
    Öffnen Sie **Einstellungen → MCP** und fügen Sie einen neuen Server hinzu:

    * **Name**: `llmgenerator`
    * **URL**: `https://mcp.llmgenerator.com/mcp`
    * **Headers**: `Authorization: Bearer llmgen_ihr_api_schlüssel`
  </Tab>

  <Tab title="Windsurf">
    Öffnen Sie **Einstellungen → KI → MCP-Server** und fügen Sie hinzu:

    * **URL**: `https://mcp.llmgenerator.com/mcp`
    * **Authorization-Header**: `Bearer llmgen_ihr_api_schlüssel`
  </Tab>
</Tabs>

***

## Verfügbare Tools

Nach der Verbindung hat Ihr KI-Agent Zugriff auf 9 Tools:

| Tool                    | Beschreibung                                                            |
| ----------------------- | ----------------------------------------------------------------------- |
| `generate_llms_txt`     | `llms.txt`-Generierung für eine beliebige Website-URL starten           |
| `get_generation_status` | Einen Auftrag abfragen, bis er abgeschlossen ist                        |
| `list_sites`            | Alle Ihre generierten Websites auflisten                                |
| `get_site`              | Details und Datei-URLs für eine Website abrufen                         |
| `get_llms_txt_content`  | Den tatsächlichen `llms.txt`-Textinhalt abrufen                         |
| `discover_urls`         | Eine Website crawlen und URLs entdecken                                 |
| `get_discovered_urls`   | Die URL-Liste aus einem Erkennungsauftrag abrufen                       |
| `get_credit_balance`    | Credits-Guthaben und aktuelle Transaktionen prüfen                      |
| `validate_llms_txt`     | Beliebige `llms.txt`-Inhalte validieren und Qualitätspunktzahl erhalten |

***

## Beispiel-Prompts

Nach der Verbindung können Sie Ihren KI-Agenten auf natürliche Weise befragen:

<AccordionGroup>
  <Accordion title="llms.txt für eine Website generieren">
    > „Generiere eine llms.txt-Datei für stripe.com"

    Der Agent ruft `generate_llms_txt` auf, fragt `get_generation_status` ab, bis der Vorgang abgeschlossen ist, und gibt das Ergebnis zurück.
  </Accordion>

  <Accordion title="Vorhandene Dateien auflisten und lesen">
    > „Zeig mir alle meine generierten Websites und rufe den llms.txt-Inhalt der neuesten ab"

    Der Agent ruft `list_sites` und dann `get_llms_txt_content` auf.
  </Accordion>

  <Accordion title="llms.txt-Inhalt validieren">
    > „Validiere dieses llms.txt und sage mir, wie ich es verbessern kann: \[Inhalt einfügen]"

    Der Agent ruft `validate_llms_txt` auf und gibt eine Punktzahl (0–100) mit konkreten Vorschlägen zurück.
  </Accordion>

  <Accordion title="Website-URLs vor der Generierung entdecken">
    > „Entdecke die URLs auf docs.example.com, bevor ich entscheide, welche ich einbeziehe"

    Der Agent ruft `discover_urls` und dann `get_discovered_urls` auf und listet sie auf.
  </Accordion>

  <Accordion title="Credits prüfen">
    > „Wie viele Credits habe ich noch?"

    Der Agent ruft `get_credit_balance` auf und zeigt Ihr Guthaben und die letzte Nutzung an.
  </Accordion>
</AccordionGroup>

***

## Funktionsweise

Der MCP-Server läuft auf Cloudflare Workers und fungiert als schlanker Proxy über der LLMGenerator REST API. Ihr API-Schlüssel wird mit jeder Anfrage weitergeleitet — der Server selbst speichert nichts.

```
KI-Agent → mcp.llmgenerator.com → api.llmgenerator.com
               (MCP-Protokoll)         (REST API)
```

**Ratenlimits**: 60 Anfragen pro Minute pro API-Schlüssel. Bei Überschreitung wird ein `429`-Fehler mit einer klaren Meldung zurückgegeben.

***

## Credits-Verbrauch

MCP-Tool-Aufrufe verbrauchen dieselben Credits wie direkte API-Aufrufe:

| Tool                                            | Credits              |
| ----------------------------------------------- | -------------------- |
| `generate_llms_txt` (einfache Methode)          | 1 Credit             |
| `generate_llms_txt` (erweiterte Methode)        | 2 Credits            |
| `discover_urls` (erster Scan)                   | Kostenlos            |
| `discover_urls` (erneuter Scan)                 | 1 Credit pro 10 URLs |
| Alle Lese-Tools (`list_sites`, `get_site` usw.) | Kostenlos            |
| `validate_llms_txt`                             | Kostenlos            |

***

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Tools werden in meinem KI-Client nicht angezeigt">
    1. Bestätigen Sie, dass die URL genau `https://mcp.llmgenerator.com/mcp` lautet (beachten Sie den `/mcp`-Pfad)
    2. Prüfen Sie, ob Ihr API-Schlüssel mit `llmgen_` beginnt
    3. Starten Sie Ihren KI-Client nach dem Speichern der Konfiguration neu
    4. Testen Sie die Verbindung direkt:

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

  <Accordion title="401 Unauthorized-Fehler">
    Ihr API-Schlüssel fehlt oder ist ungültig. Stellen Sie sicher, dass der `Authorization`-Header auf `Bearer llmgen_ihr_schlüssel` gesetzt ist — einschließlich des `Bearer `-Präfixes. Holen Sie sich einen neuen Schlüssel in den [API-Schlüssel-Einstellungen](https://app.llmgenerator.com/settings/api-keys).
  </Accordion>

  <Accordion title="429 Ratenlimit überschritten">
    Sie haben mit demselben API-Schlüssel mehr als 60 Anfragen pro Minute gesendet. Warten Sie 60 Sekunden und versuchen Sie es erneut. Wenn Sie höhere Limits benötigen, [kontaktieren Sie uns](mailto:llmgenerator@gmail.com).
  </Accordion>

  <Accordion title="Generierungsauftrag bleibt bei 'processing' stehen">
    Die Generierung kann bei großen Websites 1–3 Minuten dauern. Der Agent sollte `get_generation_status` automatisch weiter abfragen. Wenn er mehr als 5 Minuten hängt, versuchen Sie eine Neugenerierung.
  </Accordion>
</AccordionGroup>

***

## Protokoll-Details

Für Entwickler, die den MCP-Server programmatisch integrieren:

* **Transport**: [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) (zustandslos, keine Sitzungen)
* **Protokollversion**: MCP `2024-11-05`
* **Authentifizierung**: `Authorization: Bearer llmgen_xxx`-Header
* **Content-Type**: Anfragen müssen `Accept: application/json, text/event-stream` enthalten

<Info>
  OAuth 2.1 Browser-basiertes Login ist auf der Roadmap. Wenn verfügbar, können Sie sich verbinden, ohne manuell einen API-Schlüssel kopieren zu müssen.
</Info>
