メインコンテンツまでスキップ

MCP サーバーの追加

このページでは、Elftia で MCP サーバーを追加して設定する方法を説明します。Elftia は 3 種類のトランスポートをサポートしており、それぞれ設定手順が少し異なります。

MCP 管理ページを開く​

  1. 左側のナビゲーションバーで MCP Servers ページをクリックします
  2. 右上の Add ボタンをクリックします
  3. 表示されたフォームで Form Input モードを選択します
ヒント

JSON Import モードを使ってサーバーを一括追加することもできます。詳しくは JSON 一括インポート を参照してください。

Stdio サーバーの追加​

Stdio は最も一般的なトランスポートで、ローカルのコマンドラインから起動する MCP サーバー(npm や pip パッケージなど)に使用されます。

設定手順​

  1. Server name — 認識しやすい名前を入力します(例: filesystem)
  2. Transport type — Stdio を選択します
  3. Command — サーバーを起動するコマンドを入力します(例: npx)
  4. Arguments — 1 行に 1 つずつ引数を入力します:
    -y
    @modelcontextprotocol/server-filesystem
    /path/to/allowed/directory
  5. Environment variables(任意)— KEY=VALUE 形式で 1 行に 1 つずつ入力します:
    API_KEY=your-api-key
    DEBUG=true
  6. Save をクリックします

設定フィールドの説明​

フィールド必須説明
Server nameはい一意の識別子。既存のサーバー名と重複してはいけません
Commandはい実行可能なコマンド。例: npx、uvx、node、python
Argumentsいいえコマンドに渡す引数のリスト。1 行に 1 つずつ指定します
Environment variablesいいえ子プロセス用の追加環境変数。現在のシステム環境を継承します

一般的な Stdio サーバーの例​

ファイルシステムサーバー:

フィールド値
Commandnpx
Arguments-y , @modelcontextprotocol/server-filesystem , /Users/yourname/Documents

Brave Search サーバー:

フィールド値
Commandnpx
Arguments-y , @modelcontextprotocol/server-brave-search@latest
Environment variablesBRAVE_API_KEY=your-brave-api-key

Tavily Search サーバー:

フィールド値
Commandnpx
Arguments-y , tavily-mcp@latest
Environment variablesTAVILY_API_KEY=your-tavily-api-key

SSE サーバーの追加​

SSE(Server-Sent Events)は、HTTP の長時間接続で通信するリモートホスト型の MCP サーバーに使用されます。

設定手順​

  1. Server name — 名前を入力します(例: web-search)
  2. Transport type — SSE を選択します
  3. URL — サーバーの SSE エンドポイントアドレスを入力します
  4. Request headers(任意)— Key=Value 形式で 1 行に 1 つずつ入力します:
    Authorization=Bearer your-token
    X-API-Key=your-api-key
  5. Environment variables(任意)— Stdio と同じです
  6. Save をクリックします

設定フィールドの説明​

フィールド必須説明
Server nameはい一意の識別子
URLはいMCP サーバーの SSE エンドポイント URL
Request headersいいえ認証などに使用する HTTP リクエストヘッダー
Environment variablesいいえ追加の環境変数

SSE サーバーの例​

Zhipu Web Search:

フィールド値
URLhttps://api.z.ai/api/mcp/web_search_prime/mcp
Request headersAuthorization=Bearer your-zhipu-api-key

HTTP サーバーの追加​

HTTP トランスポート(Streamable HTTP)は MCP 2025-03-26 仕様に基づく、より新しいトランスポートオプションです。

設定手順​

  1. Server name — 名前を入力します
  2. Transport type — HTTP を選択します
  3. URL — サーバーの HTTP エンドポイントアドレスを入力します
  4. Request headers(任意)— SSE と同じです
  5. Save をクリックします

設定フィールドの説明​

使用するトランスポートプロトコルだけが異なり、それ以外は SSE と同じです。

フィールド必須説明
Server nameはい一意の識別子
URLはいMCP サーバーの HTTP エンドポイント URL
Request headersいいえHTTP リクエストヘッダー
Environment variablesいいえ追加の環境変数

HTTP サーバーの例​

Zhipu Web Reader:

