Menu

Claude Desktop Setup

Connect a paso MCP server to Claude Desktop.

Set up paso as an MCP server in Claude Desktop.

1. Install paso

npm install -g usepaso

Or use it locally with npx (no global install needed).

2. Connect

Run this from the directory containing your usepaso.yaml:

usepaso connect claude-desktop
Added "Sentry" in Claude Desktop config.
  Config: ~/Library/Application Support/Claude/claude_desktop_config.json

Restart Claude Desktop to connect.

paso reads your declaration and writes the config entry. If USEPASO_AUTH_TOKEN is not set, it adds a placeholder and prints a warning.

To remove the server later: usepaso disconnect claude-desktop.

3. Restart Claude

Quit Claude completely and relaunch it. The MCP server starts automatically.

Verify Setup

Open Claude and check the Tools menu. You should see your paso capabilities listed as available tools. Try calling one in a conversation to verify.

Multiple Servers

Run usepaso connect claude-desktop from each service’s project directory. paso adds each entry to the same config file.

# In /path/to/sentry/
usepaso connect claude-desktop

# In /path/to/stripe/
usepaso connect claude-desktop

To remove a server: run usepaso disconnect claude-desktop from that service’s directory.

Python

If you installed paso via pip, usepaso connect claude-desktop works the same way. The Python CLI generates the appropriate config entry using the usepaso binary directly.

Troubleshooting

Server doesn’t appear in Claude. Validate the config JSON (a missing comma breaks everything). Quit Claude completely and relaunch (not just close the window).

“command not found”. Use npx usepaso serve (no global install needed). Or install globally: npm install -g usepaso.

Auth failures (401). Check that USEPASO_AUTH_TOKEN is set correctly in the env field. Verify the token has the required API permissions. Run usepaso doctor to check your setup.

Server crashes on start. Run usepaso validate to check for declaration errors. Run usepaso serve directly in a terminal to see the error output.

Claude can now reach your API.

Your capabilities are live in Claude Desktop. Try calling one in a conversation.

Next, you might want to:

  • Quick Start. create your first declaration
  • Testing Capabilities. test before deploying
  • Cursor Setup. connect to Cursor IDE
  • For VS Code and Windsurf: run usepaso connect vscode or usepaso connect windsurf from your project directory. Same pattern.