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

# Clix MCP Server

> Enables AI agents to deliver real‑time, trustworthy Clix documentation and SDK code examples for seamless integrations right inside any MCP‑compatible client.

## Clix MCP Server

<div
  style={{
display: "inline-flex",
gap: 8,
alignItems: "center",
flexWrap: "wrap",
}}
>
  <a
    href="https://www.npmjs.com/package/@clix-so/clix-mcp-server"
    aria-label="View the Clix MCP Server package on npm"
    title="View the Clix MCP Server package on npm"
    style={{
  textDecoration: "none",
  borderBottom: "none",
  backgroundImage: "none",
  boxShadow: "none",
  display: "inline-block",
}}
  >
    <span style={{ position: "absolute", width: 1, height: 1, padding: 0, margin: -1, overflow: "hidden", clip: "rect(0, 0, 0, 0)", whiteSpace: "nowrap", border: 0 }}>
      View the Clix MCP Server package on npm
    </span>

    <img alt="npm version" src="https://img.shields.io/npm/v/%40clix-so%2Fclix-mcp-server.svg?logo=npm&label=npm" style={{ display: "block" }} />
  </a>

  <a
    href="https://www.npmjs.com/package/@clix-so/clix-mcp-server"
    aria-label="View Clix MCP Server download stats on npm"
    title="View Clix MCP Server download stats on npm"
    style={{
  textDecoration: "none",
  borderBottom: "none",
  backgroundImage: "none",
  boxShadow: "none",
  display: "inline-block",
}}
  >
    <span style={{ position: "absolute", width: 1, height: 1, padding: 0, margin: -1, overflow: "hidden", clip: "rect(0, 0, 0, 0)", whiteSpace: "nowrap", border: 0 }}>
      View Clix MCP Server download stats on npm
    </span>

    <img alt="npm downloads" src="https://img.shields.io/npm/d18m/%40clix-so%2Fclix-mcp-server.svg" style={{ display: "block" }} />
  </a>
</div>

