10分クイックスタート

Hatago MCP Hubを使って、複数のMCPサーバーを10分で統合管理できるようにします。このガイドに従えば、すぐに動作確認まで完了します。

📋 前提条件の確認（1分）

Node.jsのバージョン確認
Terminal window
```
node --version  # v20.0.0以上が必要
```
使用するAIツールの確認
- Claude Code（推奨）
- Codex CLI
- Cursor / Windsurf

🚀 インストール（2分）

最も簡単な方法はnpxを使うことです。インストール不要ですぐに使えます：

# 設定ファイルの初期化（対話型）
npx @himorishige/hatago-mcp-hub init

⚙️ 設定作成（2分）

initコマンドを実行すると、対話型で設定を作成できます：

モードを選択

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

Claude Codeならstdioを選びます。

サンプルサーバーを選択

? Select sample servers: (Space to select, Enter to confirm)
❯ ◉ filesystem - Browse and read files
  ◯ github - GitHub API access
  ◯ memory - Persistent memory storage

試したいサーバーをスペースキーで選択します。

設定ファイルの作成確認

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

急いでいる場合は、以下の最小設定をhatago.config.jsonとして保存：

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

🔌 Claude Codeとの接続（2分）

自動設定の場合

initコマンドで.mcp.jsonが自動生成されています。Claude Codeを再起動するだけで接続完了です。

手動設定の場合

プロジェクトルートに.mcp.jsonを作成：

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

✅ 動作確認（2分）

Claude Codeで新しいチャットを開く

利用可能なツールを確認

利用可能なツールを表示して

または

/tools

ファイルシステムツールをテスト

現在のディレクトリのファイル一覧を表示して

内部リソースを確認

hatago://servers を読み取る（クライアントのリソース機能、または JSON-RPC `resources/read`）

接続されているサーバー一覧が JSON で表示される。

✅ 成功の確認

複数のツールが表示される - ファイル操作が実行できる - サーバーステータスが確認できる

❌ うまくいかない場合

Node.jsのバージョンを確認 - Claude Codeを再起動 - トラブルシューティングを参照

🎉 完了！次のステップ（1分）

おめでとうございます！Hatago MCP Hubが動作しています。次は以下を試してみてください：

GitHubサーバーを追加

リモートサーバーの設定でGitHub APIと連携

環境ごとに設定を分ける

タグベースフィルタリングで開発/本番を切り替え

チームで共有

設定の継承で共通ベースを共有

💡 ヒント

開発中はHTTPモードが便利です： bash npx @himorishige/hatago-mcp-hub serve --http ブラウザで http://localhost:3535/health にアクセスして確認できます。

詳細なログが必要な場合： bash npx @himorishige/hatago-mcp-hub serve --verbose

設定ファイルの変更を監視： bash npx @himorishige/hatago-mcp-hub serve --watch