Claude Desktop Configuration

Ready-to-use configuration templates for monitoring MCP servers in Claude Desktop. Simply copy, customize, and paste into your configuration file.

Important Setup Requirements

1.Install Kilometers CLI first: curl -sSL https://get.kilometers.ai/install.sh | sh
2.Configure your API key: km init
3.All MCP server commands are wrapped with km for monitoring

Configuration File Location

Claude Desktop looks for its configuration file in different locations depending on your operating system:

CONFIG FILE PATH

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

Configuration Templates

Choose from these popular MCP server configurations. Each template includes setup instructions and the exact JSON configuration you need.

GitHub

Access GitHub repositories, issues, and pull requests

Setup Instructions:

1.Create a GitHub Personal Access Token at https://github.com/settings/tokens
2.Grant 'repo' permissions for private repositories, or 'public_repo' for public only
3.Replace 'your_github_token_here' with your actual token
4.Install the GitHub MCP server: npm install -g @modelcontextprotocol/server-github

Configuration:

claude_desktop_config.json

{
  "mcpServers": {
    "github": {
      "command": "km",
      "args": [
        "npx",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
      }
    }
  }
}

Test Your Configuration:

After saving your configuration, restart Claude Desktop and run:

km validate

This will verify that your MCP servers are working correctly and events are being monitored.

Filesystem

Read and write files on your local filesystem

Setup Instructions:

1.Install the filesystem MCP server: npm install -g @modelcontextprotocol/server-filesystem
2.Replace '/path/to/allowed/directory' with the directory you want to allow access to
3.Consider using your home directory or a specific project folder
4.The server will only have access to files within the specified directory

Configuration:

claude_desktop_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "km",
      "args": [
        "npx",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ],
      "env": {}
    }
  }
}

Test Your Configuration:

After saving your configuration, restart Claude Desktop and run:

km validate

This will verify that your MCP servers are working correctly and events are being monitored.

Brave Search

Search the web using Brave Search API

Setup Instructions:

1.Sign up for Brave Search API at https://api.search.brave.com/
2.Get your API key from the dashboard
3.Replace 'your_brave_api_key_here' with your actual API key
4.Install the Brave Search MCP server: npm install -g @modelcontextprotocol/server-brave-search

Configuration:

claude_desktop_config.json

{
  "mcpServers": {
    "brave-search": {
      "command": "km",
      "args": [
        "npx",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "your_brave_api_key_here"
      }
    }
  }
}

Test Your Configuration:

After saving your configuration, restart Claude Desktop and run:

km validate

This will verify that your MCP servers are working correctly and events are being monitored.

SQLite

Query SQLite databases

Setup Instructions:

1.Install the SQLite MCP server: npm install -g @modelcontextprotocol/server-sqlite
2.Replace '/path/to/your/database.db' with the path to your SQLite database
3.Ensure the database file exists and is readable
4.The server will have read-only access to the database

Configuration:

claude_desktop_config.json

{
  "mcpServers": {
    "sqlite": {
      "command": "km",
      "args": [
        "npx",
        "@modelcontextprotocol/server-sqlite",
        "/path/to/your/database.db"
      ],
      "env": {}
    }
  }
}

Test Your Configuration:

After saving your configuration, restart Claude Desktop and run:

km validate

This will verify that your MCP servers are working correctly and events are being monitored.

Multiple Servers

Configure multiple MCP servers together

Setup Instructions:

1.You can configure multiple MCP servers in the same config file
2.Each server needs a unique name (the key in mcpServers)
3.All servers will be monitored by Kilometers independently
4.Test each server individually before combining them

Configuration:

claude_desktop_config.json

{
  "mcpServers": {
    "github": {
      "command": "km",
      "args": [
        "npx",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
      }
    },
    "filesystem": {
      "command": "km",
      "args": [
        "npx",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Documents"
      ],
      "env": {}
    },
    "brave-search": {
      "command": "km",
      "args": [
        "npx",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "your_brave_api_key_here"
      }
    }
  }
}

Test Your Configuration:

After saving your configuration, restart Claude Desktop and run:

km validate

This will verify that your MCP servers are working correctly and events are being monitored.

Troubleshooting

Common Issues:

•Claude Desktop won't start: Check JSON syntax in your config file
•MCP server not found: Ensure you've installed the server globally with npm
•No events in dashboard: Run km validate to check connectivity
•Environment variables: Double-check API keys and tokens are correct

Ready to Monitor Your AI?

Once you've configured Claude Desktop with your MCP servers, you can start monitoring your AI's activity in real-time.

Start Monitoring View CLI Commands