Skip to main content

Manual Configuration

Remote Server is recommended - no dependencies, no local process. If remote keeps failing (especially in Claude Code), switch to Local Server.
Local Server requires: Python 3.8+ and pipx (recommended) or uvx

Client-Specific Configuration

Choose your coding agent below for detailed configuration instructions. Each section includes both Remote Server (Recommended) and Local Server options.
Go to: Settings → Cursor Settings → MCP → Add new global MCP serverIn Cursor 1.0 and later, manually edit ~/.cursor/mcp.json:
  • macOS: ~/.cursor/mcp.json
  • Windows: %APPDATA%\Cursor\mcp.json
  • Linux: ~/.config/cursor/mcp.json
See Cursor MCP docs for more info.Remote Server (Recommended):
Local Server:
Open your VS Code MCP configuration:
  • Run MCP: Open User Configuration from the Command Palette
  • Or manually edit:
    • macOS/Linux: ~/.config/Code/User/mcp.json
    • Windows: %APPDATA%\Code\User\mcp.json
See VS Code MCP docs for more info.Remote Server (Recommended):
Local Server:
See Claude Code MCP docs for more info.Remote Server (Recommended):
Local Server:
Scope Options:
Use --scope user if you want Nia available across all your projects without configuring each one separately.
Open your Windsurf MCP configuration:
  • macOS: ~/.windsurf/mcp.json
  • Windows: %APPDATA%\Windsurf\mcp.json
  • Linux: ~/.config/windsurf/mcp.json
See Windsurf MCP docs for more info.Remote Server (Recommended):
Local Server:
You can directly edit MCP servers configuration:
  1. Open Cline
  2. Click the hamburger menu icon to enter the MCP Servers section
  3. Choose Remote Servers tab
  4. Click the Edit Configuration button
  5. Add nia to mcpServers:
Remote Server (Recommended):
Local Server:
Edit your ~/.continue/config.json file.Remote Server (Recommended):
Local Server:
Add this to your Antigravity MCP config file. See Antigravity MCP docs for more info.Remote Server (Recommended):
Local Server:
See Trae documentation for more details.Remote Server (Recommended):
Local Server:
Edit your Claude Desktop configuration:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
See Claude Desktop MCP docs for more info.Remote Server (Recommended):Open Claude Desktop and navigate to Settings → Connectors → Add Custom Connector. Enter the name as Nia and the remote MCP server URL as https://apigcp.trynia.ai/mcp.Local Server:
See Gemini CLI Configuration for details.Open ~/.gemini/settings.json and add:Remote Server (Recommended):
Local Server:
Open ~/.vibe/config.toml and add:Remote Server (Recommended):
Mistral Vibe CLI uses TOML format for configuration. The configuration should be added to your existing config file at:
  • macOS/Linux: ~/.vibe/config.toml
  • Windows: %USERPROFILE%\.vibe\config.toml
Add this to your Zed settings.json. See Zed Context Server docs for more info.Local Server:
See OpenAI Codex for more information.
Codex requires extended timeout settings for NIA to work properly. If you see startup timeout errors, try increasing startup_timeout_ms to 40_000.
Remote Server (Recommended):
Local Server:
Windows: Use full paths if you encounter timeout errors.
See Roo Code MCP docs for more info.Remote Server (Recommended):
Local Server:
You can configure the Nia MCP server in Kilo Code using either the UI or by editing your project’s MCP configuration file.Kilo Code supports two configuration levels:
  • Global MCP Configuration — stored in mcp_settings.json
  • Project-level MCP Configuration — stored in .kilocode/mcp.json (recommended)

Configure via Kilo Code UI

  1. Open Kilo Code
  2. Click the Settings icon in the top-right corner
  3. Navigate to Settings → MCP Servers
  4. Click Add Server
  5. Choose HTTP Server (Streamable HTTP Transport)
  6. Enter the details:
    • URL: https://apigcp.trynia.ai/mcp
    • Headers → Add Header
      • Key: Authorization
      • Value: Bearer YOUR_API_KEY
  7. Click Save

Manual Configuration

Create .kilocode/mcp.json:Remote Server (Recommended):
Local Server:
See JetBrains AI Assistant Documentation for more details.
  1. Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
  2. Click + Add
  3. Select As JSON from the dropdown
  4. Add configuration:
  1. Click Apply
See Kiro Model Context Protocol Documentation for details.
  1. Navigate to Kiro → MCP Servers
  2. Click + Add
  3. Add configuration:
See LM Studio MCP Support for more information.Go to Program → Install → Edit mcp.json:
See Visual Studio MCP Servers documentation for more details.Remote Server (Recommended):
Local Server:
See BoltAI’s Documentation for more info.Open Settings → Plugins, then add:
See Qodo Gen docs for more details.
  1. Open the Qodo Gen chat panel
  2. Click Connect more tools
  3. Click + Add new MCP
Remote Server (Recommended):
Local Server:
See Qwen Coder MCP Configuration for details.Open ~/.qwen/settings.json and add:Remote Server (Recommended):
Local Server:
See Local and Remote MCPs for Perplexity for more information.
  1. Navigate to Perplexity → Settings → Connectors
  2. Click Add Connector → Advanced
  3. Server Name: Nia
  4. Add configuration:
See Warp Model Context Protocol Documentation for details.
  1. Navigate to Settings → AI → Manage MCP servers
  2. Click + Add
  3. Add configuration:
Add to: Repository → Settings → Copilot → Coding agent → MCP configurationSee the official GitHub documentation for more info.Remote Server (Recommended):
Local Server:
Open ~/.copilot/mcp-config.json and add:Remote Server (Recommended):
Local Server:
See Amazon Q Developer CLI docs for more details.
See Opencode MCP docs for more info.Remote Server (Recommended):
Local Server:
Add this to your Crush configuration file. See Crush MCP docs for more info.Remote Server (Recommended):
Local Server:
See Amp MCP docs for more info.Remote Server Only:
Factory’s droid supports MCP servers through its CLI. See Factory MCP docs for more info.Remote Server (Recommended):
Local Server:
Once configured, Nia tools will be available in your droid sessions. Type /mcp within droid to manage servers.
Via UI:
  1. Hamburger menu → Settings → Tools
  2. Click + Add MCP
  3. Enter command: pipx run --no-cache nia-mcp-server
  4. Name: Nia
Manual Configuration:
Edit your Rovo Dev CLI MCP config:
Remote Server (Recommended):
Local Server:
To install Nia MCP Server for any client automatically via Smithery:
You can find your Smithery key in the Smithery.ai webpage.
  1. Go to the Zencoder menu (…)
  2. Select Agent tools
  3. Click on Add custom MCP
  4. Add the name and configuration:
  1. Click Install
Emdash is an orchestration layer for running multiple coding agents in parallel.What Emdash provides:
  • Global toggle: Settings → MCP → “Enable Nia MCP”
  • Per-workspace enable: The Nia button in the ProviderBar
What you still need to do: Configure your coding agent (Codex, Claude Code, Cursor, etc.) to connect to Nia MCP. Emdash does not modify your agent’s config.See the Emdash repository for more information.
Use these alternatives to run the local Nia MCP server with other runtimes.Bun:
Deno:
  1. Create a Dockerfile:
  1. Build the image:
  1. Configure your MCP client:
On Windows, configuration differs slightly. Use cmd with /c:

Need Help? Join our community or reach out through app.trynia.ai for support and updates.