Skip to main content

Setup with Claude Desktop

The fastest way to connect Claude Desktop to Renovatr is using the .mcpb bundle file.

Step 1: Download the Bundle​

Download the Renovatr MCP bundle:

📦 renovatr-1.0.0.mcpb

Step 2: Install in Claude Desktop​

  1. Open Claude Desktop

  2. Go to Settings → MCP Servers

  3. Click Add from file (or drag and drop the .mcpb file)

  4. Claude Desktop will prompt you for two configuration values:

    • Server URL: Your Renovatr MCP endpoint 
      https://beta.renovatr.app/api/v1/mcp
    • API Key: A project-scoped API key from your Renovatr project settings

  5. Click Save

Step 3: Verify​

Start a new conversation in Claude Desktop and ask:

"List all deliverables in my project"

If everything is configured correctly, Claude will call the list_deliverables tool and show your project's deliverables.

Getting an API Key​

If you don't have an API key yet:

  1. Open your project in Renovatr
  2. Go to Settings
  3. Scroll to API Keys and click Generate API Key
  4. Give it a name like "Claude Desktop"
  5. Select at least View Only permissions (or Full Access for create/update/delete operations)
  6. Copy the key when it's revealed

See Setting Up API Keys for detailed instructions.

Troubleshooting​

"Tool not found" errors​

Make sure the MCP server appears as connected (green indicator) in Claude Desktop settings.

Authentication errors​

Verify your API key is correct and hasn't been revoked. Check the key prefix in your Renovatr project settings.

Connection errors​

Ensure the Server URL is correct and your Renovatr instance is accessible from your machine.