Claude Code ガイド

Appearance

原文（日本語訳） ​

MCP: workspace が予約済みサーバー名になりました。この名前を持つ既存のサーバーは警告付きでスキップされます。

原文（英語） ​

MCP: workspace is now a reserved server name — existing servers with that name will be skipped with a warning

概要 ​

Claude Code において、MCPサーバー名 workspace が予約済みの名前になりました。これはClaude Code内部のワークスペース機能のために確保された名前です。もし workspace という名前でMCPサーバーを設定していた場合、そのサーバーは起動時に警告メッセージとともにスキップされ、機能しなくなります。この破壊的変更に対応するため、既存の設定を確認して名前を変更する必要があります。

基本的な使い方 ​

影響を受ける設定の確認：

bash
# MCP設定ファイルで "workspace" という名前を検索
grep -r '"workspace"' ~/.claude/settings.json .claude/settings.json

修正方法：

workspace という名前のサーバーがあれば別の名前に変更します。

json
// 変更前（動作しなくなる）
{
  "mcpServers": {
    "workspace": {
      "command": "node",
      "args": ["/path/to/my-server.js"]
    }
  }
}

// 変更後（別の名前に変更）
{
  "mcpServers": {
    "my-workspace-tools": {
      "command": "node",
      "args": ["/path/to/my-server.js"]
    }
  }
}

実践例 ​

グローバル設定の確認と修正 ​

bash
# グローバルMCP設定を確認
cat ~/.claude/settings.json | grep -A5 '"workspace"'

workspace サーバーが見つかった場合、~/.claude/settings.json を編集して名前を変更します。

json
{
  "mcpServers": {
    "workspace-server": {  // "workspace" → "workspace-server" に変更
      "command": "uvx",
      "args": ["mcp-server-workspace"]
    }
  }
}

プロジェクト固有設定の確認と修正 ​

bash
# プロジェクトのMCP設定を確認
cat .claude/settings.json | grep -A5 '"workspace"'

プロジェクト設定でも同様に名前を変更します。

警告メッセージの確認 ​

workspace という名前のサーバーが設定されていると、Claude Code起動時に以下のような警告が表示されます：

Warning: MCP server "workspace" is a reserved name and will be skipped.
Please rename this server in your settings.

この警告が表示された場合は速やかに設定ファイルを更新してください。

注意点 ​

  • この変更は破壊的変更です。workspace という名前のMCPサーバーを使用している場合、v2.1.128以降でそのサーバーが動作しなくなります
  • workspace という名前を使用しているかどうかはグローバル設定（~/.claude/settings.json）とプロジェクト設定（.claude/settings.json）の両方を確認してください
  • 名前変更はサーバーの機能には影響しません。設定ファイルのキー名を変更するだけです
  • 予約の理由はClaude CodeのIDEプラグインやワークスペース機能との統合のためと考えられます

関連情報 ​