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

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

화면 레이블 안내: 따옴표 안의 레이블은 공급업체의 영어 인터페이스 문서를 따릅니다. 번역된 레이블은 확인하지 않았으며 실제 화면과 다를 수 있습니다. GWC Bridge를 사용하면 GWC for VS Code 또는 GWC Studio가 실행 중인 본인의 PC에서 Claude가 허용된 파일과 명령을 다룰 수 있습니다. 이 가이드에서는 Claude의 사용자 지정 커넥터 설정을 사용하며, 서버를 수동으로 추가한다고 해서 Anthropic이 해당 서버를 검토하거나 보증했다는 뜻은 아닙니다.

1. 누가 사용할 수 있나요?

Claude는 Free, Pro, Max, Team, Enterprise 플랜에서 사용자 지정 원격 커넥터를 지원합니다. Free 계정은 사용자 지정 커넥터를 하나만 사용할 수 있습니다. Team 플랜에서는 "Owner"(소유자) 또는 "Primary Owner"(주 소유자)가 먼저 조직에 GWC Bridge를 추가해야 합니다. Enterprise 플랜에서는 "Owner", "Primary Owner" 또는 "Manage access to Libraries"(라이브러리 액세스 관리) 권한이 포함된 사용자 지정 역할을 가진 멤버가 먼저 추가해야 합니다.^[1]

Claude Code를 사용하려면 지원되는 구독이나 조직의 이용 계약에 따른 별도의 Claude Code 이용 자격이 필요합니다. Free Claude 계정만으로는 Claude Code를 이용할 수 없습니다.^[3]

2. 시작하기 전에

1. GWC 계정과 활성 상태의 Connect Pass를 준비하고, Claude가 사용할 PC에서 GWC for VS Code 또는 GWC Studio를 실행해 연결해 두세요.
2. PC 앱과 Claude 커넥터 승인에서 동일한 GWC 계정으로 로그인하세요. Claude에 GWC Bridge URL을 추가해도 PC 구성 요소가 설치되지는 않습니다.
3. 공개할 파일, 폴더, 명령 권한을 확인하고, 처음에는 필요한 최소한의 액세스만 허용하세요.
4. GWC Bridge는 인증되지 않았거나 이용 자격이 없는 호출자의 요청을 거부합니다. URL을 추가하거나 도구 목록이 보인다고 해서 이러한 확인 절차를 우회할 수 없습니다.

3. 서버 주소와 OAuth

다음 서버 주소를 사용하세요.

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

GWC Bridge는 Claude가 공개한 Client ID Metadata Document(CIMD)와 PKCE를 사용해 자동으로 인증합니다. OAuth Client ID나 OAuth Client Secret은 입력할 필요가 없으며, 입력해서도 안 됩니다. 비밀번호, 액세스 토큰, 클라이언트 시크릿을 Claude 대화나 요청 헤더에 붙여 넣지 마세요.^[4]

플러그인 ZIP을 이용한 대체 설정: GWC Bridge 설정 페이지에서 Claude용 ZIP 다운로드를 제공하는 경우에만 먼저 해당 페이지에서 내려받으세요. Claude Customize > Plugins > Add > Upload plugin에서 ZIP을 업로드하고 GWC Bridge > Connectors > Connect에서 PC와 같은 GWC 계정으로 로그인하세요. 이 방법과 아래 Add custom connector 중 하나만 사용하세요.

4. 개인 설정(Free, Pro, Max)

