Docs / CLAUDE.md Integration

What is CLAUDE.md?

CLAUDE.md is a configuration file that Claude Code reads when it starts a session in a project directory. It contains project-specific instructions, conventions, and context that guide Claude's behavior. Every developer who clones the repo automatically gets the same AI assistant configuration.

By adding aqoon's MCP server to your project's CLAUDE.md, every team member gets instant access to your organization's knowledge base directly inside Claude Code — no manual setup required.

Setup

1. Create an API key

Go to API Keys in the sidebar and create a full-access key. Copy the key value — you will only see it once.

2. Add MCP server to your project

Run this command in your project directory:

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

This creates a .claude.json file in your project with the MCP server configuration.

3. Add instructions to CLAUDE.md

Create or edit CLAUDE.md in your project root and add:

# 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. Commit both files

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

Now every developer who clones the repo will have Claude Code automatically connected to your aqoon knowledge base.

How your team uses it

Once set up, any team member can ask Claude Code questions like:

  • "What is our refund policy for enterprise clients?"
  • "How do we deploy to production?"
  • "What are the API rate limits?"

Claude will automatically search your aqoon knowledge base and answer using your organization's actual documentation — not generic training data.

API key security

The .claude.json file contains the API key. Consider these options for your team:

  • Shared key in repo — Simplest. Use a scoped key that only grants access to collections the team should see. Add .claude.json to version control.
  • Per-developer keys — More secure. Add .claude.json to .gitignore and have each developer run the claude mcp add command with their own key.

Example project structure

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

Upload your docs/ folder to an aqoon collection, then Claude Code can search it in every conversation.