Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Nexus MCP Serverlist open bugs for the wellness-app project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-serverOr use directly with npx:
npx @nexus/mcp-serverAuthentication
Option 1: Browser Login (Recommended)
nexus-mcp loginThis 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_hereOption 3: Environment Variable
export NEXUS_API_KEY=nxk_your_api_key_hereUsage with Claude Code
Add the Nexus MCP server to Claude Code:
claude mcp add nexus -- npx @nexus/mcp-serverOr with a local installation:
claude mcp add nexus -- nexus-mcp serveAvailable Tools
Projects
Tool | Description |
| List all projects with optional status filtering |
| Get detailed project information |
| Create a new project (with optional screenshot) |
| Update project details and test credentials |
| Change project status |
Bugs/Cards
Tool | Description |
| Get all bugs for a project |
| Create a new bug with severity, steps, etc. |
| Update card status, priority, assignee |
| Add a comment to a card |
Templates
Tool | Description |
| List available project templates |
| Create a new template |
Milestones
Tool | Description |
| List milestones with date filtering |
| Create a milestone with tasks |
| Update milestone details |
| Toggle task completion |
Concepts
Tool | Description |
| List product concepts |
| Get concept details with PRD |
| Create a new concept |
| Update concept or PRD |
| 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 |
| API key (overrides config file) |
| 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 devLicense
MIT