Quick Start - sudocode

Prerequisites

Install Node.js

Ensure Node.js 18+ is installed:

node --version  # Should be v18 or higher

Install sudocode CLI

The MCP server requires the sudocode CLI:

npm install -g @sudocode/cli
sudocode --version

Initialize project

Have a sudocode project initialized:

cd your-project
sudocode init

Install MCP Server

Install the sudocode MCP server globally:

npm install -g @sudocode/mcp

Verify installation:

sudocode-mcp --help

Expected output

sudocode MCP Server

Usage: sudocode-mcp [options]

Options:
  -w, --working-dir <path>  Working directory (default: cwd or SUDOCODE_WORKING_DIR)
  --cli-path <path>         Path to sudocode CLI (default: 'sudocode' or SUDOCODE_PATH)
  --db-path <path>          Database path (default: auto-discover or SUDOCODE_DB)
  --no-sync                 Skip initial sync on startup (default: sync enabled)
  -h, --help                Show this help message

Environment Variables:
  SUDOCODE_WORKING_DIR      Default working directory
  SUDOCODE_PATH             Default CLI path
  SUDOCODE_DB               Default database path

Configure Your Agent

To use the MCP server with your AI agent, you’ll need to configure it in your agent’s settings. See the Agent Setup guide for detailed instructions for:

Claude
Codex
Cursor CLI
Github Copilot CLI
Other MCP-compatible agents

Verify Setup

Test that MCP tools are available:

Ask Claude in Claude Code

You: Create me a "Hello World" issue

Claude: I'll create a "Hello World" issue for you.
[Uses mcp__plugin_sudocode_sudocode__upsert_issue]

Done! I've created issue ISSUE-001: "Hello World"

If you see tool calls like mcp__plugin_sudocode_sudocode__*, the setup is working!

Next Steps

Configure your agent

Follow the Agent Setup guide for your specific AI agent

Review the tools

Study the MCP tools reference

Build workflows

Explore agent workflow examples to see practical patterns

For more details, see the MCP Server Overview.

​Prerequisites

​Install MCP Server

​Configure Your Agent

​Verify Setup

​Next Steps

Prerequisites

Install MCP Server

Configure Your Agent

Verify Setup

Next Steps