Olenro
拡張機能

MCP サーバー管理

MCP とは

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

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

MCP パネルを開く

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

パネル概要

image-20260108005723522

MCP サーバーの追加

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

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

image-20260108005739731

主なプリセット

プリセットパッケージ名機能説明
fetchmcp-server-fetchHTTP リクエストツール、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": {}
}

要件

  • 対応するコマンド(例:uvxnpx)がインストールされている必要あり
  • サーバープログラムが PATH に含まれている必要あり

http

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

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

sse(Server-Sent Events)

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

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

アプリバインド

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

スイッチの説明

スイッチ作用設定ファイルパス
ClaudeClaude Code に同期~/.claude.jsonmcpServers
CodexCodex に同期~/.codex/config.toml[mcp_servers]
GeminiGemini CLI に同期~/.gemini/settings.jsonmcpServers
OpenCodeOpenCode に同期~/.opencode/config.jsonmcpServers

注意:OpenClaw は現在 MCP サーバー管理に対応していません。MCP 機能は現在 Claude、Codex、Gemini、OpenCode の 4 つのアプリのみサポートしています。

スイッチの動作

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

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

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

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

同期条件

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

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

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

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

サーバーの編集

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

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

サーバーの削除

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

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

既存の設定のインポート

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

  1. 「インポート」ボタンをクリック
  2. インポートするアプリを選択(Claude/Codex/Gemini/OpenCode)
  3. Olenro が既存の設定を読み取ってインポート

設定ファイル形式

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 に含まれているか
  • 引数が正しいか

設定が反映されない

確認事項:

  • 対応するアプリのスイッチがオンになっているか
  • CLI ツールを再起動したか

目次