MaxRefMCP uses the Streamable HTTP transport of MCP (Model Context Protocol). Any AI client that supports MCP can connect to it.

Server URL: https://maxrefmcp-production.up.railway.app/mcp

Run the following command in your project directory:

claude mcp add --transport http --scope project max-ref "https://maxrefmcp-production.up.railway.app/mcp"

claude mcp list

If max-ref shows as connected, the setup is complete.

Add the following to your configuration file claude_desktop_config.json:

{
  "mcpServers": {
    "max-ref": {
      "type": "streamable-http",
      "url": "https://maxrefmcp-production.up.railway.app/mcp"
    }
  }
}

After saving, restart Claude Desktop.

To share the configuration across a team or repository, place a .mcp.json file in the project root:

{
  "mcpServers": {
    "max-ref": {
      "type": "http",
      "url": "https://maxrefmcp-production.up.railway.app/mcp"
    }
  }
}

Note: In Claude Code CLI, specify type as "http" (it is internally handled as Streamable HTTP).

Any AI client that supports the MCP Streamable HTTP transport can connect using the following information:

{
  "name": "max-ref",
  "transport": "streamable-http",
  "url": "https://maxrefmcp-production.up.railway.app/mcp"
}

Refer to your client's documentation for client-specific setup instructions.

1. Check the transport type: Use http or streamable-http, not sse
2. Check the URL: Make sure it ends with /mcp
3. Check your network: Visit https://maxrefmcp-production.up.railway.app/ in a browser and verify that the dashboard loads

• Verify that the MCP server connection status is connected
• When you ask the AI a question about Max/MSP, the appropriate tool will be selected automatically