Claude Code

View Source

You can use Tidewave with Claude Code.

Installation

Rails

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

Phoenix

$ claude mcp add --transport http 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!

Troubleshooting

You can verify the MCP connection is working by starting Claude Code and running the /mcp command. If the status is different from "✔ connected", please double check you are using the correct transport (SSE or HTTP) for your web framework as listed in the configuration above. If you see a 405 error, the root cause is most likely an incorrect transport.

Furthermore, notice that Tidewave does not require authentication, as it runs on your machine and accepts only local connections by default. If you select the "Authenticate" option, it will lead to errors, as Tidewave does not implement any of the authentication endpoints specified by the protocol.