CLI での MCP 設定 - Amazon Q Developer
設定コマンドリモート MCP サーバー

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CLI での MCP 設定

このページでは、MCP サーバーを設定するための CLI 固有のオプションについて説明します。

設定コマンド

使用方法: qchat mcp [OPTIONS] COMMAND

MCP 設定コマンド
コマンド 説明
qchat mcp add 設定済みのサーバーを追加または置き換える
qchat mcp remove MCP 設定からサーバーを削除する
qchat mcp list 設定済みサーバーを一覧表示する
qchat mcp import 別のファイルからサーバー設定をインポートする
qchat mcp status 設定済みサーバーのステータスを取得する
qchat mcp help このコマンドのリストまたは特定のサブコマンドのヘルプを出力する (複数可)

MCP サーバーの引数

--args パラメータは、エスケープ形式または JSON 配列形式を使用したカンマを含む引数をサポートするようになりました。

# Escaped commas
q mcp add --name server --command cmd --args "arg1,arg2\,with\,commas,arg3"

# JSON array format  
q mcp add --name server --command cmd --args '["arg1", "arg2,with,commas", "arg3"]'

リモート MCP サーバー

Amazon Q Developer CLI は、プロセスとして実行されるローカル MCP サーバーに加えて、HTTP 経由で通信するリモート MCP サーバーをサポートしています。リモートサーバーは、OAuth 認証を使用するか、オープンにすることができます (認証は必要ありません）。

構成

リモート MCP サーバーは、 typeおよび urlフィールドを使用してエージェント設定ファイルで設定されます。

{
  "mcpServers": {
    "find-a-domain": {
      "type": "http",
      "url": "https://api.findadomain.dev/mcp"
    }
  }
}

OAuth 認証フロー

OAuth 認証を必要とするリモート MCP サーバーを使用する場合:

  1. リモート MCP サーバーを含むエージェントで Q CLI セッションを開始する

  2. サーバーは最初、「まだロードされていません」と表示されます。

  3. /mcp コマンドを使用して認証を開始する

  4. Q CLI はサーバーに認証が必要であることを示し、URL を提供します。

  5. Q CLI セッションを開いたまま、ブラウザで指定された URL を開きます。

  6. ブラウザの認証手順に従います。

  7. Q CLI ウィンドウに戻る - 認証が成功すると MCP サーバーにサインインします

認証が完了すると、サーバーのツールが利用可能になります。