integrations

Documentation / Integrations

---

Integrations

Drop codanna in as an MCP server, point the agent at it, and watch it stop hand-waving and start answering with receipts.

Available Integrations

• Claude Code - Claude's official CLI
• Claude Desktop - Desktop app configuration
• Codex CLI - Alternative CLI client
• HTTP/HTTPS Server - Persistent server with real-time file watching
• Agent Guidance - System messages and steering

Extending with Plugins

• Plugin System - Add custom commands, agents, and MCP servers to Claude Code

Quick Setup

Claude Code

# Add this to your local .mcp.json:
{
  "mcpServers": {
    "codanna": {
      "command": "codanna",
      "args": ["serve", "--watch"]
    }
  }
}

Claude Desktop

For Claude Desktop, you need the --config flag since it runs from a different location.

Configure in ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

{
  "mcpServers": {
    "codanna": {
      "command": "codanna",
      "args": ["--config", "/absolute/path/to/your/project/.codanna/settings.toml", "serve", "--watch"]
    }
  }
}

Replace /absolute/path/to/your/project/ with your actual project path.

Agent Workflow

Tool priority:

• Tier 1: semantic_search_with_context, analyze_impact
• Tier 2: find_symbol, get_calls, find_callers
• Tier 3: search_symbols, semantic_search_docs, get_index_info

Workflow:

1. semantic_search_with_context - Find relevant code with context
2. analyze_impact - Map dependencies and change radius
3. find_symbol, get_calls, find_callers - Get specific details

Start with semantic search, then narrow with specific queries.

Next Steps

• Configure Agent Guidance for optimal steering
• Learn about MCP Tools in detail
• Explore Advanced features

Back to Documentation