MCP サーバー

MCP とは？

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

---

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

AQBot は 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 インポートをクリックして設定オブジェクトを貼り付けます。AQBot は標準の 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"
      }
    }
  }
}

---

ビルトインツール

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

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

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

---

ツール実行パネル

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

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

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

---

次のステップ

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