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:
Authentication
Option 1: Browser Login (Recommended)
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
