> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

Model Context Protocol（MCP）は、外部システムやデータソースとシームレスに統合することで、Qoderの機能を拡張します。本トピックでは、MCPの基本概念、対応するトランスポート方式、設定手順、および実用的なユースケースを解説します。

<div id="what-is-mcp">
  ## MCPとは何ですか？
</div>

[MCP](https://modelcontextprotocol.io/introduction) は、アプリケーションが大規模言語モデル（LLM）に context とツールを提供する方法を標準化するオープンなプロトコルです。統一されたインターフェースで機能を公開することで、MCP により LLM は API、データベース、ローカルツールなどの外部システムと、構造化され安全な方法でやり取りできるようになります。

<div id="why-use-mcp">
  ### なぜ MCP を使うのか
</div>

MCP は標準化されたインターフェースを通じて、Qoder Agent が幅広い外部システムやデータソースに接続できるようにします。これにより、Agent の次の能力が強化されます:

* リアルタイム情報の取得
* 外部システムでの操作実行
* 構造化／非構造化データの処理

これにより、パーソナライズされたワークフローを実現し、開発者はよりインテリジェントで文脈認識に優れた AI アシスタントを構築できるようになります。

<div id="how-it-works">
  ### 仕組み
</div>

MCP サーバーは、MCP プロトコルを通じて（関数やデータアクセスなどの）機能を公開します。Qoder は、ユーザー入力とツールのメタデータに基づいてこれらの機能を検出して呼び出します。

Qoder は 2 種類の標準的なトランスポート方式をサポートします:

* ****標準入出力（STDIO）****
  * 通信は stdin/stdout ストリーム経由で行われます。
  * ローカルツールやコマンドライン連携に最適です。
  * ローカル環境のセットアップが必要—主にプロフェッショナル向けです。
* **Server-Sent Events（SSE）**
  * クライアントからサーバーへのリクエストは HTTP POST、サーバーからクライアントへのレスポンスはイベントストリームを使用します。
  * リモートホスティング—設定も利用も容易です。
  * 初心者や迅速なプロトタイピングに強く推奨されます。
  * また、Streamable HTTP にも対応しています。

<div id="configure-mcp-servers">
  ## MCP サーバーを設定する
</div>

### MCP 設定を開く

1. Qoder IDE の右上でユーザーアイコンをクリックするか、キーボードショートカット（`⌘` `⇧` `,`（macOS）または `Ctrl` `Shift` `,`（Windows））を使用し、**Qoder 設定**を選択します。
2. 左側のナビゲーションペインで **MCP** をクリックします。

### 方法 1: 自分の MCP サーバーに接続する

1. **My Servers** タブで、右上の **+ Add** をクリックします。

2. 表示された JSON ファイルに、サーバーの詳細を追加します:

   * Name

   * Transport type（STDIO または SSE）

   * Command と arguments（STDIO の場合）

   * Endpoint URL（SSE または Streamable HTTP の場合）

   > **Note:** Streamable HTTP を利用する場合は、SSE と同じ方法でエンドポイントを設定すれば、Qoder が自動的に認識して利用します。

   例:

   ```json theme={null}
   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-github"
         ],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
         }
       }
     }
   }
   ```

3. ファイルを閉じ、プロンプトが表示されたら **Save** をクリックします。

保存後、新しいサーバーが一覧に表示されます。リンクアイコンは接続が成功していることを示します。エントリを展開して、利用可能なツールを確認します。

> **ヒント：** サーバーの詳細では、**Request Timeout** ドロップダウンから各 MCP リクエストのタイムアウト時間を設定できます。リクエストの実行時間がこの値を超えると、自動的に中断され、チャットにタイムアウトメッセージが表示されます。

### 方法 2: MCP Square の MCP サーバーを使用する

1. **MCP Square** タブをクリックします。

2. 利用可能なサーバー一覧を参照し、目的のサーバーで **Install** をクリックします。

   > **Note:** 一部の MCP サーバーは、API\_KEY や ACCESS\_TOKEN などの追加の環境変数を必要とします。これらは手動で設定する必要があります。

3. インストールを確認するために **My Servers** タブに移動します。詳細を展開して、ツール一覧を確認します。

   > **Note:** 依存関係の不足によりサーバーの起動に失敗した場合は、Quick Fix をクリックしてください。問題が解決しない場合は、依存関係を手動でインストールしてください。トラブルシューティングについては、[MCP common issues](https://docs.qoder.com/troubleshooting/mcp-common-issue) を参照してください。

<div id="use-mcp-tools">
  ## MCP ツールを使う
</div>

Qoder は次に基づいて適切な MCP ツールを自動的に選択します:

* 入力プロンプト
* ツール名と説明

Qoder が MCP ツールを呼び出す前に、確認が求められます。以降の MCP サーバーを自動的に実行するには、この確認を選択してください。その後、Agent はツールの出力を用いてワークフローの次のステップに進みます。

### 手順 

1. Chat パネルで Agent モードに切り替え、プロンプトを入力します。
2. ツールの呼び出し前に Qoder が確認を求めます。実行するには `⌘` `⏎`（macOS）または `Ctrl` `Enter`（Windows）を押します。
3. 実行後、結果がチャットに表示されます。

   応答を展開して、詳細な入力と出力を確認します。
4. 生成されたコードをレビューし、必要に応じて変更を承認します。

<div id="example-scenarios">
  ## 例示シナリオ
</div>

<div id="scenario-1-retrieve-and-process-web-content-remote-mcp-via-sse">
  ### シナリオ 1: ウェブコンテンツの取得と処理（SSE 経由のリモート MCP）
</div>

MCP サーバーを使って、HTML のウェブコンテンツを Markdown に変換し、読みやすくします。

**ステップ 1: MCP SSE サーバーのエンドポイントを取得**

1. 公式の MCP マーケットプレイスのウェブサイトにアクセスします。
2. [fetch サーバー](https://mcpservers.org/servers/modelcontextprotocol/fetch)の SSE エンドポイント URL をコピーします。

**ステップ 2: MCP サーバーを追加**

Qoder の IDE で **MCP** ページを開き、以下の内容で MCP サーバーを編集します:

* Name:`fetch`
* Type:`SSE`
* Server endpoint: コピーした URL を貼り付けます。

例:

```json theme={null}
{
  "mcpServers": {
    "fetch": {
      "type": "sse",
      "url": "https://mcp.api-inference.modelscope.net/******/sse"
    }
  }
}
```

**ステップ3：設定を完了する**

保存すると、リンクアイコンがサーバーの準備完了を示します。詳細を展開してツール一覧を確認してください。

**ステップ4：Qoderでの使用**

Agent モードで、次を入力します：

```plaintext theme={null}
この文書を要約してください：https://docs.qoder.com/user-guide/chat/overview
```

<div id="scenario-2-query-city-weather-local-mcp-via-stdio">
  ### シナリオ 2: 都市の天気を照会する（ローカル MCP を STDIO 経由で）
</div>

ローカルの MCP サーバーを使って、リアルタイムの天気データを取得します。

**手順 1: 前提条件の確認**

Node.js がインストールされていることを確認します。Qoder に確認を依頼できます：

```plaintext theme={null}
ローカル環境でNode.jsがインストールされているかを確認する
```

**ステップ 2: MCP サーバーを追加**

Qoder IDE の **MCP** ページに移動し、以下の内容で MCP サーバーを編集します:

* Name:`weather`
* Type:`STDIO`
* Command:`npx`
* Arguments:

```shellscript theme={null}
-y @h1deya/mcp-server-weather
```

例：

```json theme={null}
{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": [
        "-y",
        "@h1deya/mcp-server-weather"
      ]
    }
  }
}
```

**ステップ3：設定を完了する**

保存すると、リンクアイコンがサーバーの準備完了を示します。詳細を展開して、ツール一覧を確認します。

**ステップ4：Qoderで使用する**

Agent モードで、次のようなプロンプトを入力します。

```plaintext theme={null}
アメリカ合衆国サンフランシスコの天気を確認する
```

その後、次の対応を実施してください：

```plaintext theme={null}
明日、アメリカで気象警報は出ていますか？
```

<div id="references">
  ## 参考
</div>

* [MCP の一般的な問題](https://docs.qoder.com/troubleshooting/mcp-common-issue)
* [ターミナル実行時の例外](https://docs.qoder.com/troubleshooting/terminal-execution-exceptions)