Documentação com IA, de ponta a ponta
A IA ajuda você a escrevê-la. A IA ajuda você a traduzi-la. E agora a IA pode lê-la — sua documentação publicada vira uma fonte ao vivo que os agentes e assistentes consultam diretamente.
“Documentação com IA” costumava significar uma só coisa: usar IA para escrever mais rápido. Isso continua sendo metade da história, e o OpenDocs faz bem — um Assistente de Escrita IA para redigir, um Aprimorador de Escrita IA para refinar e Traduções com IA para alcançar um público global. Mas há uma segunda metade que a maioria das ferramentas de documentação ainda não alcançou. Os assistentes de IA agora consomem documentação. Quando uma pessoa desenvolvedora pergunta ao seu agente de programação como sua API funciona, esse agente precisa de uma fonte limpa, atual e legível por máquina — não uma página web rastreada nem uma exportação desatualizada.
O OpenDocs trata as duas metades como prioridade. Você escreve com IA, localiza com IA, e seu conteúdo publicado funciona também como fonte de conhecimento consultável para agentes de IA por meio de um servidor MCP integrado. O resto desta página percorre os três pilares, por que o modelo BYOK importa para os recursos de IA e para onde vai o ecossistema de documentação legível por IA.
Escreva com IA
Assistente de Escrita IA
Comece a partir de um prompt em vez de uma página em branco. O Assistente de Escrita IA redige seções, esboços e primeiros rascunhos diretamente dentro do editor de blocos, assim você dedica seu tempo a refinar em vez de encarar uma tela vazia. Está disponível em todos os planos.
Aprimorador de Escrita IA
Refine o que você já tem. O Aprimorador de Escrita IA reescreve para dar clareza, corta o excesso e suaviza o tom — útil quando uma nota interna bruta precisa virar uma página pública polida. Você controla o que aceita.
BYOK, sem margem
As duas ferramentas de escrita são traga-sua-própria-chave. Você conecta sua própria chave de API da Anthropic, então a IA roda sobre sua conta e sua relação de dados — e o consumo é faturado pela Anthropic às suas tarifas, nunca com uma margem do OpenDocs.
Assistente de Escrita IA
Redija seções, esboços e primeiros rascunhos completos com o Claude, a IA da Anthropic, sem sair do editor de blocos. Cole sua própria chave de API da Anthropic e funciona em todos os planos — sobre sua conta, sob sua relação de dados, às tarifas próprias da Anthropic.
As ferramentas de escrita vivem onde você já trabalha: o editor de blocos do OpenDocs. Não há um console de IA à parte para o qual mudar, nem se exige conhecimento de Markdown ou git para usá-las. Uma pessoa redatora sem perfil técnico pode redigir uma página com o Assistente de Escrita, passar o Aprimorador de Escrita sobre um parágrafo desajeitado e publicar — tudo no mesmo editor visual. Como os recursos de IA são BYOK, a mesma chave impulsiona a escrita, o aprimoramento e a tradução, e você mantém uma única visão transparente do que a IA faz na sua conta da Anthropic.
Traduza com IA
38 idiomas
As Traduções com IA exibem sua documentação em até 38 idiomas. Alcance um público global sem contratar um fornecedor de localização nem montar um pipeline de tradução à parte para cada idioma que você quer servir.
Mantém-se sincronizada
As traduções não são um despejo de uma vez só. Quando você atualiza a página original, as versões traduzidas se mantêm sincronizadas com suas mudanças, então seus leitores em espanhol, japonês ou alemão não ficam com uma cópia desatualizada.
Docs globais, sua chave
Como as ferramentas de escrita, a tradução é BYOK com sua chave da Anthropic. Você obtém documentação multilíngue com o consumo faturado direto à sua conta — previsível, transparente e sem um complemento de assinatura por idioma.
A localização costuma ser o ponto onde os projetos de documentação empacam. Os fornecedores são caros, os tradutores independentes são lentos e manter em dia dezenas de páginas traduzidas conforme o produto muda é um trabalho em si. As Traduções com IA reduzem essa carga: você publica uma vez, traduz para os idiomas que seu público fala e deixa as traduções seguirem o conteúdo original conforme ele evolui. Para uma equipe pequena que atende clientes em várias regiões, isso costuma ser a diferença entre ter documentação localizada e não ter nenhuma.
Sirva sua documentação à IA
Um servidor MCP ao vivo
Cada espaço publicado é alcançável por meio do servidor MCP do OpenDocs sobre HTTP em streaming. Os agentes se conectam a um endpoint ao vivo e leem seu conteúdo publicado atual sob demanda — não uma página rastreada nem uma exportação desatualizada que você tenha que lembrar de regenerar.
Quatro ferramentas específicas
O servidor MCP expõe list_spaces, get_page_tree, get_page (o conteúdo completo da página como texto puro limpo) e search_pages. Um agente pode enumerar o que existe, percorrer a estrutura, ler uma página e buscar entre páginas.
Funciona com qualquer cliente MCP
Como fala o Model Context Protocol, funciona com qualquer cliente compatível com MCP — Claude Desktop, Claude Code e outros clientes MCP. Aponte o cliente para o seu endpoint, autentique-se com uma chave de API e sua documentação fica dentro do fluxo.
Este é o pilar que muda para que serve a documentação. Tradicionalmente, a documentação é escrita para humanos que leem em um navegador. Mas cada vez mais o leitor é um agente de IA que age em nome de uma pessoa — um assistente de suporte respondendo a um cliente, um agente de programação conectando sua API, um bot interno atendendo perguntas da sua equipe. Esses agentes trabalham melhor com uma fonte estruturada e autoritativa que possam consultar, e é exatamente isso que o servidor MCP do OpenDocs oferece.
O endpoint é protegido com uma chave de API do OpenDocs, então o acesso é controlado em vez de estar totalmente aberto. Um agente alcança apenas o conteúdo que a chave tem permissão de ver, e você pode emitir ou revogar essa chave. O resultado é que sua documentação publicada se torna uma base de conhecimento ao vivo e consultável para a IA — sem que você exporte arquivos, mantenha um banco de dados vetorial à parte ou deixe os bots rastrearem seu site e ficarem desatualizados.
Por que BYOK importa
Cada recurso de IA no OpenDocs — o Assistente de Escrita, o Aprimorador de Escrita e as Traduções com IA — é traga-sua-própria-chave. Você fornece sua própria chave de API da Anthropic, e essa única decisão tem três consequências que vale a pena entender.
Transparência de custos. Seu consumo de IA é faturado pela Anthropic diretamente à sua conta, às tarifas publicadas da Anthropic. Você pode ver, até o token, quanto custa de fato gerar e traduzir sua documentação, porque aparece na sua própria fatura em vez de estar misturado em uma taxa de plataforma opaca.
Sem margem sobre a IA. Muitas ferramentas revendem capacidade de IA com uma margem embutida, ou reservam os melhores modelos para um nível superior. O OpenDocs não faz nenhuma das duas. Como você traz sua própria chave, o OpenDocs não está no negócio de revender tokens a você — não há nada sobre o que aplicar uma margem.
Você controla a chave. A relação de dados do consumo de IA é entre você e a Anthropic, regida pelos termos da sua própria conta. Você escolhe a chave, define seus limites e pode rotacioná-la ou revogá-la. Sua relação com o provedor de IA continua sendo sua, não intermediada pelo seu provedor de documentação.
O panorama da documentação legível por IA
Tornar a documentação legível pela IA é um espaço em rápida evolução, e dois enfoques estão surgindo. Vale a pena entender ambos, porque resolvem problemas distintos.
llms.txt é uma convenção comunitária: um arquivo de texto puro em um local conhecido que aponta os sistemas de IA para as partes do site aptas para LLM, algo parecido com robots.txt ou um sitemap, mas voltado aos modelos de linguagem. É uma forma leve e estática de anunciar conteúdo. Ainda é emergente, e sua adoção entre ferramentas e rastreadores é irregular. Para ser claro, o OpenDocs não gera atualmente arquivos llms.txt para os sites publicados — mencionamos isso porque é uma parte real do ecossistema e vale a pena acompanhá-la, não porque o OpenDocs a ofereça hoje.
MCP segue o caminho interativo. Em vez de um arquivo estático que descreve o conteúdo, o Model Context Protocol dá aos agentes ferramentas ao vivo para consultar o conteúdo sob demanda — listar o que existe, percorrer a estrutura, ler uma página, executar uma busca. É a diferença entre entregar a um agente um mapa e dar a ele uma linha telefônica para ligar. Para documentação que muda, o enfoque ao vivo significa que um agente sempre vê o estado atual, nunca um instantâneo.
O OpenDocs oferece MCP hoje. Seus espaços publicados são consultáveis agora mesmo por qualquer cliente compatível com MCP, protegidos com sua chave de API. Se o llms.txt ou convenções semelhantes amadurecerem até se tornarem amplamente úteis, elas são complementares ao que o MCP já faz — mas o caminho interativo e sempre atual é o que mais importa para a documentação da qual os agentes dependem, e é o que o OpenDocs oferece agora.
Documentação tradicional vs documentação pronta para IA
| Dimensão | Documentação tradicional | Documentação pronta para IA no OpenDocs |
|---|---|---|
| Leitor principal | Humanos em um navegador | Humanos e agentes de IA |
| Como os agentes acessam o conteúdo | Rastreio de HTML, com sorte | Servidor MCP ao vivo, ferramentas estruturadas |
| Frescor para os agentes | Exportações desatualizadas ou rastreios em cache | Conteúdo publicado atual sob demanda |
| Assistência de redação | Manual, ou uma ferramenta de IA à parte | Assistente de Escrita e Aprimorador integrados |
| Localização | Fornecedor ou pipeline manual | Traduções com IA, 38 idiomas, mantêm-se sincronizadas |
| Modelo de custo de IA | Tokens agrupados ou com margem | BYOK — faturado pela Anthropic, sem margem |
| Controle de acesso para agentes | Tudo ou nada | Endpoint MCP protegido com chave de API |
Perguntas frequentes
O que é documentação com IA?
A documentação com IA abrange duas ideias relacionadas: usar IA para ajudar a produzir documentação, e tornar a documentação legível pela IA. O OpenDocs faz as duas. A IA ajuda você a escrever e traduzir páginas, e, uma vez publicada, sua documentação fica exposta a agentes de IA por meio de um servidor MCP ao vivo, para que os assistentes a leiam e busquem diretamente em vez de rastrear um site.
Preciso da minha própria chave de API para usar os recursos de IA?
Sim. O Assistente de Escrita IA, o Aprimorador de Escrita IA e as Traduções com IA são BYOK (traga sua própria chave): você conecta sua própria chave de API da Anthropic. Isso significa que a relação com a IA, os termos de dados e o faturamento do consumo ficam diretamente entre você e a Anthropic. O OpenDocs nunca aplica uma margem sobre seu consumo de IA.
Quanto custa o consumo de IA?
Como os recursos de IA são BYOK, o consumo de IA é faturado pela Anthropic na sua própria conta às tarifas publicadas da Anthropic. O OpenDocs não adiciona uma margem por token nem revende tokens. Sua assinatura do OpenDocs cobre a plataforma; sua conta da Anthropic cobre o consumo de IA, então você vê exatamente quanto custa a IA.
O que é MCP?
MCP (Model Context Protocol) é um padrão aberto que permite aos assistentes de IA conectar-se a ferramentas e fontes de dados externas. O OpenDocs executa um servidor MCP sobre HTTP em streaming que expõe seus espaços publicados a qualquer cliente compatível com MCP, como o Claude Desktop ou o Claude Code. Suas ferramentas permitem que um agente liste espaços, navegue pela árvore de páginas, leia uma página como texto puro e busque entre páginas.
Os agentes de IA podem ler minha documentação privada?
Apenas com o acesso que você conceder. O endpoint MCP do OpenDocs é protegido com uma chave de API do OpenDocs, então um agente só pode alcançar o conteúdo que essa chave tem permissão de ver. O acesso é controlado, não está aberto à internet pública, e você pode emitir e revogar a chave que os agentes usam.
O OpenDocs gera um arquivo llms.txt?
Hoje não. llms.txt é uma convenção comunitária emergente para anunciar conteúdo apto para LLM, e vale a pena acompanhá-la, mas o OpenDocs não gera atualmente arquivos llms.txt para os sites publicados. O que o OpenDocs oferece agora é o caminho interativo: um servidor MCP ao vivo que permite aos agentes consultar seu conteúdo publicado real sob demanda.