フィールド値
URLhttps://api.z.ai/api/mcp/web_reader/mcp
Request headersAuthorization=Bearer your-zhipu-api-key

依存関係チェック​

Stdio サーバーを追加するとき、Elftia は必要な CLI ツールがインストールされているかを自動的に確認します:

コマンド確認内容自動インストール方法
npx / npm / nodeNode.js ランタイムWindows: winget; macOS: Homebrew; その他: 手動インストールを案内
uv / uvxuv Python パッケージマネージャー公式インストールスクリプトで自動インストール

不足している依存関係が検出されると、Elftia は自動インストール、または手動ダウンロードページへのリンクを提示するプロンプトを表示します。

依存関係チェックの動作​

  • まずシステム PATH でコマンドを探します
  • 見つからない場合は、一般的なインストールディレクトリ(~/.local/bin、~/.cargo/bin、npm グローバルディレクトリなど)を自動的にスキャンします
  • インストール後、利用可能かどうかを自動的に確認します
  • 自動インストールできない依存関係については、ダウンロードページへのリンクを提供します

接続をテストする​

サーバーを追加したら、すぐに接続をテストすることをおすすめします:

  1. MCP サーバー一覧で対象のサーバーを見つけます
  2. Test ボタンをクリックします
  3. 接続とツール検出が完了するまで待ちます
  4. 成功すると、ツール名の一覧とともに Connected successfully. Found N tools. というメッセージが表示されます

公式プリセットを使用する​

Elftia には、ワンクリックインストールに対応した一般的な MCP サーバー向けのプリセット設定が含まれています:

  1. MCP Servers ページで Official タブに切り替えます
  2. 利用可能なプリセットを参照します(カテゴリでフィルター: 検索、ビジョン、Web 閲覧、コードリポジトリなど)
  3. Install ボタンをクリックします
  4. API キーが必要な場合、システムは設定済みの LLM プロバイダーから自動関連付けを試みます。見つからない場合は、手動で入力する必要があります

現在サポートされている公式プリセット:

プリセットカテゴリトランスポートAPI キーが必要
MiniMax Coding Plan MCP汎用Stdioはい
Zhipu Vision MCPビジョンStdioはい
Zhipu Web Search検索HTTPはい
Zhipu Web ReaderWeb 閲覧HTTPはい
Zhipu ZreadコードリポジトリHTTPはい
Tavily Search検索Stdioはい
Brave Search検索Stdioはい

トラブルシューティング​

コマンドが見つからない​

症状: Stdio サーバーを追加するときに、コマンドが存在しないというメッセージが表示される。

解決策:

  • 関連するランタイムがインストールされていることを確認します(Node.js、Python など)
  • ターミナルでコマンドを手動実行して確認します
  • Elftia を再起動して PATH 環境変数を更新します
  • コマンド名の代わりにフルパスを使用します(例: /usr/local/bin/npx)

接続タイムアウト​

症状: 接続テスト時に長時間応答がない。

解決策:

  • ネットワーク接続を確認します(SSE/HTTP サーバーの場合)
  • URL が正しいことを確認します。特にポートとパスを確認してください
  • ファイアウォールやプロキシが接続をブロックしていないか確認します
  • Stdio サーバーの場合、コマンドが正常に起動できることを確認します

認証エラー​

症状: 接続は成功するが、ツール呼び出しが認証関連エラーで失敗する。

解決策:

  • API キーが環境変数に正しく設定されていることを確認します
  • SSE/HTTP サーバーの場合、リクエストヘッダー内の認証情報が正しい形式であることを確認します
  • Bearer トークン形式に注意してください: Authorization=Bearer your-token

ツールが表示されない​

症状: サーバーには正常に接続できたが、会話にツールが表示されない。

解決策:

  • サーバーが有効状態(isActive が true)であることを確認します
  • MCP モードが disabled に設定されていないか確認します
  • 手動モードでは、サーバーが選択されていることを確認します
  • Discover ボタンを使ってツール一覧を手動で更新してみます
  • ツールキャッシュは 5 分ごとに期限切れになります。キャッシュが更新されるのを待つか、再接続してください

次のステップ​