Claude에서 기업 관리형 인증 설정하기

기업 관리형 인증(EMA)을 통해 관리자는 Claude 조직에 HubSpot 커넥터를 설정할 수 있습니다. 그러면 자격을 갖춘 구성원은 커넥터를 직접 설치하거나 별도의 연결을 승인할 필요 없이 Claude에서 HubSpot이 이미 연결된 상태를 확인할 수 있습니다.

Claude에서 발급하는 관리형 권한 부여를 통해 관리자는 Claude에서 자동 액세스 권한을 받을 사용자를 선택하고, HubSpot에서 커넥터의 액세스 권한을 관리할 수 있습니다. 각 구성원은 기존 HubSpot 권한을 유지한 채 자신의 HubSpot 계정으로 연결됩니다. 

시작하기 전에

인증 설정을 시작하기 전에 다음 역할과 필수 전제 조건을 확인하십시오.

• HubSpot 커넥터에 대해 Claude에서 발급한 관리형 인증을 사용할 수 있는 Claude Team 또는 Enterprise 조직.
• Claude에서 커넥터를 관리할 수 있는 관리자와 승인된 앱을 관리할 수 있는 HubSpot 슈퍼 관리자가 필요합니다. 필요한 경우 한 사람이 이 두 역할을 모두 수행할 수 있습니다.
• HubSpot 커넥터는 Claude 조직의커넥터 설정에서 사용할 수 있습니다.
• 연결하려는 HubSpot 계정의 관리자가 HubSpot 커넥터를 설치해야 합니다. 다른 팀원을 위해 EMA를 구성하기 전에 이 기존 연결을 먼저 사용할 수 있습니다.
• 커넥터를 사용할 각 팀 구성원마다 활성 상태인 HubSpot 사용자 계정이 있어야 합니다. 각 구성원의 Claude 이메일 주소는 확인된 HubSpot 이메일 주소와 일치해야 합니다.

관리자가 대상 HubSpot 계정에 커넥터를 설치하지 않은 경우, 이 지침에 따라 Claude용 HubSpot 커넥터를 설정하여 초기 연결을 완료하십시오. 그런 다음, 진행하기 전에 앱의 승인 및 액세스 설정을 검토하십시오.

각 팀 구성원이 HubSpot에서 올바른 권한을 설정했는지 확인하십시오. 현재 지원되는 도구의 경우, 팀 구성원은 커넥터에서 허용된 범위 및 데이터 권한에 따라 Claude에서도 동일한 HubSpot 권한 및 권한 부여를 사용합니다.

Claude의 관리형 권한 설정 및 역할 제어에 대해 자세히 알아보세요.

Claude 및 HubSpot의 액세스 설정

아래 표는 Claude와 HubSpot의 다양한 액세스 설정을 요약한 것입니다:

Claude에서 특정 사용자에게 커넥터에 대한 액세스 권한을 부여한다고 해서 HubSpot 사용자가 생성되거나 해당 사용자의 HubSpot 권한이 확대되지는 않습니다. 팀을 위해 연결을 활성화하기 전에 두 서비스의 액세스 권한을 모두 검토하십시오.

Claude는 커넥터의 관리자 및 사용자가 구성한 이메일 주소를 통해 현재 귀하의 Claude 조직 구성원임을 확인합니다. 별도의 ID 제공자 로그인을 확인하거나 해당 제공자의 다단계 인증(MFA) 요구 사항 또는 HubSpot의 로그인 규칙을 확인하지는 않습니다. Anthropic은 Claude에서 단일 로그인(SSO)을 적용할 것을 권장합니다.

관리형 인증 설정

아래 단계에서는 현재 커넥터 권한을 확인하고, Claude 설정에서 조직의 발급자 URL을 찾고, EMA를 활성화한 다음, 연결 상태를 테스트하는 방법을 안내합니다.

1. HubSpot에서 커넥터의 액세스 권한 확인

