本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Q Developer 的 MCP 控管
<a name="mcp-governance"></a>

 使用 IAM Identity Center 作為登入方法的專業層客戶可以控制組織內使用者的 MCP 存取。根據預設，您的使用者可以在其 Q 用戶端使用任何 MCP 伺服器。身為管理員，您可以完全停用使用者使用 MCP 伺服器，或指定允許使用者使用的 MCP 伺服器審核清單。

 您可以使用 MCP 開/關切換和 MCP 登錄來控制這些限制。MCP 切換和登錄屬性是 [Q 開發人員設定檔](subscribe-understanding-profile.md)的一部分，可在組織層級或帳戶層級定義，帳戶層級設定檔會取代組織層級設定檔。您可以為組織指定預設 MCP 政策，並覆寫特定帳戶；例如，停用組織的 MCP，但使用特定團隊 （帳戶） 的允許清單來啟用它。

**注意**  
 切換和登錄設定都會在用戶端強制執行。請注意，您的最終使用者可以會規避此設定。

## 停用組織的 MCP
<a name="disabling-mcp"></a>

若要為您的帳戶或組織停用 MCP：

1. 開啟 Kiro 主控台。

1. 選擇**設定**。

1. 選擇 **Q 開發人員**索引標籤。

1.  將**模型內容通訊協定 (MCP)** 切換為**關閉**。

## 為您的組織指定 MCP 允許清單
<a name="allow-listing-mcp"></a>

 若要控制使用者可以存取的 MCP 伺服器，請使用允許的伺服器建立 JSON 檔案、透過 HTTPS 提供，並將 URL 新增至您的 Q 開發人員設定檔。Q 開發人員用戶端使用此設定檔可讓使用者僅存取允許清單中的 MCP 伺服器。

### 指定 MCP 登錄 URL
<a name="specifying-registry-url"></a>

1. 開啟 Kiro 主控台。

1. 選擇**設定**。

1. 選擇 **Q 開發人員**索引標籤。

1.  確保**模型內容通訊協定 (MCP)** 已**開啟**。

1.  在 **MCP 登錄 URL** 欄位中，選擇**編輯**。

1.  輸入 MCP 登錄檔 JSON 檔案的 URL，其中包含允許列出的 MCP 伺服器。

1. 選擇**儲存**。

 MCP 登錄 URL 會根據[我們的資料加密政策，在傳輸中和靜態時加密](data-encryption.md)。

