Documentation/kilo-code-mcp.md
This guide shows how to connect GitNexus to the Kilo Code VS Code extension using Kilo’s MCP support, based on a setup that has been tested successfully.
GitNexus should already be installed globally and working on the target repository, and the repository should be indexed successfully with gitnexus analyze before testing inside Kilo.
| Component | Version |
|---|---|
| VS Code | 1.125.1 (user setup) |
| Node.js | 24.15.0 |
| Kilo Code | 7.3.50 |
| OS | Windows 11 25H2 / Windows_NT x64 10.0.26200 |
| GitNexus | 1.6.7 |
Kilo Code stores MCP server configuration in its main config file. For the VS Code extension, config can be stored at either the global or project level.
| Scope | Config path |
|---|---|
| Global | ~/.config/kilo/kilo.jsonc |
| Project | kilo.jsonc or .kilo/kilo.jsonc in the project root |
Check latest path : https://kilo.ai/docs/automate/mcp/using-in-kilo-code
Kilo supports local MCP servers through STDIO, and GitNexus should be added as a local server under the mcp key in kilo.jsonc. Use this configuration:
{
"mcp": {
"gitnexus": {
"type": "local",
"command": ["npx", "-y", "gitnexus@latest", "mcp"],
"enabled": true,
"timeout": 10000
}
}
}
After configuration, Kilo automatically detects the tools exposed by the MCP server and can use them from chat once the server is available.
A practical test flow is:
gitnexus analyzecompleted successfully.Use GitNexus and explain What does index.php do?.failed, check the CLI output and confirm the command and paths are correct.