먼저, Claude용 HubSpot 커넥터의 현재 권한을 확인하세요:

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서‘통합’ >‘연결된 앱’으로 이동합니다.
3. '승인된 앱 ' 탭을 클릭합니다.
4. 'Claude용 HubSpot 커넥터'를 찾아'액세스 관리'를 클릭합니다.
5. '설정된 권한' 탭을 클릭하고, 앱에 연결할 수 있는 사용자를 확인합니다. Claude에서 자동으로 액세스 권한을 부여받아야 하는 HubSpot 사용자를 포함시키십시오. 팀원은 또한 Claude에서 커넥터에 대한 액세스 권한을 가지고 있어야 하며, 관리형 권한 부여를 위해 선택된 역할에 속해 있어야 합니다.
6. '데이터 권한' 탭을 클릭하고, 커넥터가 액세스할 수 있는 데이터 및 API를 확인하십시오. 팀에 필요한 권한을 추가한 다음 변경 사항을 저장하십시오.

HubSpot의 앱 데이터 권한은 관리자를 포함한 모든 사용자에게 적용됩니다. 필수 권한은 비활성화할 수 없습니다. 앱 액세스 관리에 대해 자세히 알아보세요.

별도의 탭에서 Claude 계정에 접속하는 동안 이 HubSpot 페이지를 열어 두십시오.

2. Claude 조직의 발급자 URL 확인

다음으로, Claude 설정에서 발급자 URL을 찾아 복사하세요. 이 URL은 HubSpot이 회원을 연결할 때 신뢰할 Claude 조직을 식별하는 정보입니다.

1. In Claude에서 ‘조직 설정 ’ > ‘커넥터 ’로 이동하여 HubSpot을 선택하세요.
2. In 커넥터설정에서 '관리형 인증'을 찾아 설정을 엽니다.
3. '신원 소스'에서 'Claude 발급'을 선택하세요.
4. Co설정 화면에 표시된 전체 Issuer URL을 복사하세요. Claude에 '수동으로 설정'이 표시되면 , 이를 확장하여 URL을 확인하세요.

이 설정 페이지를 별도의 브라우저 창이나 탭에 열어 두십시오. HubSpot에서 EMA를 활성화한 후 이 페이지로 다시 돌아오게 됩니다.

3. HubSpot에서 EMA 활성화

복사해 둔 발급자 URL을 사용하여 HubSpot에서 EMA를 구성하세요:

1. R설정nHubSpot의 커넥터 '액세스 관리' 패널로 돌아갑니다.
2. '고급' 탭을 클릭합니다.
3. '엔터프라이즈 관리 인증(EMA)' 토글을클릭하여 설정 화면을 엽니다.
4. C패널에 표시된 계정 ID 를 복사합니다. 이 ID는 연결하려는 HubSpot 계정이며, Claude에서 테넌트 ID로 사용하게 됩니다.
5. Claude에서 가져온 전체 URL을 ‘발행자 URL( Issuer URL)’ 필드에 붙여넣으세요.
6. 'EMA 켜기'를 클릭합니다.
7. C상태가 ‘On’으로 표시되어 있고, 저장된 발급자 URL이 올바른지 확인하십시오.

EMA 설정이 없는 경우, 아래의 문제 해결 섹션을 확인하세요.

4. Claude에서 연결 테스트 및 활성화

EMA 구성이 완료되었으므로, Claude에서 연결을 테스트해 보세요:

1. RClaude의 관리형 승인 설정 화면으로 돌아갑니다.
2. 다음의 TenID 필드에는 복사해 둔 HubSpot 계정 ID를 입력하세요. Claude에서는 이 필드를 선택 사항으로 표시하지만, HubSpot 연결을 위해서는 반드시 입력해야 합니다.
3. '테스트 실행'을 클릭하고 모든 단계가 성공적으로 완료되었는지 확인하세요.
4. C‘계속’을 클릭하여 역할 설정을 엽니다. 관리형 인증을 통해 연결할 역할을 선택합니다. 조직에 이 기능을 활성화하기 전에 선택 내용을 다시 한 번 검토하십시오.
5. Clikk 활성화.
6. 커넥터 d패널에서 ‘관리형 권한 부여’가 켜져 있고, ‘적용된 역할’에 선택한 역할이 나열되어 있는지 확인하십시오.
7. '관리형 권한 부여'에서 '범위 ' 옆에 있는 '편집'을 클릭하여 Claude가 요청할 수 있는 권한을 검토하고 업데이트하십시오.
8. Re'접근 권한이 있는 역할'을 검토하여 대상 구성원이 커넥터를 찾아 연결할 수 있는지 확인하십시오. 이 접근 권한을 변경해야 하는 경우 '편집'을 클릭하십시오.

