10‑Minute Quickstart

Hatago MCP Hub lets you manage multiple MCP servers from one place. Follow this guide to get to a working setup quickly.

✅ Prerequisites (1 min)

Check Node.js version
Terminal window
```
node --version  # v20.0.0+
```
Pick your AI client
- Claude Code (recommended)
- Codex CLI
- Cursor / Windsurf

🚀 Install (2 min)

Use npx for zero‑install usage:

# Create config interactively
npx @himorishige/hatago-mcp-hub init

⚙️ Create Config (2 min)

The init command asks only for the integration mode. It does not install or select sample servers for you. You’ll edit the config to add servers in the next step. [ISA]

Select mode

? Select mode:
❯ stdio (for Claude Code)
  http (for debugging)

Confirm file was created
```
✅ Created hatago.config.json
```

In a hurry? Save this as hatago.config.json:

{
  "version": 1,
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

🔌 Connect with Claude Code (2 min)

Prepare Claude Code

Create .mcp.json in your project (the init command does not create this file):

Manual setup

{
  "mcpServers": {
    "hatago": {
      "command": "npx",
      "args": [
        "@himorishige/hatago-mcp-hub",
        "serve",
        "--stdio",
        "--config",
        "./hatago.config.json"
      ]
    }
  }
}

Restart Claude Code (Reload Window) after saving.

✅ Verify (2 min)

Open a new chat in Claude Code
List available tools (e.g. type /tools)
Try the filesystem tool (“list current directory”)
Read internal resource: hatago://servers (via your client’s resource panel or a JSON‑RPC call to resources/read)

Looks good when

You see multiple tools
File operations work
Status shows connected servers

If it fails

Check Node.js version
Restart Claude Code
See Troubleshooting

🎉 Next Steps (1 min)

Add GitHub

Connect to remote APIs via HTTP/SSE

Split by environment

Use tags for dev/prod switching

💡 Tips

npx @himorishige/hatago-mcp-hub serve --http

Then open http://localhost:3535/health

npx @himorishige/hatago-mcp-hub serve --verbose

# Auto-reload with external tools (v0.0.14+)
# Using nodemon
npx nodemon --exec "npx @himorishige/hatago-mcp-hub serve" --watch hatago.config.json