> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 커넥터 거버넌스

> 계정 소유권, 사용자 및 그룹, 제공업체 범위, Agent 권한 제한, 공유 계정 설정으로 워크스페이스의 커넥터 접근을 제어하세요.

커넥터 거버넌스는 워크스페이스가 연결하는 계정, 해당 계정을 사용할 수 있는 사람, Agent가 그 접근 권한을 사용하는 방식을 제어합니다.

> [!NOTE]
>
> 이 문서는 얼리 액세스 통합 설정을 다룹니다. 사용 가능한 제어 기능은 워크스페이스, 권한, 통합에 따라 다릅니다. 설정에 **통합 둘러보기** 대신 **전체 통합**이 표시되면 [커넥터 관리](https://docs.replit.com/ko/replitai/managing-connectors.md)를 참고하세요.

## 제어 기능 위치

대상 워크스페이스를 선택한 다음 **설정 > 통합**을 엽니다. 업데이트된 설정에는 다음 보기가 있습니다:

| 보기 | 포함 내용 |
| - | - |
| **통합 둘러보기** | 사용 가능한 서비스와 설정 옵션. 하나의 서비스에 여러 구성이 있을 수 있습니다. |
| **내 통합** | 사용할 수 있는 구성과 계정, 로그인 작업, 기본 권한 선택. |
| **워크스페이스 통합 (관리자)** | 워크스페이스 구성, 대상, 설정, 연결된 프로젝트 또는 채팅. 이 보기를 사용하려면 워크스페이스 관리자 권한이 필요합니다. |

**관리 가능** 권한이 있는 구성원은 관리자 보기에 접근하지 않고도 **내 통합**에서 개별 구성을 관리할 수 있습니다.

**구성**은 계정 유형, 제공업체 설정, 대상을 포함하여 서비스의 설정을 정의합니다. **연결**은 해당 구성을 통해 연결된 계정입니다.
**구성 이름**은 개발 계정과 프로덕션 계정을 따로 두는 경우처럼 서비스에 여러 구성이 있을 때 각 설정을 식별합니다.
구성을 저장한다고 해서 항상 계정이 연결되는 것은 아닙니다. 개인 구성은 이후 각 구성원이 로그인해야 합니다.

## 계정 유형 및 프로토콜

설정에서는 통합이 지원하는 조합만 제공합니다. 계정 유형에 따라 연결이 누구의 자격 증명을 사용하는지 결정됩니다.

| 계정 유형 | 동작 |
| - | - |
| **개인** | 각 구성원이 자신의 제공업체 계정을 연결합니다. 구성을 공유해도 한 구성원의 자격 증명이 모두에게 공유되지는 않습니다. |
| **공유** | 구성원이 동일하게 연결된 제공업체 계정을 사용하며, 해당 계정의 접근 권한 부여 및 동의에 따릅니다. |
| **서비스 계정** | 전용 비인간 계정이 자격 증명을 제공합니다. 사용 가능 여부는 제공업체에 따라 다릅니다. |

프로토콜은 통합을 사용하는 방식을 결정합니다. **MCP**는 Agent 대화를, **HTTP**는 앱과 자동화를, **Git**은 리포지토리를, **Database**는 데이터베이스 접근을 지원합니다.
모든 통합이 모든 프로토콜을 제공하는 것은 아닙니다. 일부 프로토콜은 별도의 구성과 승인 절차가 필요합니다.

## 대상 및 역할

**접근 권한이 있는 사용자**는 구성을 사용할 수 있는 사람을 결정합니다. 향후 구성원을 포함하는 **워크스페이스의 모든 사용자** 또는 **선택한 사용자 및 그룹**을 선택할 수 있습니다.

| 역할 | 구성 접근 |
| - | - |
| **사용 가능** | 구성을 보고 이를 통해 계정을 연결합니다. 프로젝트나 채팅에서 연결을 사용할 때는 계정 동의 및 접근 확인이 계속 적용됩니다. |
| **관리 가능** | 구성을 사용 및 편집하고, 대상을 관리하며, 구성을 제거합니다. |

선택한 사용자 및 그룹을 지정하는 경우에도 워크스페이스 관리자는 관리 접근 권한을 유지합니다. 하나의 대상 항목을 제거해도 다른 그룹을 통해 부여된 접근 권한은 제거되지 않습니다.

**대상** 보기는 사용자에게 표시되는 저장된 수신자를 나열합니다. 모든 사람의 실제 유효 접근 권한을 완전히 계산한 결과는 아닙니다.
그룹 멤버십 및 기타 권한 부여에 대해서는 [그룹 및 권한](https://docs.replit.com/ko/teams/groups-and-permissions.md)을 참고하세요.

## 제공업체 구성 및 범위

**Replit 기본값**은 Replit이 구성한 제공업체 앱을 사용합니다. **사용자 지정**은 지원되는 경우 OAuth 클라이언트나 서비스 엔드포인트와 같은 자체 제공업체 구성을 사용합니다.
필요한 필드는 제공업체에 따라 다릅니다. 저장된 자격 증명은 편집기에 표시되지 않습니다.

**커넥터 범위**는 연결이 요청할 수 있는 제공업체 권한을 결정합니다. 의도한 작업에 필요한 범위를 선택하세요.
필수 범위와 기존 연결에서 사용 중인 범위는 잠겨 있을 수 있습니다.

> [!NOTE]
>
> 기존 OAuth 연결은 다시 연결하기 전까지 현재 제공업체 권한을 유지합니다. 구성 범위를 변경하면 새 연결과 재연결에 적용됩니다.

Agent의 권한 모드를 변경해도 제공업체 범위가 추가되지는 않습니다. **항상 허용**은 연결된 계정에 없는 접근 권한을 부여할 수 없습니다.

## Agent 권한 선택 및 워크스페이스 제한

**기본 권한**은 연결에 대해 저장한 사용자의 선택입니다. **워크스페이스 Agent 권한 제한**은 워크스페이스 전체에서 Agent 사용을 제한하는 관리자 제어입니다.
승인을 지원하는 대화형 Agent 작업에서 각 모드의 의미는 다음과 같습니다:

| 모드 | 의미 |
| - | - |
| **항상 묻기** | 데이터를 읽거나 변경하기 전에 묻습니다. |
| **알아서 결정** | 잠재적으로 위험한 것으로 감지된 작업에 대해 묻습니다. 모든 쓰기 전에 묻는다는 보장은 아닙니다. |
| **항상 허용** | 연결의 기존 접근 권한 범위 내에서 승인 프롬프트 없이 읽고 변경합니다. |
| **비활성화됨** | 해당 권한 설정이 적용되는 사용을 차단합니다. |

> [!WARNING]
>
> 얼리 액세스 기간 동안 일부 기본 권한 선택기는 환경설정만 저장하며 Agent 동작을 변경하지 않는다고 안내합니다. 이러한 선택기로 승인을 요구하도록 의존하지 마세요. 사용 가능한 접근 제어와 제공업체 권한을 사용하여 민감한 데이터나 작업을 제한하세요.

워크스페이스 제한 섹션은 **내 통합** 아래에 표시됩니다. 관리자는 **전체 통합** 및 개별 커넥터 제한을 설정할 수 있습니다.
개별 커넥터 제한은 더 엄격한 워크스페이스 전체 제한을 완화할 수 없습니다. 구성원은 권한 제어가 적용되는 곳에서 더 엄격한 설정을 선택할 수 있습니다.
정책 변경은 실행 중인 Agent가 수행하는 확인을 포함하여 이후의 확인에 적용됩니다.

사용자 지정 MCP 서버의 경우 **MCP 오리진 재정의**는 서버의 오리진, 즉 스킴, 호스트, 포트에 적용됩니다.
같은 오리진의 서로 다른 경로는 해당 제한을 공유합니다. 제공되는 경우 **제한 없음**은 워크스페이스 전체 제한은 제거하지 않고 해당 재정의만 제거합니다.

이러한 제어 기능이 앱이나 무인 실행에서 대화형 승인 프롬프트를 표시하게 만들지는 않습니다.
**워크스페이스 Rep**은 자체 접근 권한을 가진 Agent입니다. Rep은 자체 연결 권한을 사용하며 구성원의 개인 기본 권한을 상속하지 않습니다.
**비활성화됨** 워크스페이스 제한은 여전히 Rep의 사용을 차단합니다.

## Agent 지침

**Agent 지침**은 사용할 채널이나 레코드 형식 지정 방법과 같이 구성을 사용하기 위한 안내를 추가합니다.
이러한 지침은 충돌할 경우 커넥터의 지침보다 우선하지만 추가 접근 권한을 부여하지는 않습니다.

지침은 안내일 뿐이며 대상 제한, 제공업체 범위 또는 강제 적용되는 권한 제한을 대체하지 않습니다.
자격 증명은 Agent 지침이 아니라 제공업체의 자격 증명 필드에 보관하세요.

## 계정 및 자격 증명 변경

사용 가능한 작업은 계정 유형과 권한에 따라 다릅니다:

* **로그인** 또는 **연결**은 저장된 구성을 통해 계정 연결을 생성합니다.
* **재승인**은 지원되는 경우 제공업체 승인을 갱신합니다.
* **공개 설정 편집**은 저장된 자격 증명을 유지하면서 표시되는 구성 필드를 업데이트합니다.
* **자격 증명 교체**는 동일한 제공업체 계정에 대한 전체 교체 자격 증명이 필요합니다. 저장된 비밀 값은 계속 숨겨집니다.

편집기에서 **개발**과 **프로덕션**을 구분하는 경우 공유 계정의 자격 증명을 교체하기 전에 선택한 환경을 확인하세요.
저장이 확인되지 않으면 표시되는 재시도 작업을 사용하여 해당 시도를 계속하세요. 페이지에서 새로고침이나 재시작 안내가 표시되면 따르세요.

## 상태 및 연결된 프로젝트

연결된 계정 없이 저장된 구성이 존재할 수 있습니다. **계정 연결됨 · 상태 확인 안 됨**은 계정이 저장되어 있지만 실시간 상태 결과가 없음을 의미합니다.
**마지막 확인** 시간은 기록된 결과를 가리키며, 지금 제공업체에 연결할 수 있다는 보장은 아닙니다.

**연결** 보기는 구성에 연결된, 표시 가능한 프로젝트, 게시된 프로젝트, 채팅 또는 Rep을 보여줍니다.
이는 현재 연결 목록이며 제공업체 계정 목록이나 과거 사용 로그가 아닙니다.

## 로그아웃, 공유 연결 해제 및 제거

이러한 작업은 서로 다른 효과가 있습니다:

| 작업 | 효과 |
| - | - |
| **로그아웃** | 선택한 저장된 개인 연결을 삭제합니다. 제공업체의 승인을 취소하지는 않습니다. |
| **공유 계정 연결 해제** | 해당 공유 연결을 제거합니다. 계정을 사용하는 모든 사용자가 접근 권한을 잃지만 구성은 유지됩니다. 제공업체 승인은 취소되지 않습니다. |
| **구성 제거** | 구성과 해당 연결을 삭제합니다. 연결된 앱과 채팅은 접근 권한을 잃습니다. 제공업체 계정이나 제공업체 데이터는 삭제하지 않습니다. |

제공업체에서 승인을 취소하려면 해당 제공업체의 계정 또는 앱 설정을 사용하세요.
제거를 확인하기 전에 영향을 받는 계정과 구성을 검토하세요.

## 관련 문서

* [커넥터 관리](https://docs.replit.com/ko/replitai/managing-connectors.md)는 일반적인 통합 설정과 가용성을 다룹니다.
* [그룹 및 권한](https://docs.replit.com/ko/teams/groups-and-permissions.md)은 워크스페이스 멤버십과 접근 권한 부여를 설명합니다.
* [MCP로 연결하기](https://docs.replit.com/ko/build/connect-via-mcp.md)는 사용자 지정 MCP 서버 설정을 다룹니다.
