Conecte a OpenDocs
Adicione a OpenDocs ao Claude Code como servidor MCP usando uma API key da OpenDocs, criada por um Admin ou Owner da organização em Settings > API.
Transforme o repositório em que você trabalha em um site de documentação sem sair do terminal. O Claude Code lê seu código, escreve as páginas na OpenDocs como rascunhos e só publica quando você pede.
Plano gratuito para sempre. Teste Pro de 14 dias, sem cartão.
Como funciona
Peça com suas palavras. O Claude propõe uma estrutura, você confirma e as páginas chegam à OpenDocs como rascunhos. Nada vai ao ar até você mandar.
> Documente este repo na OpenDocs
Lendo README.md, CHANGELOG.md, package.json e src/
Espaço proposto: Acme CLI
Getting started visão geral, instalação, início rápido
Guides uma página por tarefa
Reference configuração, comandos da CLI
Troubleshooting erros comuns, FAQ
Crio estas páginas como rascunhos?
> Sim, pode criar
✓ list_spaces
✓ create_space Acme CLI
✓ create_page 12 rascunhos
12 rascunhos prontos para revisão. Me avise quando quiser publicar.
> Publique
✓ publish_pages
✓ publish_space
Publicado. Cada alteração fica salva no histórico da página.
Configuração
Conecte a OpenDocs, adicione o plugin e depois dê aos seus clientes uma conexão somente leitura com a documentação que você publica.
Adicione a OpenDocs ao Claude Code como servidor MCP usando uma API key da OpenDocs, criada por um Admin ou Owner da organização em Settings > API.
Adicione o marketplace do plugin da OpenDocs e depois instale o plugin. Ele dá ao Claude quatro skills de documentação que usam as ferramentas da OpenDocs.
Todo site de documentação pública em um plano pago responde MCP no seu endereço mais /mcp. Seus leitores o adicionam ao próprio Claude, somente leitura e sem login.
Passo 1: conecte a OpenDocs (troque od_YOUR_KEY pela sua API key)
claude mcp add --transport http opendocs https://app.opendocs.cloud/mcp --header "Authorization: Bearer od_YOUR_KEY"
Passo 2: dentro do Claude Code, adicione o marketplace do plugin
/plugin marketplace add P4Software/opendocs-claude-plugin
Depois instale o plugin
/plugin install opendocs@opendocs
Passo 3: o que seus leitores executam (o endereço da sua documentação mais /mcp)
claude mcp add --transport http docs https://docs.suaempresa.com/mcp
Prefere o navegador? O mesmo plugin é instalado no claude.ai em Customize > Plugins > Add > Add marketplace, e o conector da OpenDocs está no diretório de conectores do Claude em todos os planos. Veja Use a OpenDocs com o Claude.
O plugin
O plugin da OpenDocs contém apenas instruções: não armazena nada e não executa código. O Claude mostra os rascunhos antes de salvar e só publica quando você pede.
Transforma o repositório do seu diretório de trabalho em um site de documentação: primeiros passos, guias, referência e solução de problemas. Lê o README, o manifesto, a superfície pública e os testes, confirma a estrutura com você antes de escrever e nunca lê nem cita arquivos .env ou credenciais.
“Documente este repo na OpenDocs”
Publica algo da conversa, como uma política, um artigo de ajuda ou notas de versão, como página no espaço certo. Se já existir uma página sobre o mesmo assunto, oferece atualizá-la em vez de duplicar.
“Publique estas notas de versão na nossa documentação”
Escreve um procedimento operacional padrão com estrutura consistente (objetivo, escopo, papéis, passos numerados, registros, histórico de revisões) e salva na OpenDocs. O que você não confirmou fica marcado como “A confirmar”.
“Escreva um SOP para o nosso processo de release”
Revisa um espaço de documentação em busca de páginas ausentes, desatualizadas ou difíceis de usar e ordena o que corrigir primeiro. Se o seu plano inclui analytics, também verifica buscas de leitores sem resultado. Nunca exclui páginas sem confirmação explícita.
“Faça uma auditoria do nosso espaço de documentação para desenvolvedores”
Segurança
O Claude só age dentro da organização da OpenDocs à qual está conectado, e só com as permissões dessa conexão. Cada edição é salva como uma revisão da página com autoria Claude (MCP), para você ver exatamente o que mudou e restaurar qualquer versão anterior.
Antes de o Claude substituir o texto de uma página, a OpenDocs guarda uma cópia do conteúdo atual. Ferramentas que removem ou substituem conteúdo, como update_page_content, unpublish_space e delete_page, são as que o Claude pergunta antes de usar.
Conexão pelo Claude Code: as API keys exigem um plano Enterprise ou Compliance. claude.ai e Claude Desktop: o conector da OpenDocs funciona em todos os planos, inclusive o gratuito, e você faz login com OAuth. Conexão de leitura para seus clientes: em todo site de documentação pública nos planos Pro, Enterprise e Compliance, e durante o teste Pro de 14 dias; não no plano gratuito. Veja os preços para tudo o que cada plano inclui.
Não. Com a OpenDocs conectada como servidor MCP, o Claude Code já pode usar as ferramentas da OpenDocs. O plugin adiciona quatro skills que dão ao Claude uma forma consistente de documentar um repositório, publicar a partir de uma conversa, escrever SOPs e auditar um espaço de documentação.
O Claude Code se conecta com uma API key da OpenDocs, e as API keys exigem um plano Enterprise ou Compliance. Um Admin ou Owner da organização as cria em Settings > API. O conector para claude.ai e Claude Desktop funciona em todos os planos, inclusive o gratuito.
Não. O plugin cria as páginas como rascunhos, mostra primeiro a estrutura e os rascunhos, e só publica quando você pede. Cada alteração fica no histórico da página, então você pode restaurar uma versão anterior.
A skill repo-to-docs instrui o Claude a nunca ler nem citar arquivos .env, credenciais, keys, tokens ou qualquer coisa dentro de uma pasta de segredos, e a nunca colocar esses valores em uma página.
Só o que já é público: páginas publicadas em espaços públicos, somente leitura. Rascunhos e espaços não listados ou privados nunca são compartilhados. Ela vem ativada por padrão nos espaços públicos, e você pode desativá-la por espaço na seção Claude das configurações do espaço.
Sim. No claude.ai, abra Customize > Plugins > Add > Add marketplace e informe a URL do repositório do plugin. As skills funcionam com o conector da OpenDocs que você adiciona pelo diretório de conectores do Claude.
Aviso de independência: a OpenDocs é um produto independente da Grupo Barrdega. Não é afiliada nem endossada pela Anthropic. Claude e Claude Code são marcas registradas da Anthropic.
Comece no plano gratuito ou teste todos os recursos Pro por 14 dias, sem cartão. Depois de 14 dias você continua grátis em 1 espaço, ou faz upgrade.