> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trynia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Install and configure the Nia MCP server for your coding agent.

## Manual Configuration

<Info>
  **Remote Server** is recommended - no dependencies, no local process. If remote keeps failing (especially in Claude Code), switch to Local Server.
</Info>

<Note>
  **Local Server requires:** Python 3.8+ and `pipx` (recommended) or `uvx`
</Note>

***

## Client-Specific Configuration

Choose your coding agent below for detailed configuration instructions. Each section includes both **Remote Server (Recommended)** and **Local Server** options.

<Accordion title="Cursor">
  Go to: **Settings → Cursor Settings → MCP → Add new global MCP server**

  In 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](https://docs.cursor.com/context/model-context-protocol) for more info.

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="VS Code">
  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](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more info.

  **Remote Server (Recommended):**

  ```json theme={null}
  "mcp": {
    "servers": {
      "nia": {
        "type": "http",
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  "mcp": {
    "servers": {
      "nia": {
        "type": "stdio",
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Claude Code">
  See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp) for more info.

  **Remote Server (Recommended):**

  ```bash theme={null}
  # For current project only (default)
  claude mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" nia "https://apigcp.trynia.ai/mcp"

  # For global installation (all projects)
  claude mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" --scope user nia "https://apigcp.trynia.ai/mcp"
  ```

  **Local Server:**

  ```bash theme={null}
  # For current project only (default)
  claude mcp add -e NIA_API_KEY=YOUR_API_KEY -e NIA_API_URL=https://apigcp.trynia.ai/ nia -- pipx run --no-cache nia-mcp-server

  # For global installation (all projects)
  claude mcp add --scope user -e NIA_API_KEY=YOUR_API_KEY -e NIA_API_URL=https://apigcp.trynia.ai/ nia -- pipx run --no-cache nia-mcp-server
  ```

  **Scope Options:**

  | Scope           | Description                                                         |
  | --------------- | ------------------------------------------------------------------- |
  | `--scope local` | Current project only (default) - stored in `.mcp.json`              |
  | `--scope user`  | All projects for current user - stored in `~/.claude/settings.json` |

  <Note>
    Use `--scope user` if you want Nia available across all your projects without configuring each one separately.
  </Note>
</Accordion>

<Accordion title="Windsurf">
  Open your Windsurf MCP configuration:

  * **macOS**: `~/.windsurf/mcp.json`
  * **Windows**: `%APPDATA%\Windsurf\mcp.json`
  * **Linux**: `~/.config/windsurf/mcp.json`

  See [Windsurf MCP docs](https://docs.windsurf.com/windsurf/cascade/mcp) for more info.

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "serverUrl": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Cline">
  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):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "url": "https://apigcp.trynia.ai/mcp",
        "type": "streamableHttp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Continue.dev">
  Edit your `~/.continue/config.json` file.

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "experimental": {
      "modelContextProtocolServer": {
        "transport": {
          "type": "http",
          "url": "https://apigcp.trynia.ai/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "models": [],
    "mcpServers": [
      {
        "name": "nia",
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    ]
  }
  ```
</Accordion>

<Accordion title="Google Antigravity">
  Add this to your Antigravity MCP config file. See [Antigravity MCP docs](https://antigravity.google/docs/mcp) for more info.

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "serverUrl": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Trae">
  See [Trae documentation](https://docs.trae.ai/ide/model-context-protocol?_lang=en) for more details.

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Claude Desktop">
  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](https://modelcontextprotocol.io/quickstart/user) 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:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Gemini CLI">
  See [Gemini CLI Configuration](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html) for details.

  Open `~/.gemini/settings.json` and add:

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "httpUrl": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY",
          "Accept": "application/json, text/event-stream"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Mistral Vibe CLI">
  Open `~/.vibe/config.toml` and add:

  **Remote Server (Recommended):**

  ```toml theme={null}
  [[mcp_servers]]
  name = "nia"
  transport = "streamable-http"
  url = "https://apigcp.trynia.ai/mcp"

  [mcp_servers.headers]
  Authorization = "Bearer YOUR_API_KEY"
  ```

  <Note>
    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`
  </Note>
</Accordion>

<Accordion title="Zed">
  Add this to your Zed `settings.json`. See [Zed Context Server docs](https://zed.dev/docs/assistant/context-servers) for more info.

  **Local Server:**

  ```json theme={null}
  {
    "context_servers": {
      "nia": {
        "source": "custom",
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="OpenAI Codex">
  See [OpenAI Codex](https://github.com/openai/codex) for more information.

  <Warning>
    Codex requires extended timeout settings for NIA to work properly. If you see startup timeout errors, try increasing `startup_timeout_ms` to `40_000`.
  </Warning>

  **Remote Server (Recommended):**

  ```toml theme={null}
  [mcp_servers.nia]
  url = "https://apigcp.trynia.ai/mcp"
  http_headers = { "Authorization" = "Bearer YOUR_API_KEY" }
  ```

  **Local Server:**

  ```toml theme={null}
  tool_output_token_limit = 25000

  [mcp_servers.nia]
  command = "pipx"
  args = ["run", "--no-cache", "nia-mcp-server"]
  startup_timeout_sec = 30
  tool_timeout_sec = 360

  [mcp_servers.nia.env]
  NIA_API_KEY = "YOUR_API_KEY"
  NIA_API_URL = "https://apigcp.trynia.ai/"
  ```

  **Windows:** Use full paths if you encounter timeout errors.
</Accordion>

<Accordion title="Roo Code">
  See [Roo Code MCP docs](https://docs.roocode.com/features/mcp/using-mcp-in-roo) for more info.

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "type": "streamable-http",
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Kilo Code">
  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):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "type": "streamable-http",
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        },
        "alwaysAllow": [],
        "disabled": false
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        },
        "alwaysAllow": [],
        "disabled": false
      }
    }
  }
  ```
</Accordion>

<Accordion title="JetBrains AI Assistant">
  See [JetBrains AI Assistant Documentation](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html) 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:

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```

  5. Click **Apply**
</Accordion>

<Accordion title="Kiro">
  See [Kiro Model Context Protocol Documentation](https://kiro.dev/docs/mcp/configuration/) for details.

  1. Navigate to **Kiro → MCP Servers**
  2. Click **+ Add**
  3. Add configuration:

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        },
        "disabled": false,
        "autoApprove": []
      }
    }
  }
  ```
</Accordion>

<Accordion title="LM Studio">
  See [LM Studio MCP Support](https://lmstudio.ai/blog/lmstudio-v0.3.17) for more information.

  Go to **Program → Install → Edit mcp.json**:

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Visual Studio 2022">
  See [Visual Studio MCP Servers documentation](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) for more details.

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "inputs": [],
    "servers": {
      "nia": {
        "type": "http",
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "inputs": [],
    "servers": {
      "nia": {
        "type": "stdio",
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="BoltAI">
  See [BoltAI's Documentation](https://docs.boltai.com/docs/plugins/mcp-servers) for more info.

  Open **Settings → Plugins**, then add:

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Qodo Gen">
  See [Qodo Gen docs](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps) for more details.

  1. Open the Qodo Gen chat panel
  2. Click **Connect more tools**
  3. Click **+ Add new MCP**

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Qwen Coder">
  See [Qwen Coder MCP Configuration](https://qwenlm.github.io/qwen-code-docs/en/tools/mcp-server/#how-to-set-up-your-mcp-server) for details.

  Open `~/.qwen/settings.json` and add:

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "httpUrl": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY",
          "Accept": "application/json, text/event-stream"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Perplexity Desktop">
  See [Local and Remote MCPs for Perplexity](https://www.perplexity.ai/help-center/en/articles/11502712-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:

  ```json theme={null}
  {
    "args": ["run", "--no-cache", "nia-mcp-server"],
    "command": "pipx",
    "env": {
      "NIA_API_KEY": "YOUR_API_KEY",
      "NIA_API_URL": "https://apigcp.trynia.ai/"
    }
  }
  ```
</Accordion>

<Accordion title="Warp">
  See [Warp Model Context Protocol Documentation](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server) for details.

  1. Navigate to **Settings → AI → Manage MCP servers**
  2. Click **+ Add**
  3. Add configuration:

  ```json theme={null}
  {
    "nia": {
      "command": "pipx",
      "args": ["run", "--no-cache", "nia-mcp-server"],
      "env": {
        "NIA_API_KEY": "YOUR_API_KEY",
        "NIA_API_URL": "https://apigcp.trynia.ai/"
      },
      "working_directory": null,
      "start_on_launch": true
    }
  }
  ```
</Accordion>

<Accordion title="Copilot Coding Agent">
  Add to: **Repository → Settings → Copilot → Coding agent → MCP configuration**

  See the [official GitHub documentation](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp) for more info.

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "type": "http",
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "type": "stdio",
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Copilot CLI">
  Open `~/.copilot/mcp-config.json` and add:

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "type": "http",
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "type": "local",
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Amazon Q Developer CLI">
  See [Amazon Q Developer CLI docs](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html) for more details.

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Opencode">
  See [Opencode MCP docs](https://opencode.ai/docs/mcp-servers) for more info.

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcp": {
      "nia": {
        "type": "remote",
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        },
        "enabled": true
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcp": {
      "nia": {
        "type": "local",
        "command": ["pipx", "run", "--no-cache", "nia-mcp-server"],
        "environment": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        },
        "enabled": true
      }
    }
  }
  ```