1. claude.ai(또는 Claude Desktop)에서 사용할 Claude 계정에 로그인하고 "Customize" → "Connectors"(사용자 지정 → 커넥터)를 엽니다.
2. "+ Add"(+ 추가) 또는 "+" → "Add custom connector"(사용자 지정 커넥터 추가)를 선택합니다. 통합 메뉴 레이아웃에서는 "Add" → "Custom" → "Web"을 선택합니다.
3. 커넥터 이름을 GWC Bridge로 지정하고 https://mcp.gwc-corp.com/mcp를 입력합니다. 대화 상자에 선택 사항인 OAuth Client ID와 OAuth Client Secret을 입력하는 "Advanced settings"(고급 설정) 섹션이 표시되면 두 필드를 모두 비워 두세요.
4. "Continue"(계속)(한 단계로 구성된 대화 상자를 사용하는 경우 "Add")를 클릭해 감지된 인증 설정을 확인합니다. "Authentication"(인증)에서 "Sign in now"(지금 로그인)를 유지하고("No sign in"은 선택하지 마세요), "OAuth client"(OAuth 클라이언트)에서 "Use Claude's published identity (Recommended)"(Claude의 공개 ID 사용[권장])를 유지하며(GWC Bridge는 동적 클라이언트 등록을 사용하지 않으므로 "Register automatically"나 "Use your own OAuth client"는 선택하지 마세요), "Request headers"(요청 헤더)는 비워 둡니다.
5. "Add"를 클릭해 커넥터 생성을 완료한 다음, 로그인이 아직 시작되지 않았다면 "Connect"(연결)를 클릭하고 브라우저에서 GWC 로그인 및 동의 절차를 완료하세요.
6. "Customize" → "Connectors"에서 GWC Bridge가 연결됨 상태로 표시되는지 확인하고, 대화에서 "+" → "Connectors"(또는 "Search and tools" 메뉴)를 열어 GWC Bridge를 활성화한 뒤, 파일 변경과 명령 실행에 승인이 필요한 설정을 유지하면서 읽기 전용 첫 확인(Use GWC Bridge to show which of my computers and shared folders are available. Do not change files or run commands.)을 실행해 Claude의 응답뿐 아니라 실제 도구 결과를 확인하세요.^[1]

5. 조직 설정(Team, Enterprise)

1. 조직의 "Owner" 또는 "Primary Owner"(Enterprise에서는 "Manage access to Libraries" 권한이 포함된 사용자 지정 역할을 가진 사람도 가능)가 "Organization settings" → "Connectors" → "Add" → "Custom" → "Web"(또는 "Add custom connector")을 엽니다.
2. 이름에 GWC Bridge, 서버 URL에 https://mcp.gwc-corp.com/mcp를 입력한 다음 "Continue"를 클릭합니다.
3. 감지된 인증 설정인 "Sign in now"와 "Use Claude's published identity (Recommended)"를 유지하고, "Request headers"와 자체 OAuth 클라이언트 자격 증명을 입력하는 필드는 모두 비워 두고 "Add"를 클릭합니다.
4. 커넥터가 조직에 추가되면 각 멤버가 "Customize" → "Connectors"를 열고 "Custom" 라벨이 붙은 GWC Bridge를 찾아 "Connect"를 클릭해 자신의 GWC 계정으로 로그인한 뒤, 대화의 "+" → "Connectors"(또는 "Search and tools")에서 활성화합니다.

조직에서 커넥터를 사용할 수 있게 해도 멤버가 자동으로 로그인되는 것은 아닙니다.^[1]

6. iPhone·Android 및 Claude Code

먼저 Claude 웹 또는 Claude Desktop에서 GWC Bridge 설정과 인증을 완료한 뒤, Claude iOS 또는 Android 앱에서 같은 Claude 계정(조직을 사용한다면 같은 조직)으로 로그인하세요. 계정에 설정된 웹 커넥터는 Claude Mobile에서도 사용할 수 있습니다. 모바일에서 커넥터를 직접 설치하는 기능은 현재 베타 버전이므로 사용자 지정 커넥터는 Claude Desktop과 웹에서 먼저 설정하는 것이 기본입니다.^[2]

Claude Code에서는 먼저 /mcp를 확인하세요. Claude 계정으로 로그인하면 claude.ai에서 추가한 커넥터가 이미 자동으로 로드되어 있을 수 있으므로 중복 CLI 항목을 추가하지 마세요. CLI로 GWC Bridge를 직접 추가하거나 제거하려면 터미널에서 다음 명령을 실행하세요.^[3]