Clix MCP Server implements the
[Model Context Protocol (MCP)](https://modelcontextprotocol.io/), an open
standard for enabling LLMs to interact with external tools and data.

Key capabilities:

* **Documentation Search** — Search across Clix docs (user guides, API reference,
  troubleshooting, best practices) with semantic ranking.
* **SDK Search** — Search across Clix SDKs (iOS, Android, Flutter, React Native) and
  implementation examples. Discover SDK symbols and retrieve production‑ready
  snippets.

## Integration Guide

### Requirements

* Node.js 18 or above
* An MCP-compatible client (e.g., Cursor, Visual Studio Code, Claude Code CLI, Codex CLI, Gemini CLI)

### Install

<CodeGroup>
  ```bash npm theme={null}
  npm i -g @clix-so/clix-mcp-server@latest
  ```

  ```bash yarn theme={null}
  yarn global add @clix-so/clix-mcp-server@latest
  ```
</CodeGroup>

### Configure .mcp.json

Create or update the `.mcp.json` at your project root (or the configuration location your MCP client uses).

Recommended configuration using `npx`:

```json theme={null}
{
  "mcpServers": {
    "clix-mcp-server": {
      "command": "npx",
      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
    }
  }
}
```

### Use Clix MCP Server with Popular MCP Clients and IDEs

<Tabs>
  <Tab title="Android Studio">
    <p><strong>Option 1: GitHub Copilot plugin in Android Studio</strong></p>

    1. Add GitHub Copilot plugin to Android Studio by clicking **File** (**Android Studio** on MacOS) > **Settings** > **Plugins** > **GitHub Copilot - Your AI Pair Programmer**
    2. Configure the Clix MCP Server by clicking **File** (**Android Studio** on MacOS) > **Settings** > **Tools** > **GitHub Copilot** > **Model Context Protocol (MCP)** > **Configure**
    3. Add the Clix MCP Server configuration to the `mcp.json`

    ```json theme={null}
    {
      "mcpServers": {
        "clix-mcp-server": {
          "command": "npx",
          "args": ["-y", "@clix-so/clix-mcp-server@latest"]
        }
      }
    }
    ```

    <p><strong>Option 2: Using MCP Server plugin from JetBrains with popular MCP Clients</strong></p>
    This option allows developers to work in an MCP client while still using Android Studio IDE features via the JetBrains MCP server.

    1. Install the MCP Server plugin from JetBrains by clicking **File** (**Android Studio** on MacOS) > **Settings** > **Plugins** > **MCP Plugin**
    2. Add the Clix MCP Server and JetBrains MCP proxy configuration to your MCP client.

    ```json theme={null}
    {
      "mcpServers": {
        "clix-mcp-server": {
          "command": "npx",
          "args": ["-y", "@clix-so/clix-mcp-server@latest"]
        },
        "jetbrains": {
          "command": "npx",
          "args": ["-y", "@jetbrains/mcp-proxy"]
        }
      }
    }
    ```

    3. Open the Android Studio and your MCP client at the same time, and use your MCP client to work on your project.

    <p><strong>Option 3: Gemini in Android Studio's Agent</strong></p>

    1. [Add an MCP server to Gemini in Android Studio](https://developer.android.com/studio/gemini/add-mcp-server)
    2. Add the Clix MCP Server configuration to the `mcp.json`

    ```json theme={null}
    {
     "mcpServers": {
       "clix-mcp-server": {
         "command": "npx",
         "args": ["-y", "@clix-so/clix-mcp-server@latest"]
       }
     }
    }
    ```
  </Tab>

  <Tab title="Xcode">
    <p><strong>Option 1: GitHub Copilot for Xcode</strong></p>

    <ol>
      <li>
        <a href="https://github.com/github/CopilotForXcode" target="_blank" rel="noopener noreferrer">
          Install the GitHub Copilot for Xcode
        </a>
      </li>

      <li>
        Open GitHub Copilot for Xcode settings and navigate to <strong>MCP Configuration</strong> > <strong>Edit Config</strong>
      </li>

      <li>Add the following Clix MCP Server configuration:</li>
    </ol>

    ```json theme={null}
    {
      "servers": {
        "clix-mcp-server": {
          "command": "npx",
          "args": ["-y", "@clix-so/clix-mcp-server@latest"]
        }
      }
    }
    ```

    <p><strong>Option 2: Use XcodeBuildMCP with other MCP clients</strong></p>
    <p>This option lets developers keep working inside popular MCP clients while relying on native Xcode features via XcodeBuildMCP.</p>

    <ol>
      <li>Add the Clix MCP Server and XcodeBuildMCP to your MCP client:</li>
    </ol>

    ```json theme={null}
    {
      "mcpServers": {
        "clix-mcp-server": {
          "command": "npx",
          "args": ["-y", "@clix-so/clix-mcp-server@latest"]
        },
        "XcodeBuildMCP": {
          "command": "npx",
          "args": ["-y", "xcodebuildmcp@latest"]
        }
      }
    }
    ```

    <ol start="2">
      <li>Open Xcode and your MCP client simultaneously, then use the MCP client to continue development.</li>
    </ol>
  </Tab>

  <Tab title="Cursor">
    <a href="https://cursor.com/en-US/install-mcp?name=Clix%20MCP%20Server&config=eyJjb21tYW5kIjoibnB4IC15IEBjbGl4LXNvL2NsaXgtbWNwLXNlcnZlckBsYXRlc3QifQ%3D%3D" target="_blank" rel="noopener noreferrer" aria-label="Install Clix MCP Server in Cursor" title="Install Clix MCP Server in Cursor">
      <span style={{ position: "absolute", width: 1, height: 1, padding: 0, margin: -1, overflow: "hidden", clip: "rect(0, 0, 0, 0)", whiteSpace: "nowrap", border: 0 }}>
        Install Clix MCP Server in Cursor
      </span>

      <img src="https://cursor.com/deeplink/mcp-install-light.svg" alt="Add Clix MCP Server to Cursor" height="32" style={{ pointerEvents: 'none' }} />
    </a>

    <p><strong>Manual setup</strong></p>

    <ul>
      <li> Open Cursor Settings </li>
      <li> Select Tool & MCP </li>
      <li> Select New MCP Server </li>
      <li> Paste the following JSON into the configuration, then restart Cursor.</li>
    </ul>

    ```json theme={null}
    {
      "mcpServers": {
        "clix-mcp-server": {
          "command": "npx",
          "args": ["-y", "@clix-so/clix-mcp-server@latest"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="AmazonQ">
    <p><strong>Manual setup</strong></p>

    <ul>
      <li>Open your Amazon Q configuration file at <code>\~/.aws/amazonq/agents/default.json</code></li>
      <li>Add the following Clix MCP Server configuration to the <code>mcpServers</code> section:</li>
    </ul>

    ```json theme={null}
    "mcpServers": {
      "clix-mcp-server": {
        "command": "npx",
        "args": ["-y", "@clix-so/clix-mcp-server@latest"]
      }
    }
    ```
  </Tab>

  <Tab title="Google Antigravity">
    <p><strong>Manual setup</strong></p>

    <ul>
      <li> Open the Agent tab in Google Antigravity's interface. </li>
      <li> Click the ellipsis (...) located at the top-right corner of the Agent tab. </li>
      <li> Select MCP Server → Manage MCP Servers from the menu. </li>
      <li> Add the Clix MCP Server configuration to your `mcp_config.json` file: </li>

      ```json theme={null}
      {
        "mcpServers": {
          "clix-mcp-server": {
            "command": "npx",
            "args": ["-y", "@clix-so/clix-mcp-server@latest"]
          }
        }
      }
      ```
    </ul>
  </Tab>

  <Tab title="VS Code">
    <a href="https://insiders.vscode.dev/redirect/mcp/install?name=clix-mcp-server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40clix-so%2Fclix-mcp-server%40latest%22%5D%7D" target="_blank" rel="noopener noreferrer" aria-label="Install Clix MCP Server in VS Code" title="Install Clix MCP Server in VS Code">
      <span style={{ position: "absolute", width: 1, height: 1, padding: 0, margin: -1, overflow: "hidden", clip: "rect(0, 0, 0, 0)", whiteSpace: "nowrap", border: 0 }}>
        Install Clix MCP Server in VS Code
      </span>

      <img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code" height="32" style={{ pointerEvents: 'none' }} />
    </a>

    <p><strong>Manual setup</strong></p>

    <ul>
      <li> Open `~/.vscode/mcp.json` </li>
      <li> Paste the following JSON into the configuration, then restart VS Code.</li>

      ```json theme={null}
      {
        "mcpServers": {
          "clix-mcp-server": {
            "command": "npx",
            "args": ["-y", "@clix-so/clix-mcp-server@latest"]
          }
        }
      }
      ```
    </ul>
  </Tab>

  <Tab title="Claude Code CLI">
    <p><strong>Setup</strong></p>

    <ul>
      <li> Open your terminal to access the Claude Code CLI </li>
      <li> Run the following command to register the Clix MCP Server.</li>
    </ul>

    ```bash theme={null}
    claude mcp add --transport stdio clix-mcp-server -- npx -y @clix-so/clix-mcp-server@latest
    ```

    <p><strong>Alternative option</strong></p>
    <p>Install Clix MCP Server via Marketplace</p>

    ```bash theme={null}
    /plugin marketplace add clix-so/clix-mcp-server
    ```
  </Tab>

  <Tab title="Codex CLI">
    <p><strong>Setup</strong></p>

    <ul>
      <li>Open `~/.codex/config.toml` </li>
      <li>Add the following configuration to config.toml and restart Codex CLI.</li>
    </ul>

    ```toml theme={null}
    [mcp_servers]
      [mcp_servers.clix]
      command = "npx"
      args = ["-y", "@clix-so/clix-mcp-server@latest"]
    ```
  </Tab>

  <Tab title="Gemini CLI">
    <p><strong>Setup</strong></p>
    <li><strong>Option 1: Project scope (recommended)</strong></li>

    ```bash theme={null}
    gemini mcp add --scope project clix-mcp-server npx -y @clix-so/clix-mcp-server@latest
    ```

    <li><strong>Option 2: User scope</strong></li>

    ```bash theme={null}
    gemini mcp add --scope user clix-mcp-server npx -y @clix-so/clix-mcp-server@latest
    ```

    <p><strong>Alternative option (manual edit)</strong></p>

    <ul>
      <li>Modify either the user config <code>\~/.gemini/settings.json</code> or the project config <code>.gemini/settings.json</code>.</li>
      <li>Paste the following configuration, then restart Gemini CLI.</li>
    </ul>

    ```json theme={null}
    {
      "mcpServers": {
        "clix-mcp-server": {
          "command": "npx",
          "args": ["-y", "@clix-so/clix-mcp-server@latest"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Kiro CLI">
    <p><strong>Setup</strong></p>

    <ol>
      <li>Create or open the <code>.kiro/settings/mcp.json</code> file in your workspace directory.</li>
      <li>Add the following Clix MCP Server configuration:</li>
    </ol>

    ```json theme={null}
    {
      "mcpServers": {
        "clix-mcp-server": {
          "command": "npx",
          "args": ["-y", "@clix-so/clix-mcp-server@latest"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop App">
    <p><strong>Setup</strong></p>

    <ul>
      <li>
        <p>Open your existing configuration. The file is located at:</p>

        <ul>
          <li>macOS: <code>\~/Library/Application Support/Claude/claude\_desktop\_config.json</code></li>
          <li>Windows: <code>%APPDATA%\Claude\claude\_desktop\_config.json</code></li>
        </ul>
      </li>

      <li>Paste the following JSON into the configuration, then restart the app.</li>
    </ul>

    ```json theme={null}
    {
      "mcpServers": {
        "clix-mcp-server": {
          "command": "npx",
          "args": ["-y", "@clix-so/clix-mcp-server@latest"]
        }
      }
    }
    ```
  </Tab>
</Tabs>

### Build from Source (Optional)

If you prefer to build from source or need the latest development version:

```bash theme={null}
git clone https://github.com/clix-so/clix-mcp-server
cd clix-mcp-server
npm install
npm run build
```

Then configure your `.mcp.json` to point to the built executable:

```json theme={null}
{
  "mcpServers": {
    "clix": {
      "command": "node",
      "args": ["/path/to/clix-mcp-server/dist/index.js"]
    }
  }
}
```

## Feedback & Contributions

We welcome bug reports, feature requests, and community contributions. If you have any feedback, please open an issue or pull request:

* GitHub repository: [https://github.com/clix-so/clix-mcp-server](https://github.com/clix-so/clix-mcp-server)
* Package & release notes: [https://www.npmjs.com/package/@clix-so/clix-mcp-server](https://www.npmjs.com/package/@clix-so/clix-mcp-server)