Claude의 두 가지 역할 설정이 모두 중요합니다. 구성원은 커넥터에 대한 액세스 권한이 있어야 하며, 자동으로 연결되려면 해당 역할이 관리형 권한에 포함되어야 합니다. 또한 구성원은 앞서 설명한 HubSpot 계정, 이메일 및 설치 권한 요건을 충족해야 합니다. Claude의 역할 설정에 대한 자세한 내용은 이 Claude 지원 문서를 참조하십시오.

구성원 사용 환경 확인

조직에 변경 사항을 공지하기 전에, 몇 명의 팀원에게 연결 상태를 확인해 달라고 요청하세요:

1. Open 관리형 권한 부여가 활성화된 조직 내의 Claude.
2. Confirm tHubSpot이 연결된 것으로 표시되는지 확인합니다. 필요한 경우 해당 대화에 대한 커넥터를 활성화하십시오.
3. 다음과 같이 데이터를 변경하지 않는 요청으로 시작하세요: “현재 어떤 HubSpot 계정과 사용자로 연결되어 있나요?” 데이터를 변경하지 마세요.
4. C응답에 예상한 HubSpot 계정과(가능한 경우) 팀원의 사용자 세부 정보가 포함되어 있는지 확인하십시오.
5. Tty 해당 팀원이 HubSpot에서 액세스할 수 있는 레코드를 읽을 수 있는지 요청해 보십시오.

일부 사용자 세부 정보에는 추가 권한이 필요합니다. 해당 세부 정보가 없더라도 연결된 계정과 허용된 레코드 읽기 권한은 확인할 수 있습니다. 선택적 세부 정보가 누락되었다고 해서 인증이 실패한 것은 아니므로, 이 확인을 완료하기 위해 불필요한 추가 액세스 권한을 부여하지 마십시오.

접근 요건을 충족하는 팀 구성원은 개별 HubSpot 로그인이나 연결 동의 화면을 거칠 필요가 없습니다. EMA는 CRM 레코드 업데이트와 같은 개별 도구 작업에 대해 구성한 승인 요청을 제거하지 않습니다.

설정 후 액세스 관리

설정 후 팀 구성원의 액세스 권한을 업데이트하려면:

1. Claude 계정에서 Claude 커넥터 세부 정보 패널을 엽니다.
2. '관리형 인증' 섹션에서 '적용된 역할' 옆의 '편집'을 클릭하여 관리형 인증을 사용할 역할을 변경하세요.
3. 커넥터를 찾고 연결할 수 있는 사용자를 변경하려면 '접근 권한이 있는 역할' 옆의 '편집'을 클릭하세요. 
4. '범위' 옆의'편집'을 클릭하여 Claude가 요청할 수 있는 권한을 관리하세요.

HubSpot에서 ‘권한 설치’ 탭을 검토하여 앱에 연결할 수 있는 사용자를 변경하고, ‘데이터 권한’ 탭을 통해 앱이 액세스할 수 있는 데이터 및 API를 관리하세요. 각 팀원은 계속해서 자신의 HubSpot 권한을 사용합니다.

이 문서에서 커넥터의 일반적인 기능 및 사용 지침에 대해 자세히 알아보세요.

구성원의 액세스 권한 제거

