Docsbook
Visão geral

Servidor MCP para documentação: o que é e por que ele vence

O Protocolo de Contexto de Modelo (MCP) é o padrão de conector que a Anthropic lançou no final de 2024. Até meados de 2026, ele é suportado pelo Claude Code, Cursor, ChatGPT e uma lista crescente de agentes. Para documentação, o MCP transforma seus documentos de um ativo exclusivo da web em uma superfície programática que os agentes de IA podem ler e agir.

Este post explica o que é o MCP, quais ferramentas um servidor MCP de documentos expõe e como o Docsbook entrega um.

TL;DR#

  • MCP = forma padrão para agentes de IA chamarem ferramentas externas
  • Um servidor MCP de docs expõe ferramentas como get_analytics, update_branding, set_chat_hooks
  • Agentes descobrem capacidades, solicitam OAuth e, em seguida, chamam ferramentas como parte de seu trabalho
  • Docsbook fornece um servidor MCP gerenciado em docsbook.io/api/mcp/server
  • Este é agora um canal de distribuição de IA primário — Mintlify mediu agentes de codificação de IA em 45,3% das solicitações para os sites de docs que hospeda em março de 2026, Claude Code em 25,2% e Cursor em 18,0% (fonte)

O que é realmente o MCP#

O MCP é um protocolo JSON-RPC sobre HTTP (ou stdio). Um agente se conecta a um servidor MCP, pergunta "quais ferramentas você tem?", recebe um esquema tipado e chama ferramentas. A autenticação é OAuth 2.0 com PKCE.

A maneira mais simples de pensar sobre isso: API REST + OAuth + um endpoint de descoberta + ferramentas em vez de recursos.

Por que a documentação se beneficia do MCP#

Três fluxos de trabalho:

1. Lendo documentos como dados estruturados#

Sem o MCP, um agente busca uma página HTML, a analisa e espera que a estrutura esteja intacta. Com markdown-lsp rodando localmente (npx markdown-lsp <subcommand> ./docs), o agente analisa o gráfico do documento no disco e recebe Markdown ou JSON limpo sem uma viagem de rede.

Isso significa que os agentes:

  • Conhecem o índice completo antes de ler
  • Podem ler seções individuais em vez de páginas completas
  • Veem links cruzados como arestas de gráfico, não como correspondências de regex
  • Obtêm metadados estáveis em relação à versão

2. Editando a configuração de docs a partir do agente#

Um usuário no Claude Code pode dizer "defina a cor de destaque dos meus docs para roxo da marca e adicione um link do Discord no rodapé." O agente chama update_branding e update_navigation no servidor MCP. Sem troca de painel, sem copiar e colar, sem edição de markdown.

3. Consultando a análise de documentos de dentro do agente#

"Quais páginas tiveram as buscas mais falhadas na semana passada?" — o agente chama get_failed_searches, vê a lista e se oferece para redigir o conteúdo faltante ali mesmo.

Quais ferramentas um bom servidor MCP de documentação expõe#

O servidor MCP do Docsbook expõe ferramentas nessas categorias. A lista completa é retornada pelo próprio servidor na conexão — a tabela abaixo é a forma, não o inventário:

Categoria Exemplos
Espaço de trabalho list_workspaces, get_workspace, create_workspace
Conteúdo e documentação search_docs, get_doc_outline, write_docs
Branding update_branding, update_ui_settings, update_navigation
Configurações de IA update_ai_settings, set_chat_system_prompt, set_chat_hooks
SEO e domínio update_seo, update_domain
Tradução update_languages, set_translation_mode, approve_translation
Analytics get_analytics, get_ai_questions, get_failed_searches, get_negative_feedback, get_top_visitors, get_visitor_activity
Webhooks register_webhook_*, list_webhook_deliveries, test_webhook
Habilidades find_skill (consulta o catálogo de habilidades)

Conectando do Claude Code#

mcp add --transport http https://docsbook.io/api/mcp/server

O fluxo OAuth é aberto no navegador, você autoriza, as ferramentas aparecem no Claude Code. Sem chaves de API para gerenciar, sem arquivo de configuração para editar.

Cursor usa o mesmo servidor MCP com uma UX semelhante. ChatGPT e Gemini estão adicionando suporte HTTP MCP até 2026.

