Nexus MCP Server
MCP (Model Context Protocol) server for Nexus - AI-assisted Project Delivery Platform.
This allows Claude Code and other MCP-compatible AI assistants to interact with your Nexus projects, bugs, milestones, and concepts.
Installation
npm install -g @nexus/mcp-server
Or use directly with npx:
npx @nexus/mcp-server
Authentication
Option 1: Browser Login (Recommended)
nexus-mcp login
This opens your browser to authenticate with Nexus and automatically saves your API key.
Option 2: Manual API Key
Generate an API key from Nexus Settings, then:
nexus-mcp auth --key nxk_your_api_key_here
Option 3: Environment Variable
export NEXUS_API_KEY=nxk_your_api_key_here
Usage with Claude Code
Add the Nexus MCP server to Claude Code:
claude mcp add nexus -- npx @nexus/mcp-server
Or with a local installation:
claude mcp add nexus -- nexus-mcp serve
Available Tools
Projects
| Tool | Description |
|---|---|
nexus_list_projects | List all projects with optional status filtering |
nexus_get_project | Get detailed project information |
nexus_create_project | Create a new project (with optional screenshot) |
nexus_update_project | Update project details and test credentials |
nexus_update_project_status | Change project status |
Bugs/Cards
| Tool | Description |
|---|---|
nexus_list_bugs | Get all bugs for a project |
nexus_create_bug | Create a new bug with severity, steps, etc. |
nexus_update_card | Update card status, priority, assignee |
nexus_add_comment | Add a comment to a card |
Templates
| Tool | Description |
|---|---|
nexus_list_templates | List available project templates |
nexus_create_template | Create a new template |
Milestones
| Tool | Description |
|---|---|
nexus_list_milestones | List milestones with date filtering |
nexus_create_milestone | Create a milestone with tasks |
nexus_update_milestone | Update milestone details |
nexus_update_milestone_task | Toggle task completion |
Concepts
| Tool | Description |
|---|---|
nexus_list_concepts | List product concepts |
nexus_get_concept | Get concept details with PRD |
nexus_create_concept | Create a new concept |
nexus_update_concept | Update concept or PRD |
nexus_promote_concept | Promote concept to project |
Examples
List open bugs
User: What bugs are open on the wellness-app project?
Claude: [Uses nexus_list_bugs tool]
Create a critical bug
User: Create a critical bug for wellness-app: checkout button doesn't work on mobile
Claude: [Uses nexus_create_bug with severity="CRITICAL"]
Update project status
User: Move wellness-app to QA
Claude: [Uses nexus_update_project_status with status="IN_QA"]
Add test credentials
User: Update test credentials for wellness-app with username: test@example.com, password: Test123!
Claude: [Uses nexus_update_project with testCredentials]
Create a launch milestone
User: Create a launch milestone for wellness-app on January 15th
Claude: [Uses nexus_create_milestone with type="LAUNCH"]
CLI Commands
# Authentication
nexus-mcp login # Browser-based login
nexus-mcp auth --key <key> # Set API key manually
nexus-mcp status # Check auth status
nexus-mcp logout # Remove credentials
# Configuration
nexus-mcp config # Show current config
nexus-mcp config --url <url> # Set custom API URL
# Server
nexus-mcp serve # Start MCP server (default)
Configuration
Configuration is stored in ~/.nexus-mcp/config.json:
{
"apiKey": "nxk_...",
"baseUrl": "https://nexus.app",
"orgId": "optional-default-org"
}
Environment Variables
| Variable | Description |
|---|---|
NEXUS_API_KEY | API key (overrides config file) |
NEXUS_API_URL | API base URL (overrides config file) |
Development
# Clone the repo
git clone https://github.com/your-org/nexus-mcp.git
cd nexus-mcp
# Install dependencies
npm install
# Build
npm run build
# Run in development
npm run dev
License
MIT