Skip to main content

Claude Desktop

Claude Desktop is a great way to experience MCP servers from the people who created the protocol! It provides a chat interface to Anthropic's latest models and runs on macos and windows.

Video​

Quick Install / Remote​

For a quick, automated setup, run this command in your terminal:

npx --yes -p @dylibso/mcpx@latest install --client claude-desktop --url "https://www.mcp.run/api/mcp/sse?profile=<scope-name>/<profilename>"
Profile name

Replace the profile query paramter with any profile you have access to. For example, if your user name is benjamin, you could use benjamin/default. If you belong to the org dylibso which has a engineering profile, you could set it to dylibso/engineering.

See a list of your profiles here.

Manual Steps / Local​

  1. Install Claude Desktop from Anthropic
  2. Open it up and authenticate to Claude
  3. Edit your config file at:
  • Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/config.json
If you can't find the file

Open Claude Desktop, open the Settings menu, go to the Developer section and click Edit Config inside the servers section. Open and edit this file using the instructions below.

  1. Add the following to your config file under the "mcpServers" key:
{
  "mcpServers": {
    "mcpx": {
      "command": "npx",
      "args": [
        "--yes",
        "@dylibso/mcpx"
      ]
    }
  }
}
If you have existing claude_desktop_config.json

If you have existing mcpServers, add "mcpx" alongside them while maintaining valid JSON.

  1. Restart Claude Desktop (quit & re-open the app)
  2. You should see the little hammer tool appear in the bottom right section of your prompt input.
  3. Log in to mcp.run by prompting "log me in to mcp.run" and follow the instructions.
Up to date instructions

If you get stuck, please refer to Claude Desktop's guide as it should remain up to date.