Ferramentas no estilo LSP são a metade subestimada (plugin local, não hospedado MCP)#

A maioria da marketing de docs MCP foca em leitura/escrita — no caso do Docsbook, search_docs para encontrar seções citáveis, get_doc_outline para ver o título de cada página, contagem de cabeçalhos e tamanho antes de pesquisar ou escrever, e write_docs para confirmar alterações (bloqueado pelo consentimento OAuth: o cliente escolhe o escopo somente leitura ou leitura-escrita ao autorizar a conexão). O maior valor para os agentes é a superfície de busca e navegação no estilo LSP — mas para um repositório funcional, essa superfície é melhor entregue como um plugin local Claude Code do que como uma ferramenta MCP hospedada. A análise local no disco é mais rápida, mais barata e não requer que os documentos sejam publicados ainda.

O Docsbook entrega isso via markdown-lsp — execute localmente e o agente ganha:

  • doc_outline — hierarquia de cabeçalhos para uma página (sem corpos)
  • doc_search_symbols — subsequência difusa sobre todos os cabeçalhos ("oaf" → "fluxo OAuth")
  • doc_search_text — texto completo com trechos e linha/coluna exatas
  • doc_search_links_to — referências de entrada (LSP references)
  • doc_resolve_link — link relativo ou wiki → URL absoluta do GitHub com âncora
  • doc_definition — page#anchor → posição exata da fonte

LSP — Protocolo de Servidor de Linguagem — é o que alimenta ir-para-definição, encontrar-referências e busca de símbolos no VS Code. O plugin aplica o mesmo modelo à sua árvore de documentos local, assim um agente navega com precisão semelhante à de um IDE. O servidor MCP hospedado permanece focado em operações de espaço de trabalho (branding, análises, webhooks, traduções) onde a nuvem realmente possui os dados.

Por que este é um canal de distribuição real#

Três sinais de 2025–2026:

  1. Telemetria da Mintlify. A Mintlify mediu 30 dias de tráfego nos sites de documentação que hospeda — aproximadamente 790 milhões de solicitações — e relatou que agentes de codificação de IA representaram 45,3% de todas as solicitações, com Claude Code em 25,2% e Cursor em 18,0% (O estado do tráfego de agentes na documentação, publicado em 3 de abril de 2026). Sua medição de acompanhamento colocou a participação dos agentes em 66% do tráfego em julho de 2026 (relatório semestral de 2026, publicado em 29 de julho de 2026). Essa é a frota de um fornecedor em vez de toda a web, mas é a maior medição publicada do tráfego de agentes para documentação.
  2. Dogfooding da Anthropic. A própria documentação da Anthropic e os docs do Claude Code são primeiro MCP.
  3. O lado do cliente já está construído. Claude Code, Cursor e ChatGPT oferecem suporte a MCP, então o conector não precisa de adoção do lado do leitor — apenas do seu.

Se você constrói para desenvolvedores e seu público usa Claude Code ou Cursor, o MCP não é mais uma infraestrutura opcional.

O que custa construir você mesmo#

Um servidor MCP razoável requer:

  • Transporte HTTP + estrutura JSON-RPC
  • Código de autorização OAuth 2.0 + fluxo PKCE
  • Definições de ferramentas com esquemas tipados
  • Análise de gráfico de documentos para ferramentas de leitura — geralmente entregue como uma ferramenta CLI local como markdown-lsp em vez de um endpoint hospedado, porque a análise local em disco é mais rápida e barata
  • Acesso de gravação se você quiser edições de configuração
  • Limitação de taxa e registro de auditoria

Cerca de 4 a 6 semanas de engenharia se você nunca fez isso antes. O servidor MCP da Docsbook vem com o espaço de trabalho e não custa nada para rodar; markdown-lsp é gratuito e de código aberto para as ferramentas de leitura do gráfico de documentos.

A Docsbook envia um servidor MCP gerenciado com OAuth, então Claude Code e Cursor leem e editam seus documentos sem que você precise rodar nada. Os detalhes de conexão estão em docsbook.io/mcp.

Comece grátis — sem cartão de crédito

Próximos passos#

Updated

Esta página foi útil?

Desenvolvido por Docsbook