Nexus

You run a Nexus MCP Server to let Claude Code and other MCP-compatible assistants interact with your Nexus projects, bugs, milestones, and concepts. It provides a bridge between your Nexus data and AI assistants, enabling you to query, create, update, and organize work through natural language prompts.

How to use

You connect an MCP client to the Nexus MCP Server to start asking questions and issuing actions about your Nexus projects. Common workflows include listing projects, creating or updating bugs, managing milestones and concepts, and promoting ideas into live work items. Use clear prompts that reference your Nexus resources by name, and let the server translate those requests into the appropriate MCP tool calls.

How to install

Prerequisites: ensure you have Node.js installed on your system. You can verify your Node version with node -v and your npm version with npm -v.

Install the MCP Server globally so you can run it from any shell.

Install the package globally using npm.

npm install -g @nexus/mcp-server

Or run it directly with npx without installing a global package.

npx @nexus/mcp-server

If you want to use the server via Claude integration, you can also start it through Claude-specific commands as shown in the integration steps for CLI usage.

Configuration and authentication

Authentication options let you connect securely to your Nexus instance.

Option 1: Browser login (recommended) enables you to authenticate in a browser and saves your API key automatically.

nexus-mcp login

Option 2: Use a manually generated API key for direct authentication.

nexus-mcp auth --key nxk_your_api_key_here

Option 3: Set the API key via an environment variable.

export NEXUS_API_KEY=nxk_your_api_key_here

Server start and usage with Claude Code

To connect Claude Code to your Nexus MCP Server, add the server as an MCP provider. You can use either a direct npm invocation or a local installation depending on your setup.

claude mcp add nexus -- npx @nexus/mcp-server

If you prefer a local installation, run the server locally and point Claude Code to it.

claude mcp add nexus -- nexus-mcp serve

Examples of common tasks

List open bugs for a project called wellness-app.

Create a critical bug for wellness-app with a descriptive title.

Move a project to a new status, such as IN_QA.

Update test credentials for a project with given username and password.

Create a launch milestone for a project with a specific date.

CLI commands overview

Authentication and status: these commands help you manage authentication state and verify current setup.

# Authentication
nexus-mcp login
nexus-mcp auth --key <key>
nexus-mcp status
nexus-mcp logout

# Configuration
nexus-mcp config
nexus-mcp config --url <url>

# Server
nexus-mcp serve

Configuration files and environment variables

Configuration is typically stored under the home directory in a config file that keeps your API key and base URL in one place.

{
  "apiKey": "nxk_...",
  "baseUrl": "https://nexus.app",
  "orgId": "optional-default-org"
}

Environment variables can override configuration if you set them in your shell.

export NEXUS_API_KEY=nxk_your_api_key_here
export NEXUS_API_URL=https://nexus.app

Development and troubleshooting notes

If you are actively developing or testing, you can clone the project, install dependencies, build, and run in development mode.

# 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

Available tools

nexus_list_projects

List all projects with optional status filtering.

nexus_get_project

Get detailed information about a specific project.

nexus_create_project

Create a new project and optionally attach a screenshot.

nexus_update_project

Update project details and credentials.

nexus_update_project_status

Change the current status of a project.

nexus_list_bugs

List all bugs for a given project.

nexus_create_bug

Create a new bug with severity, steps, and related data.

nexus_update_card

Update a card's status, priority, or assignee.

nexus_add_comment

Add a comment to a card.

nexus_list_templates

List available project templates.

nexus_create_template

Create a new project template.

nexus_list_milestones

List milestones with date filtering.

nexus_create_milestone

Create a milestone with associated tasks.

nexus_update_milestone

Update milestone details.

nexus_update_milestone_task

Toggle task completion within a milestone.

nexus_list_concepts

List product concepts.

nexus_get_concept

Get concept details including PRD.

nexus_create_concept

Create a new concept.

nexus_update_concept

Update concept or PRD.

nexus_promote_concept

Promote a concept to a ready project.