MCPサーバー連携
Model Context Protocol(MCP)を使ってClaudeに外部ツールやデータソースを接続する。ファイルシステム・データベース・Web検索・GitHub APIなど、サードパーティのMCPサーバーをsettings.jsonに登録して利用できる。
コマンド・設定オプション42件
この機能に関連するスラッシュコマンド・CLIオプション・設定項目の一覧です。
スラッシュコマンド
Claude Code のインタラクティブセッション内で / から始めて入力するコマンド。
MCP連携
/plugin
プラグインを管理する。`/plugin install <name>@<marketplace>` でインストール、`/plugin marketplace add <repo>` でマーケットプレースを追加できる。
/plugin install fakechat@claude-plugins-official/reload-plugins
再起動せずにすべての有効なプラグインをリロードして変更を適用する。各コンポーネントのリロード件数と読み込みエラーを報告する。
/reload-plugins/plugin list
インストール済みプラグインをインラインで一覧表示する(v2.1.163以降)。`/plugin` メニューを開かずに確認できる。`--enabled` または `--disabled` で絞り込み可能。CLIからは `claude plugin list` でも利用可能。
/plugin list --enabledCLIオプション
`claude` コマンドをターミナルから起動する際に渡すオプション。
MCP連携
claude mcp add
MCPサーバーを追加する。`--transport http/sse/stdio` でトランスポート種別、`--env` で環境変数、`--scope local/project/user` で保存先を指定。stdioサーバーは `--` の後にコマンドと引数を渡す。
claude mcp add --transport http notion https://mcp.notion.com/mcpclaude mcp add-json
JSON文字列でMCPサーバー設定を直接追加する。WebSocket(`type: "ws"`)サーバーなど `--transport` フラグが対応していない設定にも使用する。
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp"}'claude mcp add-from-claude-desktop
Claude Desktopに設定済みのMCPサーバーをインタラクティブに選択してインポートする。macOSとWSLのみ対応。
claude mcp add-from-claude-desktopclaude mcp list
設定済みのMCPサーバーを一覧表示する。承認待ち(Pending approval)や拒否済み(Rejected)の状態も確認できる。
claude mcp listclaude mcp get
指定したMCPサーバーの詳細設定と接続状態を表示する。
claude mcp get githubclaude mcp remove
指定したMCPサーバーの設定を削除する。
claude mcp remove githubclaude mcp reset-project-choices
プロジェクトスコープの `.mcp.json` サーバーに対して行った承認・拒否の選択をリセットする。次回起動時に再度承認を求められる。
claude mcp reset-project-choicesclaude mcp serve
Claude Code自体をstdio MCPサーバーとして起動する。Claude DesktopなどほかのMCPクライアントからClaude Codeをツールとして呼び出せる。
claude mcp serveclaude mcp login
設定済みMCPサーバーのOAuth認証フローを、`/mcp` パネルを開かずにシェルから直接実行する(v2.1.186以降)。HTTP・SSE・claude.aiコネクタに対応。SSH越しでは `--no-browser` で認可URLを表示してリダイレクトURLを貼り戻せる。
claude mcp login sentryclaude mcp logout
MCPサーバーに保存されたOAuth認証情報をクリアする(v2.1.186以降)。再認証や別アカウントへの切り替え前に使用する。
claude mcp logout sentryclaude plugin
Claude Codeプラグインを管理するCLIコマンド。`claude plugins` でも起動可能。インストール・アンインストール・一覧などのサブコマンドを持つ。
claude plugin install code-review@claude-plugins-officialclaude plugin prune
自動インストールされたプラグイン依存関係のうち、現在インストール済みプラグインから参照されていない孤立した依存関係を削除する。`plugin uninstall --prune` でアンインストール時にカスケード削除もできる。
claude plugin pruneclaude plugin init
新しいプラグインのスキャフォールドを生成する。プラグイン名を指定すると必要なディレクトリ構造とファイルを自動生成する。マーケットプレース不要で `.claude/skills/` ディレクトリからも自動ロードされる。
claude plugin init my-plugin--plugin-url
URLからプラグインの `.zip` アーカイブを取得してこのセッション限りで読み込む。マーケットプレースに追加する前に試したい場合や、社内アーティファクトストアからプラグインを配布する場合に便利。フラグを繰り返すか、スペース区切りで複数のURLを指定できる。
claude --plugin-url https://example.com/my-plugin.zip--callback-port
`claude mcp add`でOAuthコールバックに使うポート番号を固定する。事前登録が必要なリダイレクトURIを持つMCPサーバーの認証に使用。
claude mcp add --transport http --callback-port 8080 my-server https://mcp.example.com/mcp--client-id
MCPサーバー追加時に事前設定済みOAuthクライアントIDを指定する。Dynamic Client Registration非対応サーバーの認証に使用。
claude mcp add --transport http --client-id your-client-id --client-secret --callback-port 8080 my-server https://mcp.example.com/mcp--client-secret
MCPサーバー追加時に事前設定済みOAuthクライアントシークレットをマスク入力で指定する。`--client-id`と組み合わせて使用。
claude mcp add --transport http --client-id id --client-secret my-server https://mcp.example.com/mcp設定オプション
`claude config set <key> <value>` または `~/.claude/settings.json` で設定する項目。
MCP連携
ENABLE_CLAUDEAI_MCP_SERVERS
claude.aiコネクタ(MCPサーバー)の読み込みを現在のシェルセッション限りで無効化する環境変数。`false` に設定すると `disableClaudeAiConnectors` 設定と同様の効果が一時的に得られる。
ENABLE_CLAUDEAI_MCP_SERVERS=false claudeMCP_TIMEOUT
MCPサーバーの起動タイムアウトをミリ秒単位で設定する環境変数。起動に時間がかかるサーバーでタイムアウトエラーを防ぐのに使用する。
MCP_TIMEOUT=10000 claudeMCP_TOOL_TIMEOUT
MCPツール呼び出しのタイムアウトをミリ秒単位で設定する環境変数。個別サーバーの `.mcp.json` エントリに `timeout` フィールドを指定するとこの値を上書きできる。
MCP_TOOL_TIMEOUT=600000 claudeMAX_MCP_OUTPUT_TOKENS
MCPツール出力の最大トークン数を設定する環境変数(デフォルト: 25,000トークンで打ち切り、10,000トークン超で警告表示)。大きな出力を返すツールを使う場合に引き上げる。
MAX_MCP_OUTPUT_TOKENS=50000 claudeenabledPlugins
プラグインの有効・無効を制御する。`"plugin-name@marketplace-name": true/false` 形式で設定する。Managed設定での `false` はインストール自体をブロックしてマーケットプレースから非表示にする。
~/.claude/settings.json: {"enabledPlugins": {"code-review@claude-plugins-official": true}}extraKnownMarketplaces
リポジトリで利用可能な追加マーケットプレースを定義する。チームメンバーがフォルダを信頼した際にマーケットプレースのインストールを促す。`github`・`git`・`directory`・`settings` 形式をサポート。
~/.claude/settings.json: {"extraKnownMarketplaces": {"acme-tools": {"source": {"source": "github", "repo": "acme-corp/claude-plugins"}}}}allowManagedMcpServersOnly
(Managed設定専用)`allowedMcpServers` で許可したMCPサーバーのみを適用する。ユーザーはMCPサーバーを追加できるが、管理者定義の許可リストのみが有効になる。`deniedMcpServers` はすべてのソースからマージされる。
managed-settings.json: {"allowManagedMcpServersOnly": true}blockedMarketplaces
(Managed設定専用)ブロックするプラグインマーケットプレースのリスト。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れることなく排除される。
managed-settings.json: {"blockedMarketplaces": [{"source": "github", "repo": "untrusted/plugins"}]}strictKnownMarketplaces
(Managed設定専用)ユーザーが追加できるプラグインマーケットプレースの許可リスト。未設定=制限なし、空配列=完全ロックダウン。マーケットプレースの追加のみに適用。
managed-settings.json: {"strictKnownMarketplaces": [{"source": "github", "repo": "acme-corp/plugins"}]}pluginTrustMessage
(Managed設定専用)プラグインインストール前に表示されるトラスト警告に追加するカスタムメッセージ。社内マーケットプレースのプラグインが審査済みであることを確認するなど、組織固有のコンテキストを追加できる。
managed-settings.json: {"pluginTrustMessage": "All plugins from our marketplace are approved by IT"}CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY
`ANTHROPIC_BASE_URL` がAnthropic互換ゲートウェイを指している場合に、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーのモデル一覧を取得する(v2.1.129以降)。`1` に設定してオプトイン。
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1CLAUDE_AGENT_SDK_MCP_NO_PREFIX
MCPツール名の `mcp__<server>__` プレフィックスを省略する。Agent SDKでMCPツールを使う場合に、プレフィックスなしでツール名を参照したい場合に設定する。
export CLAUDE_AGENT_SDK_MCP_NO_PREFIX=1allowAllClaudeAiMcps
(Team/Enterprise向けManaged設定)`managed-mcp.json` と並んでclaude.aiクラウドMCPコネクタをすべて読み込む。`true` に設定するとOrganization管理のMCPサーバーをユーザーが利用できる。
managed-settings.json: {"allowAllClaudeAiMcps": true}pluginSuggestionMarketplaces
セッション中にプラグイン提案として表示するマーケットプレースを指定する。指定したマーケットプレースのプラグインが推奨候補として提示される。
~/.claude/settings.json: {"pluginSuggestionMarketplaces": [{"source": "github", "repo": "acme-corp/claude-plugins"}]}disableClaudeAiConnectors
claude.aiのMCPコネクタ(クラウド接続)を無効化する(v2.1.182以降)。`allowAllClaudeAiMcps` が有効な場合でもコネクタの読み込みを防ぐ。
~/.claude/settings.json: {"disableClaudeAiConnectors": true}headersHelper
MCPサーバー接続時にHTTPヘッダーを動的生成するコマンドを指定する。Kerberosや短命トークンなどOAuth以外の認証方式に使用。
.mcp.json: {"mcpServers": {"internal-api": {"type": "http", "url": "...", "headersHelper": "/opt/bin/get-headers.sh"}}}disabledMcpServers
`/mcp`パネルでオフに切り替えたユーザー設定・プラグイン・claude.aiコネクタ・デフォルト有効の組み込みサーバーを記録するオプトアウトリスト(`~/.claude.json`)。
~/.claude.json: {"projects": {"/path": {"disabledMcpServers": ["claude.ai Slack"]}}}enabledMcpServers
デフォルトで無効な組み込みMCPサーバー(`computer-use`等)を有効化するオプトインリスト(`~/.claude.json`)。
~/.claude.json: {"projects": {"/path": {"enabledMcpServers": ["computer-use"]}}}CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT
MCPサーバーが応答も進捗通知も返さない場合にツール呼び出しを中断するアイドルタイムアウト(ミリ秒)を設定する。`0`で無効化。
export CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT=600000CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS
メイン会話中のMCPツール呼び出しがバックグラウンドタスクに切り替わるまでの閾値(ミリ秒、デフォルト2分)を設定する。`0`で自動バックグラウンド化を無効化。
export CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=300000ENABLE_TOOL_SEARCH
MCPツールをコンテキストへ事前ロードせず必要時に検索するTool Searchの動作を制御する。`true`/`false`/`auto`/`auto:N`(Nは0〜100の割合)から選択。
ENABLE_TOOL_SEARCH=auto:5 claudeMCP_CLIENT_SECRET
MCPサーバー追加時のOAuthクライアントシークレット入力プロンプトをスキップするための環境変数。CI/CDでの非対話的なサーバー登録に使用。
MCP_CLIENT_SECRET=your-secret claude mcp add --transport http --client-id id --client-secret my-server https://mcp.example.com/mcp関連記事
取得中...