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

# Serveur MCP

> Utilisez LLMGenerator depuis Claude, Cursor, Windsurf et tout agent compatible MCP. Générez des fichiers llms.txt sans quitter le chat.

Le serveur MCP (Model Context Protocol) de LLMGenerator permet aux agents IA de générer, analyser et valider des fichiers `llms.txt` pour vous — sans quitter la conversation.

**Point de terminaison** : `https://mcp.llmgenerator.com/mcp`

***

## Prérequis

Vous avez besoin d’une clé API LLMGenerator. Créez-en une dans les [paramètres des clés API](https://app.llmgenerator.com/settings/api-keys).

Format : `llmgen_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

***

## Configuration

<Tabs>
  <Tab title="Claude Desktop">
    Modifiez le fichier de configuration :

    * **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_votre_cle_api"
          }
        }
      }
    }
    ```

    Redémarrez Claude Desktop. Les outils LLMGenerator apparaissent sous l’icône Outils du chat.
  </Tab>

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

  <Tab title="Cursor">
    Ouvrez **Paramètres → MCP** et ajoutez un serveur :

    * **Nom** : `llmgenerator`
    * **URL** : `https://mcp.llmgenerator.com/mcp`
    * **En-têtes** : `Authorization: Bearer llmgen_votre_cle_api`
  </Tab>

  <Tab title="Windsurf">
    Ouvrez **Paramètres → IA → Serveurs MCP** et ajoutez :

    * **URL** : `https://mcp.llmgenerator.com/mcp`
    * **En-tête Authorization** : `Bearer llmgen_votre_cle_api`
  </Tab>
</Tabs>

***

## Outils disponibles

Après connexion, votre agent dispose de 9 outils :

| Outil                   | Description                                       |
| ----------------------- | ------------------------------------------------- |
| `generate_llms_txt`     | Lance la génération de `llms.txt` pour une URL    |
| `get_generation_status` | Suit la tâche jusqu’à la fin                      |
| `list_sites`            | Liste les sites générés                           |
| `get_site`              | Détails et URL de fichiers pour un site           |
| `get_llms_txt_content`  | Récupère le texte `llms.txt`                      |
| `discover_urls`         | Explore un site et découvre les URL               |
| `get_discovered_urls`   | Liste les URL d’une tâche de découverte           |
| `get_credit_balance`    | Solde de crédits et transactions récentes         |
| `validate_llms_txt`     | Valide un contenu `llms.txt` et retourne un score |

***

## Exemples de prompts

<AccordionGroup>
  <Accordion title="Générer un llms.txt pour un site">
    > «Génère un llms.txt pour stripe.com»

    L’agent appelle `generate_llms_txt`, interroge `get_generation_status` puis renvoie le résultat.
  </Accordion>

  <Accordion title="Lister et lire les fichiers">
    > «Montre mes sites générés et le contenu llms.txt du plus récent»

    L’agent utilise `list_sites` puis `get_llms_txt_content`.
  </Accordion>

  <Accordion title="Valider un llms.txt">
    > «Valide ce llms.txt et dis-moi comment l’améliorer : \[collez le contenu]»

    L’agent appelle `validate_llms_txt` (score 0–100 et suggestions).
  </Accordion>

  <Accordion title="Découvrir les URL avant génération">
    > «Découvre les URL sur docs.example.com avant que je choisisse lesquelles inclure»

    L’agent utilise `discover_urls` et `get_discovered_urls`.
  </Accordion>

  <Accordion title="Vérifier les crédits">
    > «Combien de crédits il me reste ?»

    L’agent appelle `get_credit_balance`.
  </Accordion>
</AccordionGroup>

***

## Fonctionnement

Le serveur MCP tourne sur Cloudflare Workers comme proxy devant l’API REST LLMGenerator. Votre clé est transmise à chaque requête ; le serveur MCP ne stocke pas vos données.

```
Agent IA → mcp.llmgenerator.com → api.llmgenerator.com
               (protocole MCP)         (API REST)
```

**Limite de débit** : 60 requêtes par minute et par clé API. Au-delà, réponse `429` avec un message explicite.

***

## Consommation de crédits

| Outil                                              | Crédits             |
| -------------------------------------------------- | ------------------- |
| `generate_llms_txt` (simple)                       | 1 par URL           |
| `generate_llms_txt` (améliorée)                    | 2 par URL           |
| `discover_urls` (premier scan)                     | Gratuit             |
| `discover_urls` (nouveau scan)                     | 1 crédit par 10 URL |
| Outils de lecture (`list_sites`, `get_site`, etc.) | Gratuit             |
| `validate_llms_txt`                                | Gratuit             |

***

## Dépannage

<AccordionGroup>
  <Accordion title="Les outils n’apparaissent pas">
    1. Vérifiez que l’URL est exactement `https://mcp.llmgenerator.com/mcp` (avec `/mcp`).
    2. Vérifiez que la clé commence par `llmgen_`.
    3. Redémarrez le client après enregistrement.
    4. Testez la connexion :

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

  <Accordion title="Erreur 401">
    Clé absente ou invalide. Utilisez `Authorization: Bearer llmgen_...` (avec le préfixe `Bearer `). Créez une nouvelle clé dans les [paramètres API](https://app.llmgenerator.com/settings/api-keys).
  </Accordion>

  <Accordion title="429 limite atteinte">
    Plus de 60 requêtes/minute avec la même clé. Attendez 60 secondes. Pour des limites plus élevées, [contactez-nous](mailto:llmgenerator@gmail.com).
  </Accordion>

  <Accordion title="La tâche reste sur « processing »">
    Les gros sites peuvent prendre 1–3 minutes. L’agent doit poursuivre le polling avec `get_generation_status`. Au-delà de 5 minutes, relancez une génération.
  </Accordion>
</AccordionGroup>

***

## Détails du protocole

* **Transport** : [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **Version MCP** : `2024-11-05`
* **Authentification** : en-tête `Authorization: Bearer llmgen_xxx`
* **Content-Type** : les requêtes doivent inclure `Accept: application/json, text/event-stream`

<Info>
  Une connexion OAuth 2.1 dans le navigateur est prévue pour éviter de copier manuellement la clé API.
</Info>