Fontes

Uma fonte do Docsbook é um repositório ou site do qual sua documentação tem permissão para ler. Conecte uma, e pedir ao assistente para atualizar a documentação ou resolver a divergência começa com ele acessando e lendo — em vez de responder com base no que ele por acaso se lembra sobre seu produto.

Abra a seção Fontes do painel de administração do seu projeto, diretamente abaixo de MCP e Prompts.

O que posso conectar como fonte?#

As fontes do Docsbook vêm em cinco tipos — Seu projeto, Plataformas de documentação, Bases de conhecimento, Código e APIs e Comunidade — e a maioria delas se conecta colando um endereço. Um site de documentação publicado é um site, independentemente de quem o criou, portanto Mintlify, GitBook, ReadMe, Docusaurus, Read the Docs e os demais não exigem nenhuma configuração específica por fornecedor.

A seção é uma tabela com todos os tipos de fonte que o Docsbook conhece — Seu projeto, Plataformas de documentação, Bases de conhecimento, Código e APIs e Comunidade — filtrados por meio de um menu de Filtros, em vez de divididos em seções agrupadas. Cada conexão tem sua própria linha: dois sites conectados são duas linhas, não uma linha que você precisa abrir para vê-los. Um tipo sem nenhuma conexão ainda recebe exatamente uma linha cinza. A maioria dos tipos se conecta colando um endereço — um site de documentação publicado é um site, independentemente de quem o criou, portanto Mintlify, GitBook, ReadMe, Docusaurus, Read the Docs e os demais não exigem nenhuma configuração específica por fornecedor.

Cinza significa duas coisas diferentes, e a linha indica qual delas:

• Não conectado — a linha oferece um Conectar. A leitura funciona hoje.
• Ainda não disponível — a linha não oferece nenhum botão e informa o que seria necessário: uma autorização concedida uma vez, um token de bot ou um leitor para um host de repositório que ainda não lemos. Quando existe uma alternativa, a linha a indica — um centro de ajuda público se conecta como um site hoje.

Uma linha sem botão é intencional. Um botão Conectar que não consegue conectar tornaria todas as outras linhas da tela pouco confiáveis.

Como conecto uma fonte?#

Pressione Conectar em uma linha ou o botão Nova fonte acima da tabela para qualquer coisa. De qualquer forma, há um campo, e o endereço determina o que é a fonte e em qual linha ela será colocada — não a linha que você selecionou:

Se o endereço não corresponder à linha que você abriu, a caixa de diálogo informará isso antes de você confirmar.

Um link colado de uma issue ou de uma solicitação de pull conecta o repositório, não a issue. Os parâmetros de rastreamento (?utm_source=…) são descartados, portanto a mesma página colada de um tweet e da sua barra de endereços é uma única fonte, e não duas.

Um projeto pode conectar mais de uma fonte do mesmo tipo — dois sites, dois repositórios, dois fóruns. Use Nova fonte também para a próxima; ela será adicionada como sua própria linha ao lado da que você já tem.

Duas entradas aparecem sem que você as adicione, e nenhuma delas pode ser removida aqui:

• Repositório deste site — o repositório a partir do qual sua documentação é criada.
• De Branding — o URL da fonte do site, se o seu espaço de trabalho tiver definido um. Ele continua na seção Branding.

Cada fonte conectada pode conter uma nota curta sobre por que está conectada. Essa nota não é decoração: o assistente a lê como uma instrução.

Online, pausado e o significado do ponto verde#

Cada fonte conectada mostra um ponto verde e a palavra Online. Uma fonte pausada mostra um ponto cinza e Pausado.

Esse status significa que a fonte está conectada e seus agentes podem lê-la. Ele não é uma verificação de integridade. Nada faz uma solicitação ao host e nada verifica se o repositório ainda existe — uma luz de status que nenhum código acende é pior do que luz nenhuma. O sinal honesto é sua própria coluna Último uso, preenchida somente quando uma ferramenta realmente obtém a fonte com sucesso.

