BoosAPI/desktop/website/docs/ja/guide/mcp.md

MCP サーバー

MCP とは？

Model Context Protocol（MCP）は、AI モデルが外部ツールやデータソースと対話できるようにするオープンスタンダードです。BoosApi は MCP クライアントとして機能します — MCP サーバーを追加すると、AI は会話中にそのサーバーが公開するツールを呼び出せます。

---

トランスポートプロトコル

BoosApi は MCP サーバーとの通信に 3 つのトランスポートプロトコルをサポートしています：

プロトコル	接続	ユースケース	設定
Stdio	ローカルプロセス	npx、uvx、python などで起動するマシン上にインストールされたツール	command + args + オプション env
SSE	リモートサーバー	リモートマシンまたはクラウドサービスでホストされる Server-Sent Events エンドポイント	url
StreamableHTTP	リモートサーバー	HTTP ストリーミングエンドポイント（SSE の新しい代替）	url

---

MCP サーバーの追加

フォームで作成

1. 設定 → MCP サーバーに移動します。
2. MCP サーバーを追加をクリックします。
3. 名前を入力してトランスポートプロトコルを選択します。
4. 選択したプロトコルのフィールドを入力します：
   • Stdio — 実行するコマンド、引数（JSON 配列）、環境変数（JSON オブジェクト）、タイムアウト。
   • SSE — エンドポイント URL、タイムアウト。
   • StreamableHTTP — エンドポイント URL、タイムアウト。
5. 保存をクリックします。

JSON インポート

JSON インポートをクリックして設定オブジェクトを貼り付けます。BoosApi は標準の MCP JSON 形式を受け入れます：

Stdio サーバー

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

SSE サーバー

{
  "mcpServers": {
    "remote-tools": {
      "type": "sse",
      "url": "https://example.com/sse"
    }
  }
}

StreamableHTTP サーバー

{
  "mcpServers": {
    "remote-http": {
      "type": "streamablehttp",
      "url": "https://example.com/mcp"
    }
  }
}

複数のサーバーを一度に

{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
    },
    "remote": {
      "type": "sse",
      "url": "https://example.com/sse"
    }
  }
}

---

設定例

ウェブフェッチ — mcp-server-fetch

ウェブページを取得して AI のために読みやすいテキストに変換します。

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

ファイル操作 — @modelcontextprotocol/server-filesystem

AI にマシン上の特定のディレクトリへの読み書きアクセスを与えます。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/me/documents",
        "/Users/me/projects"
      ]
    }
  }
}

リモート SSE サーバー

Server-Sent Events を介してリモートツールサーバーに接続します。

{
  "mcpServers": {
    "cloud-tools": {
      "type": "sse",
      "url": "https://mcp.example.com/sse"
    }
  }
}

環境変数付き Stdio

環境変数を介して API キーや設定をサーバープロセスに渡します。

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["-m", "weather_server"],
      "env": {
        "WEATHER_API_KEY": "your-api-key"
      }
    }
  }
}

---

ビルトインツール

BoosApi には、外部 MCP サーバーを追加せずに使用できるビルトインツールが付属しています：

ツール	説明
@boosapi/fetch	ウェブページと HTTP リソースの取得
@boosapi/search-file	ローカルファイルシステムでのファイル検索

ビルトインツールは、カスタムサーバーと並んで MCP サーバー設定に一覧表示され、個別に有効化・無効化できます。

---

ツール実行パネル

AI が会話中に MCP ツールを呼び出すと、BoosApi はチャット内にインラインでツール実行パネルを表示します。パネルには以下が表示されます：

• ツール名とそれが属するサーバー。
• ツールに送信された入力引数。
• ツールによって返された出力。
• 実行ステータス（実行中、成功、または失敗）。

会話内の任意のツール呼び出しをクリックして詳細を展開します。これにより、AI が何をしたかを確認し、予期しない結果をデバッグするのが簡単になります。

---

ツールループ上限

Settings -> MCP で、MCP 対応応答が連続して実行できるツール呼び出し回数の上限を設定できます。未知のサーバーを試すときは低めに、複数ツールを意図的に連鎖させるワークフローでは高めに設定できます。

次のステップ

• API ゲートウェイ — プロバイダーをローカル API サーバーとして公開
• クイックスタート — クイックスタートガイドに戻る