MCP Network - Codanna

Codanna is a local code intelligence MCP server and CLI for AI coding agents. Network mode exposes the MCP server over HTTP or HTTPS for multiple clients, with OAuth authentication and optional TLS.

HTTP Server

codanna serve --http --watch

Includes OAuth authentication.

HTTPS Server

codanna serve --https --watch

Includes TLS encryption.

Unlike stdio transport, HTTP/HTTPS requires a running server instance. Start the server process before connecting your client.

Config Path

When running outside your project directory (common in production), specify the full path:

codanna --config /path/to/project/.codanna/settings.toml serve --http --watch

Run one server per project index. Multiple servers with --watch on the same .codanna/ directory will conflict when re-indexing.

Client Configuration

The same clients from MCP Persistent are supported. The difference is the transport type: use http with a URL instead of command/args.

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "codanna": {
      "type": "http",
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "codanna": {
      "type": "http",
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.codanna]
type = "http"
url = "http://127.0.0.1:8080/mcp"

Gemini CLI

Add to your settings.json:

{
  "mcpServers": {
    "codanna": {
      "url": "https://127.0.0.1:8443/mcp"
    }
  }
}

Gemini CLI auto-discovers OAuth endpoints for HTTPS servers.

HTTPS with Self-Signed Certificates

For secure local development with TLS encryption, see the HTTPS Setup guide.

Options

Flag	Description
`--http`	Enable HTTP server with OAuth
`--https`	Enable HTTPS server with TLS
`--bind <addr>`	Address to bind (default: 127.0.0.1:8080)
`--watch`	Enable auto-reload with 500ms debounce

Custom Bind Address

# Bind to all interfaces
codanna serve --http --bind 0.0.0.0:8080

# Custom port
codanna serve --http --bind 127.0.0.1:3000

When to Use

Use Case	Recommendation
Multiple clients	MCP Network
Network access needed	MCP Network
Single AI assistant	MCP Persistent
One-off queries	MCP Quick

Security

Default binds to localhost only (127.0.0.1)
HTTP mode includes OAuth authentication
HTTPS mode provides TLS encryption
Use caution when binding to 0.0.0.0

​HTTP Server

​HTTPS Server

​Config Path

​Client Configuration

​Claude Code

​Cursor

​Codex CLI

​Gemini CLI

​HTTPS with Self-Signed Certificates

​Options

​Custom Bind Address

​When to Use

​Security

HTTP Server

HTTPS Server

Config Path

Client Configuration

Claude Code

Cursor

Codex CLI

Gemini CLI

HTTPS with Self-Signed Certificates

Options

Custom Bind Address

When to Use

Security