### MCP 登錄檔檔案格式
<a name="registry-file-format"></a>

 登錄檔 JSON 檔案格式是 [MCP 登錄標準](https://github.com/modelcontextprotocol/registry) v0.1 中伺服器結構描述 JSON 的子集。Q Developer 支援之子集的 JSON 結構描述定義可在本文件結尾的[登錄結構描述](#registry-schema)區段中取得。

 下列範例顯示 MCP 登錄檔，其中包含遠端 (HTTP) 和本機 (stdio) MCP 伺服器定義。

```
{
  "servers": [
    {
      "server": {
        "name": "my-remote-server",
        "title": "My server",
        "description": "My server description",
        "version": "1.0.0",
        "remotes": [
          {
            "type": "streamable-http",
            "url": "https://acme.com/my-server",
            "headers": [
              {
                "name": "X-My-Header",
                "value": "SomeValue"
              }
            ]
          }
        ]
      }
    },
    {
      "server": {
        "name": "my-local-server",
        "title": "My server",
        "description": "My server description",
        "version": "1.0.0",
        "packages": [
          {
            "registryType": "npm",
            "registryBaseUrl": "https://npm.acme.com",
            "identifier": "@acme/my-server",
            "transport": {
              "type": "stdio"
            },
            "runtimeArguments": [
              {
                "type": "positional",
                "value": "-q"
              }
            ],
            "packageArguments": [
              {
                "type": "positional",
                "value": "start"
              }
            ],
            "environmentVariables": [
              {
                "name": "ENV_VAR",
                "value": "ENV_VAR_VALUE"
              }
            ]
          }
        ]
      }
    }
  ]
}
```

 下表列出登錄檔 JSON 檔案的屬性。除非另有說明，否則所有屬性都是強制性的。如需完整的 JSON [結構描述](#registry-schema)，請參閱登錄結構描述一節。

 巢狀屬性會從其父系縮排顯示。例如，「標頭」是「遠端」的子屬性，而「名稱」和「值」是「標頭」的子屬性。


| 屬性 | Description | 選用？ | 範例值 | 
| --- | --- | --- | --- | 
|  **常見屬性**  |    |    |    | 
|  name  |  伺服器名稱。在特定登錄檔中必須是唯一的。  |    |  「aws-ccapi-mcp」  | 
|  標題  |  人類可讀取的伺服器名稱。  |  是  |  「AWS CC API」  | 
|  description  |  伺服器的說明。  |    |  「透過自然語言管理 AWS 基礎設施。」  | 
|  version  |  伺服器版本。強烈建議使用語意版本控制 (x.y.z)。  |    |  "1.0.2"  | 
|  **遠端 (HTTP) 伺服器屬性**  |    |    |    | 
|  遠端  |  陣列，其中只有一個項目指定遠端端點。  |    |  -  | 
|    type  |  必須是「可串流http」或「sse」之一。  |    |  「可串流http」  | 
|    url  |  MCP 伺服器端點 URL。  |    |  "https://mcp.figma.com/mcp"  | 
|    標頭  |  每個請求中要包含的 HTTP 標頭陣列。  |  是  |  -  | 
|      name  |  HTTP 標頭名稱。  |    |  「授權」  | 
|      value  |  HTTP 標頭值。  |    |  「承載 mF\$19.B5f-4.1JqM」  | 
|  **Local (stdio) 伺服器屬性**  |    |    |    | 
|  packages  |  陣列，其中只有一個項目包含 MCP 伺服器定義。  |    |  -  | 
|    registryType  |  必須是「npm」、「pypi」或「oci」之一。 下列套件執行器用於下載和執行 MCP 伺服器套件： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/mcp-governance.html) 用戶端機器必須預先安裝適當的套件執行器。  |    |  「npm」  | 
|    registryBaseUrl  |  套件登錄 URL。  |  是  |  "https://npm.acme.com"  | 
|    identifier  |  伺服器套件識別符。  |    |  "@acme/my-server"  | 
|    transport  |  物件只有一個屬性，「類型」。  |    |  -  | 
|      type  |  必須是 "stdio"。  |    |  「stdio」  | 
|    runtimeArguments  |  提供給執行時間的引數陣列，也就是 npx、uvx 或 docker。  |  是  |  -  | 
|      type  |  必須是「位置」。  |    |  「位置」  | 
|      value  |  執行時間引數值。  |    |  “-q”  | 
|    packageArguments  |  提供給 MCP 伺服器的引數陣列。  |  是  |  -  | 
|      type  |  必須是「位置」。  |    |  「位置」  | 
|      value  |  套件引數值。  |    |  「開始」  | 
|    environmentVariables  |  啟動伺服器之前要設定的 env vars 陣列。  |  是  |  -  | 
|      name  |  環境變數名稱。  |    |  "LOG\$1LEVEL"  | 
|      value  |  環境變數值。  |    |  「INFO」  | 

### 提供 MCP 登錄檔
<a name="serving-mcp-registry"></a>

 使用任何 Web 伺服器透過 HTTPS 提供 MCP 登錄檔 JSON 檔案，例如 Amazon S3、Apache 或 nginx。此 URL 必須可供使用者電腦上的 Q Developer 用戶端存取，但可以私有於您的公司網路。

 HTTPS 端點必須具有受信任憑證授權單位簽署的有效 SSL 憑證。不支援自我簽署憑證。

 Q 開發人員會在啟動時和每 24 小時擷取一次 MCP 登錄檔。在定期同步期間，如果本機安裝的 MCP 伺服器不再位於登錄檔中，Q Developer 會終止該伺服器，並防止使用者將其新增回來。如果本機安裝的伺服器與登錄檔中的伺服器版本不同，Q Developer 會使用登錄檔中定義的版本重新啟動伺服器。

### Q 開發人員外掛程式
<a name="mcp-registry-q-dev-plugins"></a>

 當使用者啟動 Q Developer 時，它會檢查是否已在設定檔中定義登錄 URL。若是如此，它會在該 URL 擷取登錄檔 JSON，並強制使用者只能使用登錄檔中定義的 MCP 伺服器。當使用者新增 MCP 伺服器時，Q Developer 會顯示來自登錄檔的伺服器清單。

![\[顯示新增登錄檔中定義的 MCP 伺服器的螢幕擷取畫面。\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/q-mcp-registry-add-server.png)


 登錄檔 MCP 伺服器參數 (URL、套件識別符、runtimeArguments 等） 為唯讀。不過，使用者可以：

1. 調整 MCP 工具許可 (「請求執行」、「一律執行」或「拒絕」)。

1. 選取 MCP 伺服器範圍 （全域或工作區）。

1. 變更請求逾時。

1. 指定本機 MCP 伺服器的其他環境變數。

1. 指定遠端 MCP 伺服器的其他 HTTP 標頭。

**注意**  
 使用者指定的環境變數或 HTTP 標頭會覆寫登錄檔定義。這可讓使用者指定其設定的特定屬性，例如身分驗證金鑰或本機資料夾路徑。

### MCP 登錄檔 JSON 結構描述
<a name="registry-schema"></a>

 下列 JSON 結構描述定義 Q Developer 支援的 MCP 登錄檔檔案格式。您可以使用此結構描述來驗證您建立的任何登錄檔。

```
{
  "$schema": "https://json-schema.org/draft-07/schema",
  "properties": {
    "servers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "server": {
            "$ref": "#/definitions/ServerDetail"
          }
        },
        "required": [
          "server"
        ]
      }
    }
  },
  "definitions": {
    "ServerDetail": {
      "properties": {
        "name": {
          "description": "Server name. Must be unique within a given registry file.",
          "example": "weather-mcp",
          "maxLength": 200,
          "minLength": 3,
          "pattern": "^[a-zA-Z0-9._-]+$",
          "type": "string"
        },
        "title": {
          "description": "Optional human-readable title or display name for the MCP server. MCP subregistries or clients MAY choose to use this for display purposes.",
          "example": "Weather API",
          "maxLength": 100,
          "minLength": 1,
          "type": "string"
        },
        "description": {
          "description": "Clear human-readable explanation of server functionality. Should focus on capabilities, not implementation details.",
          "example": "MCP server providing weather data and forecasts via OpenWeatherMap API",
          "maxLength": 100,
          "minLength": 1,
          "type": "string"
        },
        "version": {
          "description": "Version string for this server. SHOULD follow semantic versioning (e.g., '1.0.2', '2.1.0-alpha'). Equivalent of Implementation.version in MCP specification. Non-semantic versions are allowed but may not sort predictably. Version ranges are rejected (e.g., '^1.2.3', '~1.2.3', '\u003e=1.2.3', '1.x', '1.*').",
          "example": "1.0.2",
          "maxLength": 255,
          "type": "string"
        },
        "packages": {
          "items": {
            "$ref": "#/definitions/Package"
          },
          "type": "array",
          "minItems": 0,
          "maxItems": 1
        },
        "remotes": {
          "items": {
            "anyOf": [
              {
                "$ref": "#/definitions/StreamableHttpTransport"
              },
              {
                "$ref": "#/definitions/SseTransport"
              }
            ]
          },
          "type": "array",
          "minItems": 0,
          "maxItems": 1
        }
      },
      "required": [
        "name",
        "description",
        "version"
      ],
      "type": "object"
    },
    "Package": {
      "properties": {
        "registryType": {
          "description": "Registry type indicating how to download packages (e.g., 'npm', 'pypi', 'oci')",
          "enum": [
            "npm",
            "pypi",
            "oci"
          ],
          "type": "string"
        },
        "registryBaseUrl": {
          "description": "Base URL of the package registry",
          "examples": [
            "https://registry.npmjs.org",
            "https://pypi.org",
            "https://docker.io"
          ],
          "format": "uri",
          "type": "string"
        },
        "identifier": {
          "description": "Package identifier - either a package name (for registries) or URL (for direct downloads)",
          "examples": [
            "@modelcontextprotocol/server-brave-search",
            "https://github.com/example/releases/download/v1.0.0/package.mcpb"
          ],
          "type": "string"
        },
        "transport": {
          "anyOf": [
            {
              "$ref": "#/definitions/StdioTransport"
            },
            {
              "$ref": "#/definitions/StreamableHttpTransport"
            },
            {
              "$ref": "#/definitions/SseTransport"
            }
          ],
          "description": "Transport protocol configuration for the package"
        },

        "runtimeArguments": {
          "description": "A list of arguments to be passed to the package's runtime command (such as docker or npx).",
          "items": {
            "$ref": "#/definitions/PositionalArgument"
          },
          "type": "array"
        },
        "packageArguments": {
          "description": "A list of arguments to be passed to the package's binary.",
          "items": {
            "$ref": "#/definitions/PositionalArgument"
          },
          "type": "array"
        },
        "environmentVariables": {
          "description": "A mapping of environment variables to be set when running the package.",
          "items": {
            "$ref": "#/definitions/KeyValueInput"
          },
          "type": "array"
        }
      },
      "required": [
        "registryType",
        "identifier",
        "transport"
      ],
      "type": "object"
    },
    "StdioTransport": {
      "properties": {
        "type": {
          "description": "Transport type",
          "enum": [
            "stdio"
          ],
          "example": "stdio",
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    "StreamableHttpTransport": {
      "properties": {
        "type": {
          "description": "Transport type",
          "enum": [
            "streamable-http"
          ],
          "example": "streamable-http",
          "type": "string"
        },
        "url": {
          "description": "URL template for the streamable-http transport. Variables in {curly_braces} reference argument valueHints, argument names, or environment variable names. After variable substitution, this should produce a valid URI.",
          "example": "https://api.example.com/mcp",
          "type": "string"
        },
        "headers": {
          "description": "HTTP headers to include",
          "items": {
            "$ref": "#/definitions/KeyValueInput"
          },
          "type": "array"
        }
      },
      "required": [
        "type",
        "url"
      ],
      "type": "object"
    },
    "SseTransport": {
      "properties": {
        "type": {
          "description": "Transport type",
          "enum": [
            "sse"
          ],
          "example": "sse",
          "type": "string"
        },
        "url": {
          "description": "Server-Sent Events endpoint URL",
          "example": "https://mcp-fs.example.com/sse",
          "format": "uri",
          "type": "string"
        },
        "headers": {
          "description": "HTTP headers to include",
          "items": {
            "$ref": "#/definitions/KeyValueInput"
          },
          "type": "array"
        }
      },
      "required": [
        "type",
        "url"
      ],
      "type": "object"
    },
    "PositionalArgument": {
      "properties": {
        "type": {
          "enum": [
            "positional"
          ],
          "example": "positional",
          "type": "string"
        },
        "value": {
          "description": "The value for the input.",
          "type": "string"
        }
      },
      "required": [
        "type",
        "value"
      ],
      "type": "object"
    },
    "KeyValueInput": {
      "properties": {
        "name": {
          "description": "Name of the header or environment variable.",
          "example": "SOME_VARIABLE",
          "type": "string"
        },
        "value": {
          "description": "The value for the input.",
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    }
  },
  "required": [
    "servers"
  ],
  "type": "object"
}
```