Installation & Setup

Install fenix-mcp and connect it to Claude Code, Cursor, Copilot, or any MCP-compatible agent.

Prerequisites

Python 3.10+
A Fenix account (sign up free)
A Personal Access Token from your profile settings

Install

# pipx (recommended — isolated environment)
pipx install fenix-mcp

# pip
pip install fenix-mcp

# verify
fenix-mcp --version

Get your API key

Sign in at app.fenix.devshire.app
Go to Profile → API Keys
Click New key, copy the value (fxpat_...)
Export it in your shell:

export FENIX_API_KEY=fxpat_your_token_here

Add this to your shell profile (~/.bashrc, ~/.zshrc, ~/.config/fish/config.fish) so it persists.

Connect to your agent

Claude Code

// ~/.claude/settings.json
{
  "mcpServers": {
    "fenix": {
      "command": "fenix-mcp",
      "env": {
        "FENIX_API_KEY": "fxpat_your_token_here"
      }
    }
  }
}

Or use the CLI shortcut:

claude mcp add fenix -- fenix-mcp

Restart Claude Code. You'll see fenix · connected · 56 actions registered.

Cursor

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "fenix": {
      "command": "fenix-mcp",
      "env": { "FENIX_API_KEY": "fxpat_your_token_here" }
    }
  }
}

Windsurf

// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "fenix": {
      "command": "fenix-mcp",
      "env": { "FENIX_API_KEY": "fxpat_your_token_here" }
    }
  }
}

GitHub Copilot (VS Code)

// VS Code settings.json
{
  "github.copilot.chat.mcpServers": {
    "fenix": {
      "command": "fenix-mcp",
      "env": { "FENIX_API_KEY": "fxpat_your_token_here" }
    }
  }
}

Other agents

All MCP-compatible agents follow the same stdio pattern. Point to the fenix-mcp binary with FENIX_API_KEY in the environment. Refer to each agent's docs for the config file location.

fenix-plugin (no PAT needed)

For Claude Code users, fenix-plugin handles OAuth authentication automatically:

/plugin marketplace add fenix-assistant/fenix-plugin

Environment variables

Variable	Required	Description
`FENIX_API_KEY`	Yes (unless OAuth)	Personal Access Token
`FENIX_API_URL`	No	Override API base URL
`FENIX_LOG_LEVEL`	No	`debug` / `info` / `warn` / `error`
`FENIX_TIMEOUT`	No	Request timeout in seconds (default: 30)

Verify

Ask your agent initialize fenix. The response should list your user, tenant, available teams, and the 12 tool categories.