Overview
CodeAlive works with any MCP-compatible AI agent. This page covers setup for agents that use standard JSON configuration. For agents with unique setup requirements, see their dedicated pages.General Setup
All agents below follow the same pattern:- Get your API key from app.codealive.ai
- Find the agent’s MCP config file
- Add the CodeAlive server configuration
- Restart the agent
Agent Configurations
Roo Code
Roo Code
Roo Code reads a JSON settings file similar to Cline.Config file: Docker (STDIO):
mcp_settings.json (Roo) or cline_mcp_settings.jsonRemote HTTP:If your Roo build doesn’t honor HTTP headers, use the Docker STDIO option.
Antigravity
Antigravity
Antigravity uses a Gemini-style config format.Config file:
~/.gemini/antigravity/mcp_config.jsonKodaCode
KodaCode
KodaCode provides both IDE plugins and Koda CLI. They use different configuration files and MCP formats.See the Koda IDE MCP guide and Koda CLI configuration reference.
- Koda IDE plugin
- Koda CLI
Config file: Set
~/.koda/config.yamlThe IDE plugin documents command-based MCP servers. Run CodeAlive through Docker using STDIO:CODEALIVE_API_KEY in the environment before starting the IDE, then open Koda Settings → MCP. A Connected status confirms the server is available. In Agent mode, open Tools to review the discovered CodeAlive tools and their approval policies.GigaCode (Sber)
GigaCode (Sber)
GigaCode uses the standard Replace
mcpServers object in its user configuration.Config file: ~/.gigacode/settings.jsonGigaCode’s public documentation does not currently specify a remote HTTP configuration format. Use CodeAlive’s Docker STDIO transport:YOUR_API_KEY_HERE, save the file, and fully restart the IDE. Open GigaCode’s agent mode and confirm that CodeAlive MCP tools are available before using them.See the official GigaCode installation guide.Goose
Goose
Goose uses a UI-based setup flow.Setup path: Settings → MCP Servers → Add → choose Streamable HTTPStreamable HTTP configuration:
- Name:
codealive - Endpoint URL:
https://mcp.codealive.ai/api - Headers:
Authorization: Bearer YOUR_API_KEY_HERE
- Command:
docker - Args:
run --rm -i -e CODEALIVE_API_KEY=YOUR_API_KEY_HERE ghcr.io/codealive-ai/codealive-mcp:main
Kilo Code
Kilo Code
Kilo Code uses a UI-based setup.Setup path: Manage → Integrations → Model Context Protocol (MCP) → Add ServerHTTP:STDIO (Docker):
Qwen Code
Qwen Code
Qwen Code supports multiple transports (stdio/SSE/streamable-http).Config file: Docker (STDIO):
~/.qwen/settings.jsonStreamable HTTP:Qwen Code wraps headers in
requestOptions — different from most other clients.Kiro
Kiro
Kiro does not yet support remote MCP servers natively. Use the Config file: Docker (STDIO):
mcp-remote workaround.Prerequisites:~/.kiro/settings/mcp.json or .kiro/settings/mcp.json (workspace)Remote HTTP (via mcp-remote):Qoder
Qoder
Qoder uses a UI-based setup with SSE transport.Setup path: User icon → Qoder Settings → MCP → My Servers → + Add (Agent mode)SSE (remote HTTP):STDIO (Docker):
JetBrains AI Assistant
JetBrains AI Assistant
JetBrains AI Assistant requires the Setup path: Settings/Preferences → AI Assistant → Model Context Protocol → ConfigureSee JetBrains MCP Documentation for more details.
mcp-remote workaround for remote HTTP MCP servers.Prerequisites:n8n
n8n
n8n connects via the AI Agent node with MCP tools.Setup:
- Add an AI Agent node to your workflow
-
Configure the agent with MCP tools:
- Server URL:
https://mcp.codealive.ai/api - Authorization Header:
Bearer YOUR_API_KEY_HERE
- Server URL:
-
The server automatically handles n8n’s extra parameters (
sessionId,action,chatInput,toolCallId)
n8n middleware is built-in — the server automatically strips n8n’s extra parameters before processing tool calls.
Troubleshooting
MCP server not connecting
MCP server not connecting
- Verify your API key is correct
- Check the config file location and JSON syntax
- Ensure the
Authorizationheader includesBearerprefix - Restart the agent completely
Agent doesn't support HTTP transport
Agent doesn't support HTTP transport
Use Docker STDIO instead — it works with every agent that supports MCP:
Agent requires mcp-remote
Agent requires mcp-remote
Some agents (Kiro, JetBrains AI) don’t support remote HTTP natively. Install Then use the STDIO config with
mcp-remote:npx mcp-remote as the command.Related Resources
Instruct Your Agent
Connecting CodeAlive makes its tools available, but the agent may still default to its built-in search. For reliable results, add a short instruction in the agent’s native format telling it to prefersemantic_search and grep_search when exploring indexed code. See Instructing Coding Agents.