mirror of https://github.com/farion1231/cc-switch.git synced 2026-07-24 12:44:18 +08:00

Files

T

makoMakoGo 693c3872f0 docs: refresh user manual for current app support (#3411 )

* docs(usage): document pricing model matching rules

* docs: refresh user manual for current app support

* docs: clarify Hermes configuration files

* docs: align feature docs with visible app support

2026-06-02 22:17:42 +08:00

7.0 KiB

Raw Permalink Blame History

3.1 MCP サーバー管理

MCP とは

MCP (Model Context Protocol) は、AI ツールが外部データソースやツールにアクセスできるようにするプロトコルです。MCP サーバーにより、AI は以下のことが可能になります：

ファイルシステムへのアクセス
ネットワークリクエストの実行
データベースのクエリ
外部 API の呼び出し

MCP パネルを開く

上部ナビゲーションバーの MCP ボタンをクリックします。

パネル概要

MCP サーバーの追加

プリセットテンプレートを使用

右上の + ボタンをクリック
「プリセット」ドロップダウンからテンプレートを選択
必要に応じて設定を変更
「保存」をクリック

主なプリセット

プリセット	パッケージ名	機能説明
fetch	mcp-server-fetch	HTTP リクエストツール、AI が Web コンテンツを取得可能に
time	@modelcontextprotocol/server-time	時間ツール、現在の時刻情報を提供
memory	@modelcontextprotocol/server-memory	メモリツール、AI が情報を保存・検索可能に
sequential-thinking	@modelcontextprotocol/server-sequential-thinking	思考連鎖ツール、AI の推論能力を強化
context7	@upstash/context7-mcp	ドキュメント検索ツール、技術ドキュメントをクエリ

カスタム設定

「カスタム」を選択した場合、以下を入力する必要があります：

フィールド	必須	説明
サーバー ID	はい	一意な識別子
名前	いいえ	表示名
説明	いいえ	機能の説明
転送タイプ	はい	stdio / http / sse
コマンド	はい*	stdio タイプの場合は必須
引数	いいえ	コマンドライン引数
URL	はい*	http/sse タイプの場合は必須
Headers	いいえ	http/sse タイプのリクエストヘッダー
環境変数	いいえ	サーバーに渡す環境変数

転送タイプ

stdio（標準入出力）

最も一般的なタイプで、ローカルプロセスを起動して通信します。

{
  "command": "uvx",
  "args": ["mcp-server-fetch"],
  "env": {}
}

要件：

対応するコマンド（例：uvx、npx）がインストールされている必要あり
サーバープログラムが PATH に含まれている必要あり

http

HTTP プロトコルでリモートサーバーと通信します。

{
  "url": "http://localhost:8080/mcp"
}

sse（Server-Sent Events）

SSE プロトコルでサーバーと通信し、リアルタイムプッシュをサポートします。

{
  "url": "http://localhost:8080/sse"
}

アプリバインド

各 MCP サーバーは、有効にするアプリを個別に制御できます。

スイッチの説明

スイッチ	作用	設定ファイルパス
Claude	Claude Code に同期	`~/.claude.json` の `mcpServers`
Codex	Codex に同期	`~/.codex/config.toml` の `[mcp_servers]`
Gemini	Gemini CLI に同期	`~/.gemini/settings.json` の `mcpServers`
OpenCode	OpenCode に同期	`~/.config/opencode/opencode.json` の `mcp`
Hermes	Hermes に同期	`~/.hermes/config.yaml` の `mcp_servers`

注意：OpenClaw と Claude Desktop は現在 CC Switch MCP 同期に対応していません。MCP 機能は Claude、Codex、Gemini、OpenCode、Hermes に対応しています。

スイッチの動作

あるアプリのスイッチをオンにすると、CC Switch は以下を実行します：

データベースの更新：サーバーの apps.claude/codex/gemini/opencode/hermes のステータスを true に設定
Live 設定に同期：サーバー設定を対応アプリの設定ファイルに書き込み
即時反映：次回 CLI ツール起動時に新しい MCP サーバーが自動的にロード

あるアプリのスイッチをオフにすると、CC Switch は以下を実行します：

データベースの更新：対応アプリのステータスを false に設定
Live 設定から削除：アプリの設定ファイルからそのサーバーを削除
即時反映：次回 CLI ツール起動時にその MCP サーバーはロードされない

同期条件

MCP サーバーの同期は、対応アプリがインストールされている場合のみ実行されます：

Claude：~/.claude/ ディレクトリまたは ~/.claude.json ファイルが存在する必要あり
Codex：~/.codex/ ディレクトリが存在する必要あり
Gemini：~/.gemini/ ディレクトリが存在する必要あり
OpenCode：~/.config/opencode/ ディレクトリが存在する必要あり
Hermes：~/.hermes/ ディレクトリが存在する必要あり

ヒント：CLI ツールがインストールされていない場合、対応するスイッチをオンにしてもエラーにはなりませんが、設定は書き込まれません。

スイッチをオフにすると、設定はファイルから削除されます。

サーバーの編集

サーバー行の右側にある「編集」ボタンをクリック
設定を変更
「保存」をクリック

変更は有効になっているアプリの設定ファイルに即座に同期されます。

サーバーの削除

サーバー行の右側にある「削除」ボタンをクリック
削除を確認

削除後、設定はすべてのアプリの設定ファイルから削除されます。

既存の設定のインポート

CLI ツールで既に MCP サーバーを設定している場合、CC Switch にインポートできます：

「インポート」ボタンをクリック
インポートするアプリを選択（Claude/Codex/Gemini/OpenCode/Hermes）
CC Switch が既存の設定を読み取ってインポート

設定ファイル形式

Claude (`~/.claude.json`)

{
  "mcpServers": {
    "mcp-fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

Codex (`~/.codex/config.toml`)

[mcp_servers.mcp-fetch]
command = "uvx"
args = ["mcp-server-fetch"]

Gemini (`~/.gemini/settings.json`)

{
  "mcpServers": {
    "mcp-fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

よくある質問

サーバーの起動に失敗する

確認事項：

コマンドが正しくインストールされているか（例：uvx）
コマンドが PATH に含まれているか
引数が正しいか

設定が反映されない