Skip to content

GWC Bridge를 ChatGPT에 수동으로 연결하기

GWC Bridge를 사용자 지정 커넥터로 ChatGPT에 연결하면 본인의 PC에서 허용한 파일과 명령을 ChatGPT에서 다룰 수 있습니다.

화면 레이블 안내: 따옴표 안의 레이블은 공급업체의 영어 인터페이스 문서를 따릅니다. 번역된 레이블은 확인하지 않았으며 실제 화면과 다를 수 있습니다.

1. 이 방법을 사용할 수 있는 사용자

"Add custom MCP server"를 허용하는 계정 또는 ChatGPT Business, Enterprise, Edu 워크스페이스에서 ChatGPT 웹(https://chatgpt.com)을 사용하세요. OpenAI 도움말 센터는 쓰기 작업을 포함한 전체 MCP 기능을 Business와 Enterprise/Edu용으로 설명하며, Pro의 사용자 지정 MCP는 읽기/가져오기 접근으로 설명합니다. 이 자료로는 Free나 Plus에 동등한 전체 접근이 제공된다고 확인할 수 없습니다. ChatGPT Business에서는 워크스페이스의 Admins and Owners(관리자 및 소유자)만 사용자 지정 MCP 서버 플러그인을 만들고 게시할 수 있습니다("Workspace settings" → "Members"에서 확인). ChatGPT Enterprise 및 Edu에서는 Admins and Owners가 사용자 지정 MCP 서버 연결을 만들고 테스트하고 게시할 수 있으며, 관리자는 "Workspace settings" → "Permissions & roles"의 역할 기반 액세스 제어(RBAC)를 통해 지정한 멤버에게 "Create plugins with MCPs" 권한을 부여하여 연결을 만들고 테스트하도록 할 수 있습니다(워크스페이스 게시와 작업 제어는 Admins and Owners가 관리). 실제 계정에서 사용할 수 있는 기능을 확인하세요. GWC는 공급업체의 이용 자격이나 워크스페이스 정책을 바꿀 수 없습니다.[2]

2. 컴퓨터 준비

  1. 대상 컴퓨터에서 운영체제용으로 제공되는 경우 공식 지원 릴리스의 GWC Studio를 사용하거나, Visual Studio Code에 GWC for VS Code를 설치하세요.
  2. 앱을 열고 본인의 GWC 계정으로 로그인한 뒤 대상 컴퓨터를 연결하세요. GWC 구성 요소를 계속 실행하고 온라인 상태로 유지하세요. 커넥터에서도 동일한 GWC 계정을 승인하세요.
  3. 먼저 민감한 정보가 없는 테스트 폴더를 공유하고, 채팅 프롬프트에 작성한 지시만 확인하지 말고 해당 컴퓨터에서 이 앱에 실제로 설정된 Change files(파일 변경) 및 Commands(명령) 권한을 검토하세요. 폴더 경계, 보호된 경로, 연결 권한, 최소 권한 기본값, 컴퓨터에서의 명시적 확인은 각각 별도의 서버 측 통제로 유지됩니다.
  4. 원격 승인과 도구 작업을 위해 활성 GWC Personal Connect Pass(Connect Pass)를 유지하세요. GWC는 ChatGPT 구독과 별개로 인증되지 않았거나 이용 자격이 없는 호출자의 요청을 거부합니다. 도구 목록이 보인다고 해서 접근 권한이 입증되는 것은 아니며, 원격 커넥터를 추가해도 컴퓨터 구성 요소가 설치되지는 않습니다.

3. 서버 주소와 OAuth

다음 원격 HTTPS MCP 주소를 커넥터의 서버 URL 필드에 그대로 붙여 넣으세요.

https://mcp.gwc-corp.com/mcp

PKCE(S256)를 사용하는 개인별 OAuth 2.1 로그인과 자동 Client ID Metadata Documents (CIMD) 검색(client_id_metadata_document_supported: true)을 사용하세요. 인증되지 않은 https://mcp.gwc-corp.com/mcp 요청에는 보호 리소스 메타데이터(https://mcp.gwc-corp.com/.well-known/oauth-protected-resource, RFC 9728)와 권한 부여 서버 https://api.gwc-corp.com을 가리키는 WWW-Authenticate의 resource_metadata 헤더와 함께 401 Unauthorized가 반환됩니다. "Advanced OAuth settings"("Client ID"와 "Client Secret")는 비워 두고 "No authentication"을 선택하지 마세요. GWC는 동적 클라이언트 등록(DCR)이나 정적 시크릿 대신 CIMD 기반 공개 클라이언트(none)를 사용하며, 정적 자격 증명을 수동으로 입력하면 자동 CIMD 검색이 무시됩니다. GWC 비밀번호, 액세스/갱신 토큰 또는 API 키를 프롬프트나 요청 헤더에 붙여 넣지 마세요.[3]

수동 지원은 기본적으로 비활성화되어 있습니다. 활성화되면 기본 클라이언트 메타데이터 호스트는 chatgpt.com, openai.com, claude.ai입니다. Claude 호스트는 정확히 claude.ai여야 합니다. 이 기본 설정은 claude.com, 다른 하위 도메인, 명시적 포트 지정(:443 포함)을 허용하지 않습니다. 운영자가 설정한 호스트 목록은 이러한 기본값을 대체하므로 GWC가 실제 적용된 설정을 확인해야 합니다.

수동 지원이 활성화되면 GWC는 메타데이터에 offline_access(refresh_token 승인 유형 지원)를 알리고 이를 허용하며, OAuth 흐름에서 요청된 경우 유지합니다. 기존 갱신 토큰은 순환 교체되므로 클라이언트는 매번 새로 발급된 토큰을 사용해야 합니다. 이 범위는 파일, 명령 또는 기타 컴퓨터 권한을 추가하지 않습니다. 도구 작업을 위해 컴퓨터는 온라인 상태를 유지해야 합니다. 취소되었거나 유효하지 않은 연결에는 공식 화면을 통한 새 로그인이 필요합니다.

플러그인 ZIP을 이용한 대체 설정: GWC Bridge 설정 페이지에서 ChatGPT용 ZIP 다운로드를 제공하는 경우에만 먼저 해당 페이지에서 내려받으세요. ChatGPT Plugins > Add > Upload plugin에서 ZIP을 업로드하고 GWC Bridge > Connect에서 PC와 같은 GWC 계정으로 로그인하세요. Open in desktop app이 보이면 데스크톱에서 완료하세요. 이 방법과 아래 Add custom MCP server 중 하나만 사용하세요.

4. 개인 설정

  1. ChatGPT 웹을 열고 탐색 사이드바에서 "Plugins"를 연 다음 "+" → "Add custom MCP server"를 선택하세요. 먼저 별도의 "Developer Mode" 토글을 켤 필요는 없습니다.
  2. 이름에 GWC Bridge(및 선택 사항인 설명)를 입력하고, "Connection"에서 "Server URL"을 선택한 뒤 https://mcp.gwc-corp.com/mcp를 입력하세요.
  3. "Authentication"을 "OAuth"로 설정하고, ChatGPT가 Client ID Metadata Documents(CIMD)를 통해 GWC의 OAuth 메타데이터를 자동으로 검색할 수 있도록 "Advanced OAuth settings"("Client ID"와 "Client Secret")는 비워 두세요. 클라이언트 시크릿을 입력하거나 "No authentication"을 사용하지 마세요.
  4. 서버별 위험 경고를 검토하고 "I understand and want to continue"를 선택한 뒤 "Create as a plugin"을 선택하세요. 브라우저에서 리디렉션되면 GWC 로그인 및 동의 절차를 완료한 다음, 플러그인 상세 페이지에서 검색된 도구와 메타데이터를 확인하세요.
  5. 개인 "Plugins"에서 해당 항목을 열고(또는 홈페이지를 "Chat"에서 "Work"로 전환하고), 웹에서 새 대화를 시작한 뒤 메시지 입력창의 "+" 버튼을 선택하거나 @ / /를 입력해 GWC Bridge를 선택하세요.
  6. 먼저 읽기 전용 확인 프롬프트(예: 파일 내용을 읽거나 파일을 편집하거나 명령을 실행하지 않고, 사용 가능한 컴퓨터를 식별하고 승인한 테스트 폴더의 파일 이름 목록을 확인)로 시작하세요. "Settings" → "Plugins" 또는 "Settings" → "Apps"에서 쓰기 및 명령 실행 확인을 활성화해 두세요. ChatGPT의 확인 요청 설정은 PC에서 GWC가 적용하는 폴더 및 명령 권한을 무시하거나 확대할 수 없습니다.[1]

5. 조직 또는 워크스페이스 설정

  1. 권한이 있는 Admin or Owner(관리자 또는 소유자)가 워크스페이스 생성 권한(Business에서는 "Workspace settings" → "Members", Enterprise/Edu에서는 RBAC로 "Create plugins with MCPs"를 부여할 수 있는 "Workspace settings" → "Permissions & roles")을 확인하고, "Plugins"에서 https://mcp.gwc-corp.com/mcp와 자격 증명을 비워 둔 "OAuth"로 GWC Bridge를 생성합니다.
  2. 워크스페이스에 배포하기 전에 웹의 새 대화에서 비공개로 테스트하세요. 민감한 정보가 없는 테스트 폴더에서 도구 선택, 인수, 허용된 접근 범위, 읽기 전용 폴더 목록 조회를 확인하세요. 첫 연결 테스트에 운영 데이터, 파일 삭제, 패키지 설치, 배포 또는 광범위한 셸 명령을 사용하지 마세요.
  3. GWC Bridge 플러그인 상세 페이지(또는 "Admin console" → "Plugins" → "Manage Legacy Apps" → "Drafts" / "Workspace Settings" → "Apps" → "Drafts" → "Publish")에서 Admin or Owner가 작업 제어 설정을 검토한 뒤 워크스페이스 또는 지정된 Enterprise/Edu 역할에 플러그인을 게시합니다. 워크스페이스 게시는 조직 내부에서만 플러그인을 공유하는 것이며, OpenAI 공개 디렉터리 등록 신청이 아닙니다.
  4. 각 워크스페이스 멤버는 "Settings" → "Plugins"(또는 "Settings" → "Apps")를 열고 GWC Bridge → "Connect"를 선택한 뒤 본인의 GWC 계정(활성 Connect Pass와 온라인 PC가 있는 계정)으로 로그인합니다. 플러그인에서 GWC 계정을 연결해도 사용자의 현재 ChatGPT 워크스페이스는 바뀌지 않습니다. 관리자의 자격 증명을 공유하거나 채팅에 토큰을 붙여 넣지 마세요.

게시되거나 연결된 MCP 플러그인의 캐시된 도구 정의는 새로고침하기 전까지 바뀌지 않습니다. GWC가 도구를 추가하거나 업데이트하면 권한이 있는 관리자나 사용자가 "Plugins" / "Apps" 설정에서 GWC Bridge 상세 페이지를 열고 "Refresh"를 선택해 플러그인을 삭제하지 않고 최신 도구, 설명, 서버 지침을 가져올 수 있습니다(.well-known OAuth 검색 메타데이터가 변경된 경우에는 플러그인을 다시 만드세요). Enterprise와 Edu에서는 관리자와 소유자가 게시 후 개별 앱 작업을 활성화하거나 비활성화할 수도 있습니다.[2]

액세스를 해제하려면 "Settings" → "Plugins"(또는 "Settings" → "Apps")를 열고 GWC Bridge를 선택한 다음 개별 계정의 "Disconnect"를 선택하거나, 워크스페이스의 "Plugins"(또는 "Manage Legacy Apps") 관리 페이지에서 게시된 플러그인을 비활성화 또는 제거하세요. 연결을 해제하면 앞으로의 원격 도구 호출은 중단되지만 과거 대화 기록은 삭제되지 않으며, 컴퓨터에서 이미 시작되어 장시간 실행 중인 로컬 프로세스가 자동으로 종료되지도 않습니다. 중단된 명령이나 파일 편집을 재시도하기 전에 반드시 PC의 GWC Studio 또는 GWC for VS Code를 확인하세요.[2]

6. 다른 클라이언트

OpenAI는 ChatGPT 웹을 대상으로 사용자 지정 MCP 워크스페이스 연결 및 개인 연결을 안내합니다. ChatGPT 모바일 앱이나 네이티브 데스크톱 앱에도 동일한 수동 MCP 설정이나 실행 경로가 있다고 가정하지 말고, 모바일 앱에서 반복해서 다시 연결하기보다 데스크톱 브라우저에서 ChatGPT를 계속 사용하세요.[2]

워크스페이스에 기존 사용자 지정 앱 관리 화면("Admin console" → 워크스페이스 → "Plugins" → "Manage Legacy Apps", 또는 "Workspace settings" → "Apps" → "Create"의 "Scan Tools"와 "Workspace Settings" → "Apps" → "Drafts")이 표시되는 경우, 실제 워크스페이스에서 해당 화면을 제공할 때만 사용하세요. 현재 "Plugins" 화면과 기존 "Apps" 화면의 절차를 섞어서 사용하지 마세요. 기존 메뉴가 보이지 않는다고 해서 GWC가 승인되었거나 거부되었다고 판단하지 마세요.[2]

7. 문제 해결

표시될 수 있는 내용다음 조치
설정 컨트롤이 없음 — "Add custom MCP server"ChatGPT 웹을 사용 중인지, 원하는 Business, Enterprise 또는 Edu 워크스페이스(또는 대상 계정)에 있는지, Admin/Owner 역할 또는 "Create plugins with MCPs" 권한이 있는 Enterprise/Edu 역할을 가지고 있는지 확인하세요.
invalid_client — Client ID/Secret 수동 입력 또는 client_id host is not allowed플러그인을 만들 때 "Client ID"와 "Client Secret"을 비워 두어 ChatGPT가 Client ID Metadata Documents(chatgpt.com / openai.com에 대한 client_id_metadata_document_supported: true)를 사용하도록 하고, GWC에 수동 지원 활성화 여부와 허용 호스트 목록을 확인해 달라고 요청하세요. GWC는 정적 시크릿이나 동적 클라이언트 등록(DCR)을 사용하지 않습니다.
invalid_request — redirect_uri is not registered by the clientChatGPT는 CIMD 메타데이터를 통해 https://chatgpt.com/connector_platform_oauth_redirect(콜백별 리디렉션이 적용되는 경우 https://chatgpt.com/connector/oauth/{callback_id})를 사용합니다. 회사 프록시나 방화벽이 redirect_uri를 변경하거나 resource 매개변수를 제거하지 않는지 확인하세요.
invalid_scope — Requested scope is not supported 또는 연결은 열리지만 도구가 표시되지 않음서버 URL이 https://mcp.gwc-corp.com/mcp이고 OAuth 로그인이 완료되었는지, 요청된 범위가 GWC의 활성 메타데이터와 일치하는지, OpenAI 커넥터 송신 IP(https://openai.com/chatgpt-connectors.json)에서 https://mcp.gwc-corp.com/.well-known/oauth-protected-resource에 접근할 수 있는지 확인하세요.
invalid_grant / GRANT_REVOKED 또는 토큰 만료 후 로그인을 반복해서 요청함GWC 권한 부여 서버(https://api.gwc-corp.com)는 PKCE(S256)를 사용하는 순환 교체 방식의 refresh_token 승인 유형을 지원합니다. 승인이 취소되었거나 갱신 메타데이터가 제공되기 전의 이전 앱 구성을 ChatGPT가 캐시한 경우 공식 UI를 통해 플러그인을 다시 만들거나 다시 연결하세요. 갱신 토큰을 재사용하거나 공유하지 마세요.
CONNECT_PASS_REQUIRED / connect_pass_required — Your GWC account does not currently have an active Connect Pass entitlement.로그인한 GWC 계정에 활성 상태의 GWC Personal Connect Pass(Connect Pass)가 있는지 확인하세요. 워크스페이스에 게시하거나 ChatGPT를 구독한다고 해서 Connect Pass가 부여되지는 않습니다.
PC_OFFLINE / DEVICE_NOT_ONLINE대상 컴퓨터가 온라인인지, GWC Studio 또는 GWC for VS Code가 실행 중이고 같은 GWC 계정으로 로그인되어 있는지 확인하세요. 알리지 않고 다른 컴퓨터로 전환하지 마세요.
ROOT_NOT_SHARED / PATH_PROTECTED대상 PC의 GWC Bridge에서 해당 폴더가 공유되어 있는지 확인하세요. 컴퓨터 소유자는 해당 폴더와 부여된 권한을 구체적으로 검토할 수 있으며, 보호된 경로는 계속 사용할 수 없습니다.
SCOPE_NOT_GRANTED / APPROVAL_DENIED / CLIENT_ACCESS_DISABLED(읽기는 작동하지만 쓰기 또는 명령이 거부됨)양쪽을 각각 확인하세요. (1) Enterprise/Edu 워크스페이스의 작업 제어나 ChatGPT 확인 요청이 호출을 차단했는지, (2) PC의 GWC Studio / GWC for VS Code에서 해당 폴더의 Change files 또는 Commands가 활성화되어 있는지 확인하세요.
UPDATE_REQUIRED 또는 GWC Bridge 업데이트 후 도구가 작동하지 않음공식 지원 경로를 통해 설치된 GWC 구성 요소를 업데이트한 뒤, ChatGPT의 "Plugins" / "Apps" 설정에서 GWC Bridge 상세 페이지를 열고 "Refresh"를 선택해 업데이트된 도구 스키마를 가져오세요.
RATE_LIMITED 또는 파일 편집/명령 실행 시간이 초과됨상태 읽기를 다시 시도하기 전에 잠시 기다리고, 먼저 컴퓨터의 파일이나 프로세스 상태를 확인하세요. 네트워크 시간 초과가 발생했다고 해서 PC에서 작업이 실행되지 않았다는 뜻은 아닙니다.
GWC_BRIDGE_PROTOCOL_ERROR (HTTP 500, -32603) — GWC Bridge could not complete this request. Check the connection and try again.다시 시도하기 전에 연결과 PC의 이전 작업 결과를 확인하세요. 지원팀에 문의할 때는 비밀번호, 토큰, 비공개 파일 내용을 제외하고 발생 시각, 워크스페이스 이름, 도구 이름, 오류 코드, 민감하지 않은 요청 ID를 기록하세요.
Internal server error / INTERNAL / temporarily_unavailable / HTTP 503GWC에 서비스 설정과 가용성을 확인해 달라고 요청하세요. 기본 비활성 경로는 일반적인 프로토콜 오류를 유지하며, 일반 도구 오류와 서비스 중단은 별도로 처리됩니다.

8. 개인정보와 권한

ChatGPT는 폴더 목록, 요청한 파일 내용, 명령 출력 등 허용된 GWC Bridge 도구 호출이 반환하는 출력을 받습니다. 도구가 반환한 content와 structuredContent는 모두 모델의 대화 컨텍스트에 들어가므로, ChatGPT에 파일을 읽거나 명령을 실행하도록 요청하는 사용자에게 파일 내용이 절대 PC 밖으로 나가지 않는다고 안내하지 마세요. ChatGPT가 도구를 호출하면 대화에서 생성한 도구 인수를 GWC Bridge와 연결된 컴퓨터로 보냅니다. GWC Studio 또는 GWC for VS Code에서 공유 폴더와 명령 권한을 작업에 필요한 범위로 제한하세요.

OpenAI는 ChatGPT Business, Enterprise, Edu의 워크스페이스 데이터를 연결된 플러그인과 앱을 통해 접근한 정보를 포함해 기본적으로 OpenAI 모델 학습에 사용하지 않는다고 명시합니다(조직의 데이터 보존 정책과 인증된 중계 요청에 대한 GWC의 데이터 처리 정책은 계속 적용됩니다). ChatGPT에서 GWC Bridge를 연결하면 해당 ChatGPT 연결만 승인되며 ChatGPT 대화가 다른 AI 클라이언트와 공유되지는 않습니다. 다른 어시스턴트를 같은 컴퓨터와 공유 폴더에 별도로 연결한 경우, 그 어시스턴트는 해당 공유 폴더의 디스크에 기록된 변경 사항만 볼 수 있습니다.

9. 공식 참고 자료

공급업체 절차는 2026-10-18에 확인하고 2026-10-19에 재확인했으며, 2026-10-21 (Asia/Singapore)에 독립적인 사실 확인을 거쳤습니다. 아래 자료는 공식 영어 출처입니다. 운영 중인 GWC 설정과 실제 콜백/토큰 갱신 수락 여부는 여전히 검증이 필요합니다.

  1. OpenAI Plugins quickstart.
  2. Connecting custom MCP servers in ChatGPT.
  3. Plugin authentication.