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

MCP サーバー

MCP(Model Context Protocol)は、AI Agent が外部ツールサーバーと通信できるようにするオープン標準です。MCP を通じて、ファイルシステムアクセス、Web 検索、データベースクエリ、コードリポジトリの参照などの機能を標準化された方法で Elftia に接続でき、Agent は会話中にこれらの外部ツールを直接呼び出せるようになります。

MCP を使う理由

Agent の組み込み機能には限りがあります。MCP を使うと、次のことができます。

  • ツールセットを拡張する — 任意の外部サービスの機能を、Agent が呼び出せるツールとして登録できます
  • インターフェースを標準化する — 異なる提供元のツールが統一されたプロトコルで通信するため、ツールごとにカスタムアダプターを書く必要がなくなります
  • 必要に応じて接続する — 現在のタスクに必要なサーバーだけを有効にし、ツール一覧が扱いにくくなるのを防ぎます
  • プロジェクト間で再利用する — 同じ MCP サーバー設定一式を複数の Agent で共有できます

3 つのトランスポートプロトコル

Elftia は 3 種類の MCP トランスポートをサポートしています。用途に合うものを選択してください。

トランスポートタイプ接続方法用途
Stdioローカルの子プロセスを起動し、標準入出力で通信しますローカルツール、CLI ラッパー、npm/pip パッケージnpx @modelcontextprotocol/server-filesystem
SSEHTTP Server-Sent Events による長時間接続リモートサービス、リアルタイムプッシュが必要なシナリオhttps://api.example.com/mcp/sse
HTTPStreamable HTTP に基づくリクエスト/レスポンスリモートの REST スタイル MCP サービスhttps://api.example.com/mcp

:::tip 選び方

  • ほとんどの場合は Stdio を選ぶ — npm や pip でインストールする MCP サーバーパッケージは、通常 Stdio を使用します
  • リモートでホストされるサービスには SSE または HTTP を選ぶ — サードパーティが提供するクラウドホスト型 MCP サービスなどが該当します
  • SSE と HTTP — SSE は古い MCP 仕様に基づいています。HTTP は MCP 2025-03-26 仕様(Streamable HTTP)に基づいています。新しいサービスでは HTTP を優先してください :::

ツール検出と利用フロー

MCP サーバーを設定すると、Elftia は次の処理を自動的に行います。

MCP server starts / connects

Elftia automatically discovers the list of tools the server provides

Tools are registered in the Agent's available toolset

The Agent calls tools as needed during a conversation

The tool returns results; the Agent integrates them into its reply

ツールの命名形式: 各 MCP ツールは mcp__<server-name>__<tool-name> として登録されます。たとえば、filesystem という名前のサーバーが提供する read_file ツールは、Agent 内では mcp__filesystem__read_file として識別されます。

MCP と Agent

MCP サーバーは Agent と柔軟に組み合わせることができます。

  • 自動モード(デフォルト) — 有効なすべての MCP サーバーのツールが、すべての Agent で自動的に利用可能になります
  • 手動モード — 会話ごとに、使用する MCP サーバーを選択します
  • Agent バインディング — 特定の MCP サーバーを特定の Agent に関連付け、専用のツール設定を構成します

機能概要

機能説明
複数のトランスポートプロトコルStdio、SSE、HTTP の接続オプション
ツールの自動検出接続後、ツール一覧を自動的に取得し、5 分間キャッシュします
JSON 一括インポートJSON 設定を使って複数のサーバーを一度に追加します
依存関係の自動検出node/npm/uv/uvx などの CLI ツールがインストールされているかを自動的に確認します
接続テストサーバーの接続状態と利用可能なツールをワンクリックでテストします
ツールの無効化サーバー内の特定のツールを選択的に無効化します
信頼管理信頼済みサーバーと未信頼サーバーを区別します
公式プリセット一般的な MCP サーバー向けのワンクリックインストール設定を内蔵しています

次のステップ