Skip to main content

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:
  1. Get your API key from app.codealive.ai
  2. Find the agent’s MCP config file
  3. Add the CodeAlive server configuration
  4. Restart the agent
Quick install: Run npx @codealive/installer to automatically detect and configure CodeAlive for supported agents. See the Installation Guide for details.

Agent Configurations

Roo Code reads a JSON settings file similar to Cline.Config file: mcp_settings.json (Roo) or cline_mcp_settings.jsonRemote HTTP:
Docker (STDIO):
If your Roo build doesn’t honor HTTP headers, use the Docker STDIO option.
Antigravity uses a Gemini-style config format.Config file: ~/.gemini/antigravity/mcp_config.json
KodaCode provides both IDE plugins and Koda CLI. They use different configuration files and MCP formats.
Config file: ~/.koda/config.yamlThe IDE plugin documents command-based MCP servers. Run CodeAlive through Docker using STDIO:
Set 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.
See the Koda IDE MCP guide and Koda CLI configuration reference.
GigaCode uses the standard 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:
Replace 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.
External MCP configuration is not covered by the current public GigaCode documentation. The config path and mcpServers format are corroborated by Promptery’s GigaCode installer. If a newer GigaCode build exposes an MCP settings UI, prefer the UI-generated configuration.
See the official GigaCode installation guide.
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
Docker (STDIO) alternative: Add a STDIO extension with:
  • Command: docker
  • Args: run --rm -i -e CODEALIVE_API_KEY=YOUR_API_KEY_HERE ghcr.io/codealive-ai/codealive-mcp:main
Kilo Code uses a UI-based setup.Setup path: Manage → Integrations → Model Context Protocol (MCP) → Add ServerHTTP:
STDIO (Docker):
Qwen Code supports multiple transports (stdio/SSE/streamable-http).Config file: ~/.qwen/settings.jsonStreamable HTTP:
Docker (STDIO):
Qwen Code wraps headers in requestOptions — different from most other clients.
Kiro does not yet support remote MCP servers natively. Use the mcp-remote workaround.Prerequisites:
Config file: ~/.kiro/settings/mcp.json or .kiro/settings/mcp.json (workspace)Remote HTTP (via mcp-remote):
Docker (STDIO):
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 requires the mcp-remote workaround for remote HTTP MCP servers.Prerequisites:
Setup path: Settings/Preferences → AI Assistant → Model Context Protocol → Configure
See JetBrains MCP Documentation for more details.
n8n connects via the AI Agent node with MCP tools.Setup:
  1. Add an AI Agent node to your workflow
  2. Configure the agent with MCP tools:
    • Server URL: https://mcp.codealive.ai/api
    • Authorization Header: Bearer YOUR_API_KEY_HERE
  3. The server automatically handles n8n’s extra parameters (sessionId, action, chatInput, toolCallId)
Example Workflow:
n8n middleware is built-in — the server automatically strips n8n’s extra parameters before processing tool calls.

Troubleshooting

  1. Verify your API key is correct
  2. Check the config file location and JSON syntax
  3. Ensure the Authorization header includes Bearer prefix
  4. Restart the agent completely
Use Docker STDIO instead — it works with every agent that supports MCP:
Some agents (Kiro, JetBrains AI) don’t support remote HTTP natively. Install mcp-remote:
Then use the STDIO config with npx mcp-remote as the command.
For more solutions, see the Troubleshooting Guide.

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 prefer semantic_search and grep_search when exploring indexed code. See Instructing Coding Agents.