Chans MCP

Copy the configuration for your app below. Replace YOUR_CHANS_API_KEY with a key from Chans Developer settings → API keys.

Use npx with Node.js 22+, or uvx with uv and Python 3.12+. No global package installation is needed. Keep your API key private.

Claude Desktop and Cursor

• Claude Desktop: open Settings → Developer → Edit Config.
• Cursor: open ~/.cursor/mcp.json for your personal configuration.

Paste one of these configurations, save, and restart the app. If mcpServers already exists, add only the chans entry inside it.

With npx

{
  "mcpServers": {
    "chans": {
      "command": "npx",
      "args": ["-y", "@ai-chans/mcp"],
      "env": {
        "CHANS_API_KEY": "YOUR_CHANS_API_KEY"
      }
    }
  }
}

With uvx

{
  "mcpServers": {
    "chans": {
      "command": "uvx",
      "args": ["chans-mcp"],
      "env": {
        "CHANS_API_KEY": "YOUR_CHANS_API_KEY"
      }
    }
  }
}

Setup references: Claude Desktop and Cursor.

Claude Code

Run one command in your terminal:

npx:

claude mcp add --scope user --env CHANS_API_KEY=YOUR_CHANS_API_KEY --transport stdio chans -- npx -y @ai-chans/mcp

uvx:

claude mcp add --scope user --env CHANS_API_KEY=YOUR_CHANS_API_KEY --transport stdio chans -- uvx chans-mcp

Run claude mcp list to check the connection. Inside Claude Code, use /mcp to inspect the server. Claude Code setup reference.

VS Code

Open the Command Palette and run MCP: Open User Configuration. Paste this configuration, save, then use MCP: List Servers to start chans.

{
  "servers": {
    "chans": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@ai-chans/mcp"],
      "env": {
        "CHANS_API_KEY": "YOUR_CHANS_API_KEY"
      }
    }
  }
}

For uvx, change "command" to "uvx" and "args" to ["chans-mcp"]. VS Code uses servers instead of mcpServers. VS Code configuration reference.

Dev behind Cloudflare Access

With version 0.1.3+, add the dev endpoint and your Cloudflare service-token credentials to env:

{
  "mcpServers": {
    "chans-dev": {
      "command": "npx",
      "args": ["-y", "@ai-chans/mcp"],
      "env": {
        "CHANS_MCP_URL": "https://dev-api.chans.ai/mcp/",
        "CHANS_API_KEY": "YOUR_DEV_CHANS_API_KEY",
        "CF_ACCESS_CLIENT_ID": "YOUR_CF_ACCESS_CLIENT_ID",
        "CF_ACCESS_CLIENT_SECRET": "YOUR_CF_ACCESS_CLIENT_SECRET"
      }
    }
  }
}

For uvx, use "command": "uvx" and "args": ["chans-mcp"]. Both Cloudflare values are required together. They are sent as CF-Access-Client-Id and CF-Access-Client-Secret headers alongside the Chans API key, including for doctor. Your Cloudflare Access policy must allow that service token. Cloudflare service-token setup.

Other MCP clients

Choose stdio as the transport and enter:

On Windows, use npx.cmd if your app cannot launch npx. If a command cannot be found, use its full executable path. Chans connects to https://api.chans.ai/mcp/; your API key's scopes determine which tools are available.

Development · Releases