Claude Desktop
Install Claude Desktop
Install the Claude Desktop application here. Note, the Pro version appears to work much more stably with MCPs.
Install Moose and Aurora CLI
Terminal
bash -i <(curl -fsSL https://fiveonefour.com/install.sh) aurora,moose
Configure Aurora MCP
Create a new project with Claude Desktop MCP preconfigured:
Terminal
aurora init <project-name> <template-name> --mcp claude-desktop
For other options, see Aurora CLI docs.
Adding other toolsets
For more information on available toolsets, see Aurora MCP toolsets. For Claude Desktop, we recommend the following toolsets:
- Moose Read Tools: gives you chat access to your Moose project and the data within it (enabled by default)
- Remote ClickHouse Tools (read only): gives you chat access to your remote ClickHouse data
Using the MCP
- Open the Claude Desktop application (note, you often have to reload the application after adding a new MCP)
- If you are using Moose tools, you will need to run your moose dev server
Warnings / Peculiarities
- You shouldn’t use “write”/generative tools with Claude Desktop.
- Every time you add an MCP or change its configuration, you will need to reload the application.
- If you want to change the Moose Project that the Aurora MCP is referring to, manually edit the MCP.JSON file or run
aurora config focus
and select a new project.
Common issues / troubleshooting
- The MCP is running, but you aren’t able to get your data? Look at the tool call response, it will tell you if your Moose dev server is running. If it is not, run
moose dev
in your Moose project directory. - The MCP is not running. Check your configuration and then restart the application.