기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Q Developer를 위한 MCP 거버넌스

IAM Identity Center를 로그인 방법으로 사용하는 프로 티어 고객은 조직 내 사용자의 MCP 액세스를 제어할 수 있습니다. 기본적으로 사용자는 Q 클라이언트에서 모든 MCP 서버를 사용할 수 있습니다. 관리자는 사용자의 MCP 서버 사용을 완전히 비활성화하거나 사용자가 사용할 수 있는 검증된 MCP 서버 목록을 지정할 수 있습니다.

이러한 제한은 각각 MCP 켜기/끄기 토글 및 MCP 레지스트리를 통해 제어됩니다. MCP 토글 및 레지스트리 속성은 조직 수준 또는 계정 수준에서 정의할 수 있는 Q Developer 프로필의 일부이며, 계정 수준 프로필은 조직 수준 프로필을 대체합니다. 이를 통해 전체 조직에 대해 기본 MCP 정책을 지정한 다음 특정 계정에 대해 해당 기본값을 재정의할 수 있습니다. 예를 들어, 조직 전체에 대해 MCP를 비활성화했지만 특정 팀(계정)에 대해 허용 목록으로 활성화했습니다.

조직의 MCP 비활성화

계정 또는 조직에 대해 MCP를 비활성화하려면:

조직의 MCP 허용 목록 지정

조직의 사용자가 사용할 수 있는 MCP 서버를 제어하려면 JSON 파일에서 허용되는 MCP 서버 목록을 지정하고, HTTPS를 통해이 JSON 파일을 제공하고, 원하는 Q Developer Profile에 해당 URL을 입력합니다. 그러면이 프로파일을 사용하는 모든 Q Developer 클라이언트는 사용자가 JSON 파일에 허용 목록에 있는 MCP 서버만 사용할 수 있도록 강제합니다.

MCP 레지스트리 URL 지정

MCP 레지스트리 URL은 데이터 암호화 정책에 따라 전송 중 및 저장 시 모두 암호화됩니다.

MCP 레지스트리 파일 형식

레지스트리 JSON 파일의 형식은 MCP 레지스트리 표준 v0.1에 있는 서버 스키마 JSON의 하위 집합입니다. Q Developer에서 지원하는 하위 집합에 대한 JSON 스키마 정의는이 문서의 끝에 있는 레지스트리 스키마 섹션에서 확인할 수 있습니다.

다음은 원격(HTTP) 및 로컬(stdio) MCP 서버 정의를 모두 포함하는 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 스키마는 레지스트리 스키마 섹션을 참조하세요.

중첩 속성은 상위 속성의 가로 오프셋과 함께 표시됩니다. 예를 들어 “헤더”는 “원격”의 하위 속성이고, “이름”과 “값”은 “헤더”의 하위 속성입니다.

MCP 레지스트리 파일 서비스

MCP 레지스트리 JSON 파일은 HTTPS를 통해 제공되어야 합니다. S3, Apache/nginx 등을 사용하여 원하는 방식으로이 서비스를 제공할 수 있습니다. 이 URL은 사용자의 PCs에서 실행되는 Q Developer 클라이언트가 액세스할 수 있어야 합니다. 그러나 AWS 콘솔에서 액세스할 필요는 없습니다. 즉, 회사 네트워크에 비공개일 수 있습니다.

보안상의 이유로 HTTPS 엔드포인트에는 신뢰할 수 있는 인증 기관에서 서명한 유효한 SSL 인증서가 있어야 합니다. 특히 레지스트리 엔드포인트에 자체 서명된 인증서를 사용할 수 없습니다.

Q는 시작 시 및 주기적으로(24시간마다) MCP 레지스트리를 가져옵니다. 주기적 동기화 중에 Q가 로컬로 설치된 MCP 서버가 레지스트리에 더 이상 존재하지 않음을 발견하면 해당 서버를 종료하고 사용자가 다시 추가하는 것을 허용하지 않습니다. 로컬에 설치된 서버의 버전이 레지스트리의 서버와 다른 경우 레지스트리에 정의된 버전으로 서버를 다시 시작합니다.

Q Developer 플러그인

사용자가 Q Developer를 시작하면 프로필에 레지스트리 URL이 정의되어 있는지 확인합니다. 이 경우 해당 URL에서 레지스트리 JSON을 검색하고 사용자가 레지스트리에 정의된 MCP 서버만 사용할 수 있도록 적용합니다. 사용자가 MCP 서버를 추가하려고 하면 선택할 수 있는 레지스트리에 정의된 서버 목록이 표시됩니다.

사용자는 레지스트리 MCP 서버의 파라미터(URL, 패키지 식별자, runtimeArguments 등)를 수정할 수 없습니다. 그러나 여전히 다음을 수행할 수 있습니다.

MCP 레지스트리 JSON 스키마

다음은 Q Developer에서 지원하는 MCP 레지스트리 JSON 파일에 대한 JSON 스키마 정의입니다. 이 스키마를 사용하여 생성한 레지스트리 파일을 검증할 수 있습니다.

{
  "$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"
        },
        "remotes": {
          "items": {
            "anyOf": [
              {
                "$ref": "#/definitions/StreamableHttpTransport"
              },
              {
                "$ref": "#/definitions/SseTransport"
              }
            ]
          },
          "type": "array"
        }
      },
      "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": {
        "value": {
          "description": "The value for the input.",
          "type": "string"
        }
      },
      "required": [
        "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"
}