mcp-claude-desktop.md

Connect Claude Desktop to Grasp

This guide will walk you through hosting Grasp locally and connecting Claude Desktop to it.

Here's a demo video of the final result:

connect-grasp-to-claude.mp4

Prerequisites

• Docker
• Claude Desktop
• Anthropic API Key

Step 1: Host Grasp locally

Run the following commands to pull and start Grasp:

# Pull the image
docker pull getgrasp/grasp

# Run the container
docker run -d \
  --name grasp-agent \
  -p 3000:3000 \
  -e ANTHROPIC_API_KEY=YOUR_ANTHROPIC_KEY \
  getgrasp/grasp

Replace YOUR_ANTHROPIC_KEY with your actual Anthropic API Key.

Once the container is running, open http://localhost:3000 in your browser to access the Grasp console.

Step 2: Connect Claude Desktop to Grasp

1. Make sure the MCP server is running. Visit http://localhost:3000/api/mcp/sse, if you see something like this:

event: endpoint
data: /api/mcp/messages?sessionId=ccefbb26-a890-4417-bffd-1b985a22c09d

Then the MCP server is running properly.

2. Open Claude Desktop and open the settings dialog.

4. Select the "Developer" tab, and click "Edit Config" button.

6. Open the claude_desktop_config.json file, add the following configuration:

{
  "mcpServers": {
    "browser-use": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:3000/api/mcp/sse"]
    }
  }
}

5. After saving the config, restart Claude Desktop. And you can find the MCP icon in the toolbar. You don't need to do anything, it's activated by default.

Step 3: See it in action

1. Send some messages to Claude. If the Claude decides to use the browser, it will open a dialog to ask you to allow using the tool. Click "Allow for this chat" to proceed.

2. Visit http://localhost:3000, you can see a live view of the browser screen and the logs of agent's actions.

3. After the agent is done, it will return the result to Claude, and you can see that Claude replies you with the information.

More

If you have any questions or feedback, feel free to open an issue or join our Discord.