> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sudocode.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get sudocode MCP server running in minutes

## Prerequisites

<Steps>
  <Step title="Install Node.js">
    Ensure Node.js 18+ is installed:

    ```bash theme={null}
    node --version  # Should be v18 or higher
    ```
  </Step>

  <Step title="Install sudocode CLI">
    The MCP server requires the sudocode CLI:

    ```bash theme={null}
    npm install -g @sudocode/cli
    sudocode --version
    ```
  </Step>

  <Step title="Initialize project">
    Have a sudocode project initialized:

    ```bash theme={null}
    cd your-project
    sudocode init
    ```
  </Step>
</Steps>

## Install MCP Server

Install the sudocode MCP server globally:

```bash theme={null}
npm install -g @sudocode/mcp
```

Verify installation:

```bash theme={null}
sudocode-mcp --help
```

<Accordion title="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
  ```
</Accordion>

## 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](/quickstart#step-4:-set-up-your-agent-optional) for detailed instructions for:

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

## Verify Setup

Test that MCP tools are available:

<Accordion title="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"
  ```
</Accordion>

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

## Next Steps

<Steps>
  <Step title="Configure your agent">
    Follow the [Agent Setup guide](/quickstart#step-4%3A-set-up-your-agent-optional) for your specific AI agent
  </Step>

  <Step title="Review the tools">
    Study the [MCP tools reference](/mcp/overview#mcp-tools-reference)
  </Step>

  <Step title="Build workflows">
    Explore [agent workflow examples](/mcp/workflows) to see practical patterns
  </Step>
</Steps>

For more details, see the [MCP Server Overview](/mcp/overview).