Claude Code ガイド

Appearance

MCP サーバー設定に alwaysLoad オプションを追加 ​

原文（日本語に翻訳） ​

MCP サーバー設定に alwaysLoad オプションを追加しました。true に設定すると、そのサーバーのすべてのツールがツール検索の遅延読み込みをスキップし、常に利用可能な状態になります。

原文（英語） ​

Added alwaysLoad option to MCP server config — when true, all tools from that server skip tool-search deferral and are always available

概要 ​

Claude Code v2.1.121 では、MCP サーバーの設定に alwaysLoad オプションが追加されました。通常、MCP ツールは ToolSearch による遅延読み込みが行われますが、alwaysLoad: true を設定したサーバーのツールはセッション開始時から常に利用可能になります。頻繁に使うツールや、遅延読み込みを避けたい重要なサーバーに対して有効です。

基本的な使い方 ​

json
// ~/.claude/settings.json または .claude/settings.json
{
  "mcpServers": {
    "my-database-tools": {
      "command": "npx",
      "args": ["my-db-mcp-server"],
      "alwaysLoad": true
    },
    "occasional-tools": {
      "command": "npx",
      "args": ["occasional-mcp-server"]
      // alwaysLoad なし → ToolSearch で遅延読み込み
    }
  }
}

実践例 ​

データベースツールを常時ロード ​

json
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://localhost/mydb"
      },
      "alwaysLoad": true  // クエリツールを常に利用可能にする
    }
  }
}

CI 環境でのフルロード設定 ​

json
// CI では全ツールを常時ロードしてパフォーマンスを安定させる
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      },
      "alwaysLoad": true
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"],
      "alwaysLoad": true
    }
  }
}

用途別の使い分け ​

json
{
  "mcpServers": {
    // 毎回使うコアツール → alwaysLoad
    "core-tools": {
      "command": "node",
      "args": ["./mcp/core.js"],
      "alwaysLoad": true
    },
    // たまにしか使わないツール → ToolSearch に任せる
    "rare-tools": {
      "command": "node",
      "args": ["./mcp/rare.js"]
    }
  }
}

注意点 ​

  • alwaysLoad: true にすると、セッション開始時にすべてのツールがコンテキストに読み込まれるため、ツール数が多い場合はコンテキストウィンドウを消費します
  • 頻繁に使うサーバーや少数のツールを持つサーバーに絞って alwaysLoad を使うことを推奨します
  • alwaysLoad を設定しないサーバーは従来どおり ToolSearch による動的読み込みが適用されます
  • サーバー接続後に遅延読み込みされたツールが見つからない問題（v2.1.122 で修正済み）は、alwaysLoad でも回避できます

関連情報 ​