Integração com agentes

Conecte um cliente MCP#

O endpoint público é https://rogueon.ai/mcp. Escolha Streamable HTTP no cliente MCP. A leitura da documentação não exige chave de API, conta, OAuth ou assinatura de modelo. Deixe o cliente negociar o protocolo; o endpoint aceita o protocolo 2026-07-28 e clientes compatíveis de 2025.

No Cursor, acrescente a entrada abaixo ao .cursor/mcp.json do projeto, preservando servidores existentes. Recarregue a configuração MCP e confirme a presença de list_docs, search_docs e get_doc. Outros editores podem usar um formato de configuração diferente para o mesmo endpoint.

{
  "mcpServers": {
    "rogue-docs": {
      "url": "https://rogueon.ai/mcp"
    }
  }
}

• Referência de configuração MCP do Cursor

Claude Code#

Execute no projeto em que quer disponibilizar a documentação. O comando registra o servidor remoto; não gera nem publica um app. Use /mcp no Claude Code para inspecionar a conexão. Se rogue-docs já estiver configurado, confira ou atualize essa entrada em vez de criar uma duplicata.

claude mcp add --transport http rogue-docs https://rogueon.ai/mcp

• Referência HTTP MCP do Claude Code

Contrato das ferramentas#

Todas as ferramentas aceitam locale: en ou pt-br, com padrão en. Os resultados incluem URLs de referência. Recursos Markdown também são descobertos por resources/list e lidos por resources/read.

{
  "slug": "project-architecture",
  "locale": "pt-br",
  "section": "runtime-services"
}

Busque → leia → verifique#

1. 01

   Encontre a fonte relevante

   Use search_docs com uma consulta específica. A busca exige correspondência de todas as palavras, ignora acentos e retorna trechos; um trecho não é a referência completa.

2. 02

   Leia a menor seção suficiente

   Use o slug do documento e o ID da seção em get_doc. Omita section quando precisar do contexto completo. Preserve as condições sobre formato, runtime e disponibilidade ao resumir.

3. 03

   Preserve a fonte e a revisão

   Cite a URL canônica retornada e guarde o SHA-256 junto do contexto em cache. Confira o manifesto antes de reutilizar conteúdo antigo. O hash identifica conteúdo, não uma versão do produto ou data de atualização.

Antes de alterar um projeto gerado pela Rogue:
1. Identifique o formato real do artefato pelos arquivos.
2. Busque nas docs o contrato de runtime ou exportação relevante.
3. Leia a seção com get_doc e preserve a URL canônica.
4. Separe comportamento documentado de premissas sobre este projeto.
5. Implemente a alteração solicitada e valide os critérios de aceite.
6. Relate fonte, arquivos alterados, validação e dependências pendentes.

Consulte Markdown por HTTP#

Cada artigo tem uma URL explícita terminada em /markdown. HTML e Markdown são gerados da mesma fonte; a resposta Markdown declara a URL HTML canônica. Esse caminho funciona com um cliente HTTP comum quando MCP não está disponível ou não é necessário.

curl -fsSL https://rogueon.ai/pt-br/docs/project-architecture/markdown

• Arquitetura · Markdown

Use o hash do conteúdo no cache#

O manifesto JSON usa schemaVersion: 1 e lista slug, url, markdownUrl, sha256, quantidade de bytes e IDs de seção. O hash do documento corresponde ao corpo exato da resposta Markdown em UTF-8; hashes de seção correspondem ao Markdown daquela seção. O ETag HTTP identifica a representação do manifesto e aceita If-None-Match com resposta 304.

curl -fsS -D - https://rogueon.ai/pt-br/docs/manifest.json

• Abrir manifesto da documentação

Descoberta e corpus completo#

llms.txt é o índice compacto de descoberta. llms-full.txt reúne os guias públicos nos dois idiomas. Prefira uma página ou seção nas consultas comuns; use o corpus completo quando uma tarefa offline precisar de cobertura ampla. Esses arquivos são recursos de descoberta, não regras de permissão de crawler nem garantia de ingestão.

• llms.txt
• llms-full.txt

Transporte, limites e escopo#

As ferramentas apenas leem conteúdo e não chamam modelos de linguagem. Seu agente de código continua tendo consumo e permissões próprios. Um Origin explícito de navegador precisa estar na lista aceita pelo servidor; clientes MCP de servidor podem conectar sem esse cabeçalho. Confira configuração e erros de protocolo antes de repetir, em vez de acrescentar credenciais que esse endpoint não exige.