Claude와 HubSpot 모두에서 조직의 퇴사 절차를 따르십시오. Claude 조직에서 특정 사용자를 제거하면 Claude가 해당 사용자에 대한 새로운 신원 확인 정보를 발급하지 않게 됩니다. 이미 발급된 액세스 토큰은 만료되거나 취소될 때까지 계속 사용할 수 있으므로, 액세스 권한을 즉시 제거하기 위해 회원 자격 변경에만 의존하지 마십시오.

전직 구성원의 이메일 주소를 다른 사람에게 할당하기 전에, 조직의 퇴사 절차를 통해 해당 전직 구성원을 HubSpot 사용자에서 제거하십시오. 커넥터 접근 권한만 제거하는 것은 해당 이메일 주소와 연결된 기존 HubSpot 사용자를 제거하지 않습니다.

EMA 비활성화

EMA를 비활성화하려면:

1. In Claude에서 HubSpot 커넥터의 ‘관리형 인증’ 설정을 열고 ‘비활성화’를 클릭하세요.
2. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
3. 왼쪽 사이드바 메뉴에서‘통합’ >‘연결된 앱’ >‘승인된 앱’으로 이동합니다.
4. 해당 커넥터를 찾아‘액세스 관리’를 클릭한 다음‘고급’을 선택하세요.
5. '엔터프라이즈 관리 인증(EMA) ' 스위치를 클릭하여 비활성화한 다음,'비활성화'를 클릭하여 확인하십시오.

관리형 인증을 비활성화하면 자동 연결이 종료됩니다. 커넥터가 여전히 필요한 구성원은 조직의 설정 및 HubSpot 설치 권한에 따라 개별적으로 연결해야 합니다. 기존 액세스 토큰은 만료되거나 취소될 때까지 유효할 수 있습니다.

문제 해결

아래 섹션에서는 설정 과정에서 발생할 수 있는 일반적인 오류에 대한 해결 방법을 안내합니다.

EMA 설정을 사용할 수 없음

본인이 HubSpot 슈퍼 관리자인지, 올바른 HubSpot 계정에 로그인되어 있는지, 그리고 Claude용으로 승인된 HubSpot 커넥터를 관리하고 있는지 확인하십시오. ‘고급’ 메뉴 아래에 엔터프라이즈 관리형 인증(EMA)이 여전히 표시되지 않는 경우, HubSpot 지원팀에 문의하여 해당 계정과 커넥터에 대한 사용 가능 여부를 확인하십시오.

Claude의 연결 테스트가 실패함

연결이 실패한 단계에 따라 확인해야 할 사항에 대한 자세한 내용은 아래 표를 참조하십시오:

invalid_grant 오류만으로는 근본 원인을 파악할 수 없습니다. 테스트를 다시 실행하기 전에 계정, 발급자 URL, 이메일 일치 여부 및 액세스 설정을 확인하십시오.

팀 구성원이 HubSpot을 찾을 수 없거나 여전히 ‘연결(Connect)’ 프롬프트가 표시되는 경우

먼저, 해당 팀원이 의도한 Claude 조직에 속해 있는지 확인하십시오. Claude 설정의 커넥터 세부 정보페이지에서 커넥터를 찾을 수 없는 경우 ‘접근 권한이 있는 역할’을, 관리형 인증을 통해 연결하지 않는 경우 ‘적용된 역할’을 검토하십시오.

HubSpot에서 해당 구성원이 활성 사용자 계정을 보유하고 있는지, 인증된 이메일이 Claude 이메일과 일치하는지, 설치 권한을 통해 연결할 수 있는지 확인하십시오.

팀 구성원이 연결되지만 예상한 데이터에 액세스할 수 없는 경우

Claude 계정에서 커넥터의 범위, HubSpot에서 앱의 데이터 권한, 그리고 팀 구성원의 HubSpot 권한을 검토하십시오. 자동 연결은 해당 구성원이 HubSpot에서 사용할 수 없는 레코드나 작업에 대한 액세스 권한을 부여하지 않습니다.

문제가 지속되면 실패한 작업과 발생 시간을 기재하여 지원팀에 문의하십시오. 지원 요청 시 액세스 토큰이나 서명된 신원 어설션을 포함하지 마십시오.