Skip to content
🏮 Hatago MCP Hub

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)

Section titled “✅ Prerequisites (1 min)”

  1. Check Node.js version

    Terminal window
    node --version  # v20.0.0+

  2. Pick your AI client

    • Claude Code (recommended)
    • Codex CLI
    • Cursor / Windsurf

🚀 Install (2 min)

Section titled “🚀 Install (2 min)”

Use npx for zero‑install usage:

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

⚙️ Create Config (2 min)

Section titled “⚙️ Create Config (2 min)”

The init command walks you through an interactive setup.

  1. Select mode

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

  2. Pick sample servers (e.g. filesystem)

  3. Confirm files were created

    ✅ Created hatago.config.json
    ✅ Created .mcp.json (for Claude Code)

🔌 Connect with Claude Code (2 min)

Section titled “🔌 Connect with Claude Code (2 min)”

If auto‑generated

Section titled “If auto‑generated”

.mcp.json is already created by init. Restart Claude Code.

Manual setup

Section titled “Manual setup”
{
  "mcpServers": {
    "hatago": {
      "command": "npx",
      "args": [
        "@himorishige/hatago-mcp-hub",
        "serve",
        "--stdio",
        "--config",
        "./hatago.config.json"
      ]
    }
  }
}

✅ Verify (2 min)

Section titled “✅ Verify (2 min)”
  1. Open a new chat in Claude Code
  2. List available tools (e.g. type /tools)
  3. Try the filesystem tool (“list current directory”)
  4. 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

🎉 Next Steps (1 min)

Section titled “🎉 Next Steps (1 min)”

Add GitHub

Connect to remote APIs via HTTP/SSE

Split by environment

Use tags for dev/prod switching

💡 Tips

Section titled “💡 Tips”
Terminal window
npx @himorishige/hatago-mcp-hub serve --http

Then open http://localhost:3535/health