claude mcp add --transport http --scope user gwc-bridge https://mcp.gwc-corp.com/mcp
claude mcp remove gwc-bridge --scope user

추가한 뒤 Claude Code를 시작해 /mcp를 실행하고, gwc-bridge를 선택한 다음 "Authenticate"(인증)를 선택해 브라우저에서 GWC 로그인 절차를 완료합니다. user 범위를 지정하면 해당 컴퓨터의 모든 프로젝트에서 이 서버를 사용할 수 있습니다. 서버 상태를 확인하고 위의 읽기 전용 첫 확인을 진행하세요. 조직에서 Claude Code가 로드할 수 있는 MCP 서버를 제한할 수 있으므로 인증 방식을 바꾸거나 계정을 전환해 조직 정책을 우회하려고 하지 마세요.^[3][4]

7. Claude가 볼 수 있는 것과 연결 해제·제거 방법

GWC Bridge는 단순히 도구 이름 목록을 제공하는 기능이 아닙니다. 허용된 도구가 파일을 읽거나 명령 출력을 반환하면 해당 내용이 Claude에 전송됩니다. 커넥터는 MCP 리소스와 워크플로 프롬프트를 제공할 수도 있습니다. GWC Bridge에서 사용할 수 있는 작업은 GWC 권한과 PC 폴더 정책에 따라 달라집니다. Claude의 도구 권한 설정으로 Claude가 호출할 수 있는 도구를 제한할 수는 있지만, GWC Bridge가 거부한 액세스를 허용할 수는 없습니다. 특히 파일 편집, 파일 삭제, 명령 실행 전에는 승인 요청의 내용을 주의 깊게 확인하세요. claude.ai, Claude Desktop, Cowork, Claude Mobile에서 Claude는 Anthropic의 클라우드 인프라를 통해 원격 MCP 서버에 연결합니다. URL을 추가한다고 해서 자동 화면 제어, 무제한 파일 액세스 또는 승인되지 않은 명령 실행이 허용되는 것은 아니며, GWC에서 허용한 공유 폴더와 기능만 사용할 수 있습니다.

GWC Bridge 연결을 해제하거나 제거하려면 "Customize" → "Connectors"를 열고 GWC Bridge를 선택합니다.

• "Disconnect"(연결 해제)를 선택하면 Claude가 GWC Bridge에서 로그아웃되지만 커넥터는 목록에 남습니다.
• 커넥터 메뉴의 "Remove" / "Delete"(제거 / 삭제)를 선택하면 개인용 사용자 지정 커넥터가 계정에서 제거됩니다.
• Team 및 Enterprise 플랜에서 "Organization-wide removal"(조직 전체에서 제거)은 권한이 있는 소유자가 "Organization settings" → "Connectors"에서 수행해야 합니다.
• 대화의 "+" → "Connectors" 또는 "Search and tools" 메뉴에서 커넥터를 끄면 해당 대화에서만 비활성화됩니다. 커넥터가 claude.ai 계정에서 동기화되었거나 조직에서 제공한 경우에는 Claude의 커넥터 설정에서 관리하거나 제거하세요(또는 /mcp에서 본인의 사용만 끌 수 있습니다).

8. 문제 해결

GWC 지원팀에 문의할 때는 사용 중인 Claude 앱 또는 이용 환경, Claude 플랜 유형, 문제가 발생한 단계, 오류 메시지나 참조 ID를 포함해 주세요. 비밀번호, Bearer 토큰, 클라이언트 시크릿 또는 비공개 파일 내용은 보내지 마세요.

9. 공식 참고 자료

공급업체 절차는 2026-10-21 (Asia/Singapore)에 Anthropic의 공식 영어 문서와 대조하여 확인했습니다.

1. Get started with custom connectors using remote MCP.
2. Use connectors to extend Claude's capabilities.
3. Claude Code: Connect to tools via MCP.
4. Authentication for connectors.