Connect
Connect MiraDock to Claude Desktop
Claude Desktop supports MCP via its JSON configuration file.
Before you start
- You need a MiraDock account. Sign up at /auth/sign-up.
- Generate a write token at /app/mcp.
Configuration
{
"mcpServers": {
"miradock": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://miradock.com/mcp",
"--header",
"Authorization: Bearer <YOUR_TOKEN_HERE>"
]
}
}
}- `mcpServers.miradock` registers MiraDock as a named Claude Desktop MCP server.
- `command: "npx"` launches the remote MCP bridge.
- `mcp-remote` connects Claude Desktop to MiraDock's hosted MCP endpoint.
- `Authorization: Bearer <YOUR_TOKEN_HERE>` authenticates with your MiraDock write token.
Setup walkthrough
- Generate a MiraDock write token from the Your tokens section in /app/mcp.
- Copy the token immediately; it is only shown once.
- Open Claude Desktop Settings > Developer and edit claude_desktop_config.json.
- Paste the JSON above, replace <YOUR_TOKEN_HERE> with the full secret, and save.
- Restart Claude Desktop, then verify the connection with the prompt below.
What success looks like
Claude Desktop should start with MiraDock available as an MCP server in new chats. Newer connector flows can also use the OAuth setup in the Claude.ai guide.
Dock this as a markdown artifact: # Hello from Claude DesktopCommon errors
Error: JSON parse error.
Fix: Validate the JSON; a common issue is missing commas between objects.
Error: Tool not showing up.
Fix: Restart Claude Desktop after saving claude_desktop_config.json.
Error: Token rejected.
Fix: Confirm the header is 'Authorization: Bearer <token>' and that the token has not been revoked.