Claude

View Source

You can use Tidewave with Claude Desktop and Claude Code.

Claude Desktop

To use Tidewave with Claude Desktop, you must first install a mcp-proxy.

Then open up Claude Desktop, go to "Settings" and, under the "Developer" tab, click on "Edit Config". It will point to a file you can open in your favorite editor. Which you must edit to include the following settings:

On macos/Linux:

{
  "mcpServers": {
    "tidewave": {
      "command": "/path/to/mcp-proxy",
      "args": ["http://localhost:$PORT/tidewave/mcp?include_fs_tools=true"]
    }
  }
}

On Windows:

{
  "mcpServers": {
    "tidewave": {
      "command": "/path/to/mcp-proxy.exe",
      "args": ["http://localhost:$PORT/tidewave/mcp?include_fs_tools=true"]
    }
  }
}

Where $PORT is the port your web application is running on.

And you are good to go! Note we enabled filesystem tools by default, as Claude Desktop does not support any filesystem operation out of the box. If your application uses a SQL database, you can verify it all works by asking it to run SELECT 1 as database query. If it fails, check out our Troubleshooting guide.

Claude Code

Adding Tidewave to Claude Code is straight-forward, just run:

$ claude mcp add --transport sse tidewave http://localhost:$PORT/tidewave/mcp

To use it with the mcp-proxy, run:

$ claude mcp add --transport stdio tidewave /path/to/mcp-proxy http://localhost:$PORT/tidewave/mcp

Where $PORT is the port your web application is running on. And you are good to go!