Cada linha traz seu endereço como um chip e seus próprios controles: Desconectar mantém uma fonte na lista e impede que qualquer coisa a leia — pressione novamente (ela se torna Conectar) para retomar. Remover retira a conexão da lista de forma definitiva. Abrir visita o próprio endereço. As duas maneiras de parar de ler uma fonte são diferentes de propósito: "pare de ler isto por enquanto" não deve fazer você redigitar o endereço mais tarde.

O que lê uma fonte conectada?#

Três coisas leem uma fonte do Docsbook: o assistente no seu painel de administração, seus próprios agentes MCP e as execuções agendadas em segundo plano. Nada mais — uma fonte conectada não é rastreada periodicamente e não se torna parte da sua documentação publicada.

O assistente no seu painel de administração. Suas duas ferramentas, list_sources e read_source, estão disponíveis em todas as interações, em vez de ficarem atrás de uma consulta, e suas instruções mencionam literalmente suas fontes conectadas — uma regra que diz "verifique suas fontes" sem mencioná-las pelo nome é uma regra que um modelo não consegue seguir.

Seus próprios agentes MCP. As mesmas duas ferramentas são disponibilizadas pelo endpoint MCP do seu projeto, portanto uma fonte que você registra significa a mesma coisa no Claude Code ou no Cursor que significa aqui. Consulte a referência do servidor MCP.

Execuções em segundo plano. Prompts agendados e execuções de agentes também as leem, e é aí que isso mais importa: não há ninguém ali para colar um link.

Uma leitura de repositório sem um caminho lista os arquivos que podem ser lidos; com um caminho, ela retorna esse arquivo. Uma leitura de site sem um caminho retorna várias de suas páginas como Markdown, descobertas a partir do próprio sitemap do site e limitadas à seção que você conectou — conecte acme.com/docs e o blog ficará de fora. Sites sem sitemap retornam apenas a página de entrada, e o resultado informa isso, para que uma leitura limitada nunca seja confundida com um site limitado.

Quais execuções podem realmente ler uma fonte?#

Nem toda ferramenta acessa uma fonte, portanto o painel informa quais ferramentas o fazem, em vez de dar a entender que todas conseguem. Sempre que uma execução é listada — na coluna Fontes da tabela Prompts e na faixa sob a descrição de uma ferramenta MCP — os chips aparecem em dois estados:

• Aceso — esta execução busca a fonte: as páginas do seu site, os arquivos do seu repositório.
• Apagado — esta execução sabe que a fonte está conectada e não a buscará. Peça ao assistente; ele não tem essa limitação.
• Nada — esta execução não acessa nenhuma fonte. Uma gravação de configuração não tem motivo para ler seu repositório, e um chip ali sugeriria o contrário.

Por que conectar uma fonte, afinal?#

Porque uma fonte é o que transforma "atualizar a documentação" de um palpite em uma leitura. Preços, nomes de planos, limites, endpoints, números de versão e comportamento mudam mais rápido do que a documentação. Sem uma fonte, um assistente questionado sobre qualquer um deles ou diz que não sabe ou inventa algo plausível — e uma invenção plausível é a versão que chega aos seus leitores.

Com uma fonte conectada, essa pergunta tem um endereço. O assistente lê sua página de preços e corrige as três páginas que citam o nível antigo; lê o repositório e encontra as quatro coisas que o seu guia de início rápido afirma que o código deixou de fazer.

O que a leitura de uma fonte consome?#

list_sources lê linhas que o Docsbook já armazena e é cobrado como uma leitura comum. read_source sai da rede do Docsbook para buscar seu repositório ou seu site — e uma fonte de site busca várias páginas por chamada — portanto é cobrado como uma chamada de saída. Ambos são descontados do saldo do projeto ao qual a chamada se refere. Os valores estão na página de preços do Docsbook.

Próximas etapas#

Abra Fontes no painel de administração do seu projeto e conecte o repositório a partir do qual seu produto é criado — ele é a fonte que responde à maioria das perguntas.

Relacionados#

• Servidor MCP — as mesmas duas ferramentas, para seus próprios agentes.
• Chat de IA — o assistente no seu site de documentação.
• Ganchos de chat — a outra forma de fornecer ao modelo um fato que ele não pode ler.
• Referência das ferramentas MCP — list_sources e read_source na íntegra.