Local MCP Server

Experimental API - Context Connectors is experimental and subject to breaking changes.

Prerequisites

Claude Desktop installed
An indexed project (see Index and Search Code)
Augment API credentials

Steps

1. Open Claude Desktop config

macOS
Windows

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

2. Add MCP server config

Local Filesystem
GitHub
GitLab
BitBucket

{
  "mcpServers": {
    "my-project": {
      "command": "npx",
      "args": ["ctxc", "mcp", "stdio", "-i", "my-project"],
      "env": {
        "AUGMENT_SESSION_AUTH": "<session-json>"
      }
    }
  }
}

{
  "mcpServers": {
    "my-project": {
      "command": "npx",
      "args": ["ctxc", "mcp", "stdio", "-i", "my-project"],
      "env": {
        "AUGMENT_SESSION_AUTH": "<session-json>",
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

{
  "mcpServers": {
    "my-project": {
      "command": "npx",
      "args": ["ctxc", "mcp", "stdio", "-i", "my-project"],
      "env": {
        "AUGMENT_SESSION_AUTH": "<session-json>",
        "GITLAB_TOKEN": "glpat-..."
      }
    }
  }
}

{
  "mcpServers": {
    "my-project": {
      "command": "npx",
      "args": ["ctxc", "mcp", "stdio", "-i", "my-project"],
      "env": {
        "AUGMENT_SESSION_AUTH": "<session-json>",
        "BITBUCKET_TOKEN": "..."
      }
    }
  }
}

3. Restart Claude Desktop

Quit and reopen Claude Desktop.

4. Test it

Ask Claude:

Search for authentication logic in my-project

You should see Claude use the search tool and return code snippets.

Done!

Your agent can now search your codebase via the local MCP server.

Works With Other Agents

This same configuration works with any MCP-compatible agent:

Claude Desktop - Follow the steps above
Claude Code (VS Code extension) - Add to Claude Code’s MCP settings
Cursor - Configure in Cursor’s MCP settings
GitHub Copilot - Add to Copilot’s MCP configuration
Custom agents - Any tool that supports MCP stdio protocol

Each agent has its own config file location, but the MCP server configuration is the same.

Also Works With

Instead of…	Try…
One repo	Add multiple entries to `mcpServers` for different projects
Local index	S3-stored indexes with `--store s3` and `CC_S3_BUCKET` env var
Search only	Add `--search-only` to disable file reading

Getting Started

Cosmos

Auggie CLI

Other clients

Admin

Models & Pricing

Troubleshooting

Local MCP Server

Prerequisites

Steps

1. Open Claude Desktop config

2. Add MCP server config

3. Restart Claude Desktop

4. Test it

Done!

Works With Other Agents

Also Works With

​Prerequisites

​Steps

​1. Open Claude Desktop config

​2. Add MCP server config

​3. Restart Claude Desktop

​4. Test it

​Done!

​Works With Other Agents

​Also Works With

Prerequisites

Steps

1. Open Claude Desktop config

2. Add MCP server config

3. Restart Claude Desktop

4. Test it

Done!

Works With Other Agents

Also Works With