Skip to main content

Claude Desktop Setup

Early Access

Try our newest feature! Only available through reach out. Contact us to join the early access program and get priority support.

Prerequisites​

  • Claude Desktop (download from claude.ai)
  • Unizo API key and SCM integration ID
  • Node.js v20 or higher

Setup Instructions​

  1. Install @mcp-remote if not already installed:

    npm i mcp-remote

  2. Open Claude Desktop and navigate to Settings → Developer → Edit Config

  3. Add the Unizo SCM configuration to claude_desktop_config.json:

{
  "mcpServers": {
    "unizo-scm": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://api.unizo.ai/mcp/scm",
        "--allow-http",
        "--header",
        "apikey:${UNIZO_API_KEY}"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

Flags: If npx is producing errors, consider adding -y as the first argument to auto-accept the installation of the mcp-remote package.

{
  "mcpServers": {
    "unizo-scm": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://api.unizo.ai/mcp/scm",
        "--allow-http",
        "--header",
        "apikey:${UNIZO_API_KEY}"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

  1. Save the file and restart Claude Desktop

  2. Verify the connection - The tools may take a minute to appear. You should see SCM tools available in Claude.

Available Tools​

Once configured, you'll have access to:

  • list_repositories - List and search repositories
  • get_file_content - Read files from repositories
  • list_branches - List repository branches
  • list_commits - View commit history
  • create_pull_request - Create new pull requests
  • search_code - Search across codebases

Multiple Integrations​

To work with multiple SCM providers, add separate server instances:

{
  "mcpServers": {
    "unizo-scm": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://api.unizo.ai/mcp/scm",
        "--allow-http",
        "--header",
        "apikey:${UNIZO_API_KEY}"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    },
    "unizo-ticketing": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://api.unizo.ai/mcp/ticketing",
        "--allow-http",
        "--header",
        "apikey:${UNIZO_API_KEY}"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

Troubleshooting​

Tools not appearing​

  • Ensure Claude Desktop is fully restarted
  • Verify your API key is valid
  • Check the Developer Console in Claude Desktop for errors

Connection errors​

  • Verify Node.js v20+ is installed
  • Check that your integration is active in Unizo dashboard

Debug mode​

Add debug environment variables:

{
  "env": {
    "UNIZO_API_KEY": "your_api_key",
  }
}