O que é CLAUDE.md?

CLAUDE.md é um arquivo de configuração que o Claude Code lê ao iniciar uma sessão em um diretório de projeto. Ele contém instruções, convenções e contexto específicos do projeto que guiam o comportamento do Claude. Todo desenvolvedor que clona o repositório obtém automaticamente a mesma configuração do assistente IA.

Ao adicionar o servidor MCP do aqoon ao CLAUDE.md do seu projeto, cada membro da equipe ganha acesso instantâneo à base de conhecimento da sua organização diretamente no Claude Code — sem configuração manual necessária.

Configuração

1. Criar uma chave de API

Vá para Chaves de API na barra lateral e crie uma chave de acesso total. Copie o valor da chave — você só o verá uma vez.

2. Adicionar servidor MCP ao seu projeto

Execute este comando no diretório do seu projeto:

claude mcp add aqoon --transport http https://aqoon.ai/mcp/ \
  --header "Authorization: Bearer aqn_YOUR_API_KEY"

Isso cria um arquivo .claude.json no seu projeto com a configuração do servidor MCP.

3. Adicionar instruções ao CLAUDE.md

Crie ou edite o CLAUDE.md na raiz do seu projeto e adicione:

# Knowledge Base

This project uses aqoon for internal documentation search.
Use the aqoon MCP tools to search our knowledge base before
answering questions about company policies, procedures, or
internal documentation.

Available tools:
- search_documents: Search across all collections
- list_collections: See available document collections
- get_document_info: Get full document content
- search_by_tag: Find documents by tag

4. Commitar ambos os arquivos

git add CLAUDE.md .claude.json
git commit -m "Add aqoon knowledge base integration for Claude Code"

Agora todo desenvolvedor que clonar o repositório terá o Claude Code automaticamente conectado à sua base de conhecimento aqoon.

Como sua equipe usa

Uma vez configurado, qualquer membro da equipe pode fazer perguntas ao Claude Code como:

• "Qual é nossa política de reembolso para clientes enterprise?"
• "Como fazemos deploy em produção?"
• "Quais são os limites de requisições da API?"

O Claude pesquisará automaticamente sua base de conhecimento aqoon e responderá usando a documentação real da sua organização — não dados de treinamento genéricos.

Segurança da chave de API

O arquivo .claude.json contém a chave de API. Considere estas opções para sua equipe:

• Chave compartilhada no repositório — Mais simples. Use uma chave restrita que conceda acesso apenas às coleções que a equipe deve ver. Adicione .claude.json ao controle de versão.
• Chaves por desenvolvedor — Mais seguro. Adicione .claude.json ao .gitignore e peça a cada desenvolvedor para executar o comando claude mcp add com sua própria chave.

Exemplo de estrutura de projeto

my-project/
├── CLAUDE.md          # AI assistant instructions
├── .claude.json       # MCP server config (aqoon connection)
├── src/
├── docs/              # Upload these to aqoon!
│   ├── onboarding.md
│   ├── architecture.md
│   └── api-guide.md
└── README.md

Envie sua pasta docs/ para uma coleção aqoon, e então o Claude Code poderá pesquisá-la em toda conversa.