クイックスタート

Hatago MCP Hubを使って、複数のMCPサーバーを統合管理する環境を5分で構築します。

前提条件

• Node.js 20以上
• npm または pnpm
• Claude Code、Codex CLI、またはその他のMCP対応ツール

1. 設定ファイルの初期化

まず、設定ファイルを作成します：

npx @himorishige/hatago-mcp-hub init

対話型プロンプトで以下を選択します：

1. モード: stdio（Claude Code用）または http（デバッグ用）
2. 設定ファイル名: デフォルトの hatago.config.json を推奨
3. MCPサーバー: 使用したいサーバーを選択

2. Claude Codeへの設定

自動設定

初期化時に自動的に .mcp.json が生成されます：

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

手動設定

.mcp.json を手動で作成・編集する場合：

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

3. サーバーの起動

Claude Codeを再起動すると、Hatagoが自動的に起動します。

手動でテストする場合：

# STDIOモード（本番用）
npx @himorishige/hatago-mcp-hub serve --stdio --config ./hatago.config.json

# HTTPモード（デバッグ用）
npx @himorishige/hatago-mcp-hub serve --http

4. 動作確認

Claude Codeで以下のコマンドを実行して確認：

/tools

Hatagoが管理するすべてのMCPサーバーのツールが表示されれば成功です。

設定例

基本的な設定

{
  "$schema": "https://raw.githubusercontent.com/himorishige/hatago-hub/main/schemas/config.schema.json",
  "version": 1,
  "logLevel": "info",
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

リモートサーバーを含む設定

{
  "mcpServers": {
    "local-fs": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "remote-api": {
      "url": "https://api.example.com/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

トラブルシューティング

よくある問題と解決方法

環境変数が展開されない

環境変数が設定されているか確認：

echo $GITHUB_TOKEN

設定されていない場合は、エクスポート：

export GITHUB_TOKEN="your-token-here"

またはデフォルト値を使用：

{
  "env": {
    "GITHUB_TOKEN": "${GITHUB_TOKEN:-default-value}"
  }
}

サーバーが起動しない

1. Node.jsバージョンを確認：

   node --version  # v20以上が必要

2. ログレベルを上げてデバッグ：

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

3. 設定ファイルの検証：

   cat hatago.config.json | jq .  # JSON構文チェック

ツールが表示されない

1. 内部リソースで確認：

   { "jsonrpc": "2.0", "method": "resources/read", "id": 1, "params": { "uri": "hatago://servers" } }

2. 個別サーバーの状態を確認

3. 変更反映が必要なときは --watch を付けて起動、または再起動

次のステップ

• インストールガイド - 詳細なインストール方法
• 設定リファレンス - 高度な設定オプション
• リモートサーバー接続 - HTTPベースのMCPサーバー
• タグベースフィルタリング - 環境ごとのサーバー管理