</Accordion>

<Accordion title="Crush">
  Add this to your Crush configuration file. See [Crush MCP docs](https://github.com/charmbracelet/crush#mcps) for more info.

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "$schema": "https://charm.land/crush.json",
    "mcp": {
      "nia": {
        "type": "http",
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "$schema": "https://charm.land/crush.json",
    "mcp": {
      "nia": {
        "type": "stdio",
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Amp">
  See [Amp MCP docs](https://ampcode.com/manual#mcp) for more info.

  **Remote Server Only:**

  ```bash theme={null}
  amp mcp add nia --header "Authorization=Bearer YOUR_API_KEY" https://apigcp.trynia.ai/mcp
  ```
</Accordion>

<Accordion title="Factory">
  Factory's droid supports MCP servers through its CLI. See [Factory MCP docs](https://docs.factory.ai/cli/configuration/mcp) for more info.

  **Remote Server (Recommended):**

  ```bash theme={null}
  droid mcp add nia https://apigcp.trynia.ai/mcp --type http --header "Authorization: Bearer YOUR_API_KEY"
  ```

  **Local Server:**

  ```bash theme={null}
  droid mcp add nia "pipx run --no-cache nia-mcp-server" --env NIA_API_KEY=YOUR_API_KEY --env NIA_API_URL=https://apigcp.trynia.ai/
  ```

  Once configured, Nia tools will be available in your droid sessions. Type `/mcp` within droid to manage servers.
</Accordion>

<Accordion title="Augment Code">
  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:**

  ```json theme={null}
  "augment.advanced": {
    "mcpServers": [
      {
        "name": "nia",
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    ]
  }
  ```
</Accordion>

<Accordion title="Rovo Dev CLI">
  Edit your Rovo Dev CLI MCP config:

  ```bash theme={null}
  acli rovodev mcp
  ```

  **Remote Server (Recommended):**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "url": "https://apigcp.trynia.ai/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  **Local Server:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "pipx",
        "args": ["run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Smithery">
  To install Nia MCP Server for any client automatically via [Smithery](https://smithery.ai):

  ```bash theme={null}
  npx -y @smithery/cli@latest install nia-mcp-server --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>
  ```

  You can find your Smithery key in the [Smithery.ai webpage](https://smithery.ai).
</Accordion>

<Accordion title="Zencoder">
  1. Go to the Zencoder menu (...)
  2. Select **Agent tools**
  3. Click on **Add custom MCP**
  4. Add the name and configuration:

  ```json theme={null}
  {
    "command": "pipx",
    "args": ["run", "--no-cache", "nia-mcp-server"],
    "env": {
      "NIA_API_KEY": "YOUR_API_KEY",
      "NIA_API_URL": "https://apigcp.trynia.ai/"
    }
  }
  ```

  5. Click **Install**
</Accordion>

<Accordion title="Emdash">
  [Emdash](https://github.com/generalaction/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](https://github.com/generalaction/emdash) for more information.
</Accordion>

<Accordion title="Using Bun or Deno">
  Use these alternatives to run the local Nia MCP server with other runtimes.

  **Bun:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "bunx",
        "args": ["nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```

  **Deno:**

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "deno",
        "args": [
          "run",
          "--allow-env",
          "--allow-net",
          "npm:nia-mcp-server"
        ],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        }
      }
    }
  }
  ```
</Accordion>

<Accordion title="Using Docker">
  1. Create a `Dockerfile`:

  ```dockerfile theme={null}
  FROM python:3.11-slim
  WORKDIR /app
  RUN pip install nia-mcp-server
  CMD ["nia-mcp-server"]
  ```

  2. Build the image:

  ```bash theme={null}
  docker build -t nia-mcp .
  ```

  3. Configure your MCP client:

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "-e", "NIA_API_KEY=YOUR_API_KEY", "-e", "NIA_API_URL=https://apigcp.trynia.ai/", "nia-mcp"],
        "transportType": "stdio"
      }
    }
  }
  ```
</Accordion>

<Accordion title="Windows Configuration">
  On Windows, configuration differs slightly. Use `cmd` with `/c`:

  ```json theme={null}
  {
    "mcpServers": {
      "nia": {
        "command": "cmd",
        "args": ["/c", "pipx", "run", "--no-cache", "nia-mcp-server"],
        "env": {
          "NIA_API_KEY": "YOUR_API_KEY",
          "NIA_API_URL": "https://apigcp.trynia.ai/"
        },
        "disabled": false,
        "autoApprove": []
      }
    }
  }
  ```
</Accordion>

***

<Warning>
  **Need Help?** Join our community or reach out through [app.trynia.ai](https://app.trynia.ai/) for support and updates.
</Warning>