Servidor MCP do ClayDocs

Use a documentação viva e o código dos seus repositórios direto no assistente de código do time. O servidor MCP do ClayDocs responde com as mesmas ferramentas do chat, sempre citando a seção, o PR ou as linhas do código de onde veio cada informação.

Endpoint

Um endpoint só para todos os workspaces: a chave de API diz qual workspace o cliente lê. O transporte é Streamable HTTP, sem sessão.

URL

https://claydocs.com.br/api/mcp

Cabeçalho de autenticação

Authorization: Bearer cdk_SUA_CHAVE

Como conectar

Um admin do workspace abre Configurações → Chaves de API e cria uma chave com um nome que identifique o uso (ex.: "Cursor do time").
Copie a chave na hora: por segurança ela não aparece de novo. Se perder, revogue e crie outra.
Configure o seu cliente com o endpoint e a chave, como nos exemplos abaixo, trocando cdk_SUA_CHAVE pela chave copiada.
Pergunte no assistente. Ele chama as ferramentas do ClayDocs quando a pergunta for sobre a documentação, o histórico ou o código do workspace.

Criar uma chave de API

Configuração por cliente

Claude Code

terminal

claude mcp add --transport http claydocs https://claydocs.com.br/api/mcp \
  --header "Authorization: Bearer cdk_SUA_CHAVE"

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "claydocs": {
      "url": "https://claydocs.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer cdk_SUA_CHAVE"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "claydocs": {
      "type": "http",
      "url": "https://claydocs.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer cdk_SUA_CHAVE"
      }
    }
  }
}

A chave dá acesso de leitura a todo o workspace: não a commite no repositório. Prefira a configuração do usuário ou variáveis de ambiente do seu cliente.

Ferramentas

As mesmas do chat do ClayDocs. Todas são somente leitura e ficam restritas ao workspace da chave.

Ferramenta	Parâmetros	O que faz
semanticSearch	query, repository?	Busca trechos da documentação viva pelo significado da pergunta: arquitetura, configuração, APIs e regras de negócio.
getSection	sectionId	Traz o texto completo de uma seção encontrada pela busca.
searchChanges	repository?, kind?, dateFrom?, dateTo?, limit?	Lista as mudanças documentadas (PRs mergeados e pushes diretos), da mais recente para a mais antiga, com filtros por repositório, tipo e período.
countChanges	repository?, kind?, dateFrom?, dateTo?	Conta as mudanças documentadas com os mesmos filtros. É a ferramenta para perguntas de "quantos".
searchCode	query, repository?	Encontra as funções, métodos, classes e tipos mais próximos da pergunta, com arquivo, linhas e link para o GitHub.
getCodeSnippet	repository, path, startLine, endLine	Lê as linhas de um arquivo encontrado por searchCode, buscadas no GitHub na hora (até 200 linhas por chamada).

Exemplos de perguntas

Onde é calculado o desconto do pedido e como ele funciona?
O que mudou na API de pagamentos no último mês?
Quantos PRs foram documentados nesta semana?
Quais variáveis de ambiente o serviço de ingestão precisa?

Limites e erros

Cada chave pode fazer até 60 requisições por minuto, e cada requisição tem até 60 segundos.

401: chave ausente, inválida ou revogada.
403 local_only_workspace: o workspace tem um projeto que proíbe LLMs de nuvem, e o modelo do seu cliente pode ser um deles. Esses workspaces não ficam disponíveis por MCP.
429: limite de requisições da chave atingido. Espere um minuto.
503: a documentação não pôde ser consultada agora. Tente de novo em instantes.

Segurança

Somente leitura: nenhuma ferramenta altera a documentação, aprova seções ou mexe no repositório.
Cada chave lê um workspace só, definido na criação. O cliente não consegue escolher outro.
Admins revogam a chave a qualquer momento em Configurações, com efeito imediato. A lista mostra o último uso de cada uma.
Valores com cara de credencial (chaves de API, tokens, senhas) são mascarados antes de sair do ClayDocs.
O ClayDocs não guarda o código dos seus repositórios: o índice de código guarda só onde está cada definição, e os trechos são buscados no GitHub quando pedidos.