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

# Servidor MCP

> Use o LLMGenerator diretamente no Claude, Cursor, Windsurf e qualquer agente de IA compatível com MCP. Gere arquivos llms.txt sem sair do chat.

O servidor MCP (Model Context Protocol) do LLMGenerator permite que agentes de IA gerem, inspecionem e validem arquivos `llms.txt` em seu nome — sem sair do chat.

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

***

## Pré-requisitos

Você precisa de uma chave de API do LLMGenerator. Obtenha uma nas [configurações de Chaves de API](https://app.llmgenerator.com/settings/api-keys).

Sua chave terá este formato: `llmgen_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

***

## Configuração

<Tabs>
  <Tab title="Claude Desktop">
    Edite o arquivo de configuração:

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

    Reinicie o Claude Desktop. As ferramentas do LLMGenerator aparecerão no ícone de ferramentas do chat.
  </Tab>

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

  <Tab title="Cursor">
    Abra **Configurações → MCP** e adicione um novo servidor:

    * **Nome**: `llmgenerator`
    * **URL**: `https://mcp.llmgenerator.com/mcp`
    * **Headers**: `Authorization: Bearer llmgen_sua_chave_aqui`
  </Tab>

  <Tab title="Windsurf">
    Abra **Configurações → AI → Servidores MCP** e adicione:

    * **URL**: `https://mcp.llmgenerator.com/mcp`
    * **Header de autorização**: `Bearer llmgen_sua_chave_aqui`
  </Tab>
</Tabs>

***

## Ferramentas disponíveis

Após a conexão, seu agente de IA terá acesso a 9 ferramentas:

| Ferramenta              | Descrição                                                                |
| ----------------------- | ------------------------------------------------------------------------ |
| `generate_llms_txt`     | Inicia a geração de um `llms.txt` para qualquer URL de site              |
| `get_generation_status` | Consulta o status de um job até que seja concluído                       |
| `list_sites`            | Lista todos os seus sites gerados                                        |
| `get_site`              | Obtém detalhes e URLs de arquivo para um site                            |
| `get_llms_txt_content`  | Busca o conteúdo de texto do `llms.txt`                                  |
| `discover_urls`         | Rastreia um site e descobre suas URLs                                    |
| `get_discovered_urls`   | Obtém a lista de URLs de um job de descoberta                            |
| `get_credit_balance`    | Verifica seu saldo de créditos e transações recentes                     |
| `validate_llms_txt`     | Valida qualquer conteúdo `llms.txt` e fornece uma pontuação de qualidade |

***

## Exemplos de prompts

Após a conexão, você pode perguntar ao agente de forma natural:

<AccordionGroup>
  <Accordion title="Gerar llms.txt para um site">
    > "Gere um arquivo llms.txt para stripe.com"

    O agente chamará `generate_llms_txt`, consultará `get_generation_status` até concluir e retornará o resultado.
  </Accordion>

  <Accordion title="Listar e ler arquivos existentes">
    > "Mostre todos os meus sites gerados e busque o conteúdo do llms.txt do mais recente"

    O agente chama `list_sites` e depois `get_llms_txt_content`.
  </Accordion>

  <Accordion title="Validar conteúdo llms.txt">
    > "Valide este llms.txt e me diga como melhorá-lo: \[cole o conteúdo]"

    O agente chama `validate_llms_txt` e retorna uma pontuação (0–100) com sugestões específicas.
  </Accordion>

  <Accordion title="Descobrir URLs do site antes de gerar">
    > "Descubra as URLs em docs.example.com antes de eu decidir quais incluir"

    O agente chama `discover_urls` e depois `get_discovered_urls` e lista as URLs para você.
  </Accordion>

  <Accordion title="Verificar créditos">
    > "Quantos créditos ainda tenho?"

    O agente chama `get_credit_balance` e mostra seu saldo e uso recente.
  </Accordion>
</AccordionGroup>

***

## Como funciona

O servidor MCP roda no Cloudflare Workers e atua como um proxy leve sobre a API REST do LLMGenerator. Sua chave de API é encaminhada com cada requisição — o servidor em si não armazena nada.

```
Agente de IA → mcp.llmgenerator.com → api.llmgenerator.com
                  (protocolo MCP)          (API REST)
```

**Limites de taxa**: 60 requisições por minuto por chave de API. Exceder esse limite retorna um erro `429` com uma mensagem clara.

***

## Uso de créditos

As chamadas de ferramentas MCP consomem os mesmos créditos que as chamadas diretas à API:

| Ferramenta                                                       | Créditos              |
| ---------------------------------------------------------------- | --------------------- |
| `generate_llms_txt` (método simples)                             | 1 crédito             |
| `generate_llms_txt` (método aprimorado)                          | 2 créditos            |
| `discover_urls` (primeira varredura)                             | Gratuito              |
| `discover_urls` (nova varredura)                                 | 1 crédito por 10 URLs |
| Todas as ferramentas de leitura (`list_sites`, `get_site`, etc.) | Gratuito              |
| `validate_llms_txt`                                              | Gratuito              |

***

## Solução de problemas

<AccordionGroup>
  <Accordion title="Ferramentas não aparecem no meu cliente de IA">
    1. Confirme que a URL é exatamente `https://mcp.llmgenerator.com/mcp` (observe o caminho `/mcp`)
    2. Verifique se sua chave de API começa com `llmgen_`
    3. Reinicie o cliente de IA após salvar a configuração
    4. Teste a conexão diretamente:

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

  <Accordion title="Erro 401 Unauthorized">
    Sua chave de API está ausente ou inválida. Verifique se o header `Authorization` está definido como `Bearer llmgen_sua_chave` — incluindo o prefixo `Bearer `. Obtenha uma nova chave nas [configurações de Chaves de API](https://app.llmgenerator.com/settings/api-keys).
  </Accordion>

  <Accordion title="429 Limite de taxa excedido">
    Você fez mais de 60 requisições em um minuto com a mesma chave de API. Aguarde 60 segundos e tente novamente. Se precisar de limites maiores, [entre em contato](mailto:llmgenerator@gmail.com).
  </Accordion>

  <Accordion title="Job de geração travado em 'processing'">
    A geração pode levar de 1 a 3 minutos para sites grandes. O agente deve continuar consultando `get_generation_status` automaticamente. Se ficar travado por mais de 5 minutos, tente regenerar.
  </Accordion>
</AccordionGroup>

***

## Detalhes do protocolo

Para desenvolvedores que integram o servidor MCP programaticamente:

* **Transporte**: [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) (sem estado, sem sessões)
* **Versão do protocolo**: MCP `2024-11-05`
* **Autenticação**: header `Authorization: Bearer llmgen_xxx`
* **Content-Type**: as requisições devem incluir `Accept: application/json, text/event-stream`

<Info>
  O login via navegador com OAuth 2.1 está no roadmap. Quando disponível, você poderá conectar sem copiar manualmente uma chave de API.
</Info>