콘텐츠로 건너뛰기
HubSpot 기술 자료
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

NetSuite를 Breeze Assistant에 연결하기

마지막 업데이트 날짜: 2026년 10월 21일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

NetSuite를 Breeze Assistant에 연결하면 HubSpot을 벗어나지 않고도 NetSuite 레코드에 액세스하고 작업할 수 있습니다. NetSuite를 연결한 후에는 Breeze Assistant에게 NetSuite에서 정보를 가져오거나 NetSuite 레코드에 대해 지원되는 작업을 수행하도록 요청할 수 있습니다.

예를 들어, Breeze Assistant에 계정별 NetSuite 내역을 요약해 달라고 요청하거나, NetSuite 데이터를 사용하여 요약 및 보고서를 생성하거나, 결제 내역 및 미결제 청구서와 같은 재무 정보를 NetSuite에서 가져오도록 요청할 수 있습니다.

시작하기 전에

NetSuite를 Breeze Assistant에 연결하기 전에 다음 요구 사항 및 고려 사항을 검토하십시오.

요구 사항 파악

제한 사항 및 고려 사항 파악

  • NetSuite는 타사 서비스입니다. 커넥터를 사용할 때는 Oracle의 데이터 및 개인정보 보호 정책이 적용됩니다. 자세한 내용은 Oracle의 ‘관련 위험, 통제 수단 및 완화 전략’을 확인하십시오.
  • NetSuite AI 커넥터 서비스는 HIPAA 준수 여부에 대한 평가를 받지 않았으므로, 전자 보호 건강 정보(ePHI)를 저장, 처리 또는 전송하는 데 사용해서는 안 됩니다. HubSpot 계정에서 ‘민감 데이터’ 기능이 활성화된 경우, 이 커넥터를 사용하지 않는 것이 좋습니다. NetSuite 및 HIPAA에 대해 자세히 알아보세요.
  • 변경 사항을 확정하기 전에 Breeze Assistant가 제안한 변경 사항을 검토하십시오.
  • 커넥터를 통해 NetSuite 데이터를 삭제할 수 없습니다.
  • 기본적으로 인증 토큰의 유효 기간은 48시간입니다. NetSuite에서 이 유효 기간을 최대 30일까지 연장할 수 있습니다. 토큰이 만료되면 연결을 다시 인증해야 합니다.

NetSuite의 관리자 단계

NetSuite를 Breeze Assistant에 연결하기 전에, NetSuite 관리자는 NetSuite에서 다음 단계를 완료해야 합니다.

1. 필수 NetSuite 기능 활성화

Breeze Assistant에서 NetSuite 커넥터를 사용하기 전에, NetSuite 관리자는 필수 SuiteCloud 기능을 활성화해야 합니다.

  1. NetSuite에서 [설정 ] > [회사 ] > [기능 활성화]로 이동하십시오.
  2. SuiteCloud 하위 탭을 클릭하십시오.
  3. SuiteScript 섹션에서:
    • Client SuiteScript 확인란을 선택하십시오. 메시지가 표시되면 '동의함'을 클릭하여 SuiteCloud 서비스 약관에 동의하십시오.
    • '서버 SuiteScript' 확인란을 선택하십시오. 메시지가 표시되면 '동의함'을 클릭하여 SuiteCloud 서비스 약관에 동의하십시오 .

  1. '인증 관리' 섹션에서 'OAuth 2.0' 확인란을 선택합니다. 메시지가 표시되면 '동의함'을 클릭하여 SuiteCloud 서비스 약관에 동의합니다.
  2. 'SuiteTalk(웹 서비스) ' 섹션에서 'REST 웹 서비스 ' 확인란을 선택합니다.
  1. '저장'을 클릭합니다.

2. 커넥터용 NetSuite 역할 구성

커넥터에 액세스해야 하는 각 사용자는 필요한 권한이 부여된 NetSuite 역할을 가져야 합니다. 광범위한 액세스 권한을 가진 기존 역할에 이러한 권한을 추가하기보다는 커넥터 전용 역할을 생성하는 것을 고려하십시오.

역할 권한 구성

  1. NetSuite에서 [ 설정] > [ 사용자/역할 ] > [ 역할 관리]로 이동합니다.
  2. 기존 역할을 구성하려면 역할 옆에 있는 ‘편집’을 클릭하십시오. 역할을 생성하려면 ‘새로 만들기’를 클릭하십시오.
  3. '권한 ' 하위 탭을 클릭한 다음 '설정'을 클릭합니다.
  4. 다음 권한을 추가하십시오.
    • MCP 서버 연결: ‘전체 액세스’를 선택합니다. 이 권한을 통해 사용자는 AI 커넥터 서비스에 연결할 수 있습니다.
    • OAuth 2.0 액세스 토큰을 사용하여 로그인: ‘전체 액세스’를 선택합니다. 이 권한을 통해 OAuth 2.0 인증이 가능합니다.
    • REST 웹 서비스: 사용자가 MCP Standard Tools SuiteApp을 통해 레코드를 생성, 조회 또는 업데이트할 경우 ‘전체 액세스’를 선택합니다.
  1. '저장'을 클릭하십시오.

참고: NetSuite 역할을 생성한 후 해당 역할이 사용 가능해지기까지 다소 시간이 걸릴 수 있습니다. 역할이 사용 가능해질 때까지 기다린 후 설정을 계속 진행하십시오.

역할에 레코드 권한 추가

Breeze Assistant가 조회할 NetSuite 개체(예: 판매 주문, 청구서, 고객 결제 내역 등)에 대한 레코드 권한을 추가하십시오.

  1. NetSuite에서 관리자 역할로 전환합니다.
  2. '설정 > 사용자/역할 > 역할 관리'로 이동합니다.
  3. NetSuite 커넥터용으로 생성한 역할을 엽니다.
  4. '권한 > 트랜잭션'으로 이동합니다.
  5. Breeze Assistant가 가져오기를 원하는 NetSuite 개체에 대한 권한을 추가한 다음, 각 권한의 액세스 수준을 ‘전체’로 설정합니다. 예를 들어, 판매 주문, 청구서, 고객 결제 또는 기타 NetSuite 개체에 대한 권한을 추가할 수 있습니다. 
  6. '저장'을 클릭합니다.

사용자에게 역할 할당

  1. NetSuite에서 목록 > 직원 > 직원으로 이동합니다.
  2. 역할을 할당할 사용자 옆의 '편집'을 클릭합니다.
  3. '액세스' 탭으로 이동합니다.
  4. '역할'에서 이전 단계에서 구성한 역할을 검색하여 선택합니다.
  5. '추가'를 클릭합니다.
  6. 그런 다음 ‘저장’을 클릭하십시오.

참고: NetSuite AI 커넥터 서비스는 관리자 역할이나 NetSuite 기능에 대한 전체 액세스 권한을 가진 역할에서는 실행할 수 없습니다. 이 보안 조치는 외부 AI 클라이언트의 보안이 침해될 경우 의도하지 않은 결과를 방지하기 위한 것입니다.

3. MCP Standard Tools SuiteApp 설치

Breeze Assistant에서 NetSuite 커넥터를 사용하려면 MCP Standard Tools SuiteApp을 설치하십시오. 이 SuiteApp을 사용하면 Breeze Assistant에서 자연어를 사용하여 NetSuite 데이터를 조회할 수 있습니다.

이 SuiteApp은 사용자의 기존 NetSuite 역할 및 권한을 기반으로 사용자가 액세스할 수 있는 데이터와 작업을 결정합니다.

  1. NetSuite 관리자로 NetSuite에 로그인합니다.
  2. 'SuiteApps' 탭을 클릭하십시오.
  3. 'SuiteApps 검색' 필드에 'MCP Standard Tools'를 입력합니다.
  4. MCP Standard Tools 아이콘을 클릭합니다.
  5. SuiteApp 페이지의 오른쪽 상단에서 ‘설치’를 클릭하세요.
  6. 설치가 완료될 때까지 기다리십시오.

 

4. OAuth 2.0 통합 레코드 생성

NetSuite와 HubSpot 간의 OAuth 2.0 인증을 구성하려면 NetSuite에서 통합 레코드를 생성하십시오. 자세한 내용은 NetSuite 설명서를 참조하십시오.

  1. NetSuite에서 [ 설정 ] > [통합 ] > [통합 관리 ] > [ 새로 만들기]로 이동합니다.
  2. 통합 이름을 입력합니다.
  3. '상태' 필드를 '사용'으로 설정하십시오.
  4. 'OAuth 2.0 범위 ' 섹션에서:
    • 'Authorization Code Grant' 확인란을 선택합니다.
    • '공개 클라이언트' 확인란의 선택을 해제하십시오. NetSuite를 HubSpot에 연결하려면 클라이언트 시크릿이 필요합니다.
    • '리디렉션 URI' 필드에 HubSpot 리디렉션 URI를 입력하십시오. URI는 https://oauth-redirect.hubspot.com/callback/netsuite_mcp 형식을 사용해야 합니다.
    • 'NetSuite AI Connector Service ' 확인란을 선택합니다.
    • RESTlets, REST 웹 서비스 및 SuiteAnalytics Connect를 포함한 다른 OAuth 범위 확인란의 선택을 해제하십시오.
  1. '토큰 기반 인증' 및 '클라이언트 자격 증명 ' 섹션의 모든 확인란 ( ‘클라이언트 자격 증명(M2M) 부여’ 확인란 포함)을 선택 해제하십시오.
  2. '저장'을 클릭합니다.
  3. 생성된 클라이언트 ID 와 클라이언트 시크릿을 복사하여 안전하게 보관하십시오.

참고: 클라이언트 ID와 클라이언트 시크릿은 통합 레코드를 처음 저장한 후에만 표시됩니다. 이 값들을 저장하지 않은 경우, 통합 레코드에서 해당 값을 재설정하여 새로운 자격 증명을 생성해야 합니다.

 이 섹션의 REST 웹 서비스 OAuth 범위는 앞서 구성한 REST 웹 서비스 역할 권한과는 별개입니다. 역할 권한은 사용자의 REST API 접근 권한을 결정하는 반면, OAuth 범위는 OAuth 토큰을 NetSuite AI 커넥터 서비스로만 제한합니다.

5. NetSuite MCP 서버 URL 찾기

MCP 서버 URL은 사용자의 NetSuite 계정에 따라 다르며, 이 연결을 통해 사용할 수 있는 도구를 결정합니다.

계정 ID 찾기

  1. NetSuite에서 [설정 ] > [ 회사 ] > [ 회사 정보]로 이동합니다.
  2. 페이지 상단에서 계정 ID 를 찾으십시오.
  3. '회사 URL' 탭을 클릭하여 계정별 SuiteTalk URL을 확인하십시오.

 

적절한 MCP 서버 URL 설정

  • MCP Standard Tools SuiteApp을 사용하려면 다음을 사용하십시오.
    https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools
  • 사용 가능한 모든 SuiteApp 및 계정 사용자 지정 프로젝트를 표시하려면 다음을 사용하십시오:
    https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/all
  • 특정 SuiteApp을 표시하려면 다음을 사용하십시오:
    https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/<publisherid>.<projectid>
  • <accountid> 를 귀하의 NetSuite 계정 ID로 대체하십시오.

NetSuite를 Breeze Assistant에 연결

NetSuite 관리자가 NetSuite에서 커넥터를 구성한 후, NetSuite를 Breeze Assistant에 연결하십시오. 시작하기 전에 NetSuite MCP 서버 URL, 클라이언트 ID 및 클라이언트 시크릿을 준비해 두십시오.

  1. HubSpot 계정에서 상단 탐색 모음의 마켓플레이스 아이콘 를 클릭한 다음 HubSpot 마켓플레이스를 선택합니다.
  2. NetSuite 커넥터를 검색하여 선택하십시오.
  3. '설치'를 클릭하십시오.
  4. 대화 상자에서:
    • 'NetSuite MCP 서버 URL' 필드에 해당 NetSuite 계정의 NetSuite MCP 서버 URL을 입력하십시오.
    • '클라이언트 ID' 필드에 NetSuite 통합 레코드에서 생성된 클라이언트 ID를 입력합니다.
    • '클라이언트 시크릿' 필드에 NetSuite 통합 레코드에서 생성된 클라이언트 시크릿을 입력하십시오.
  5. 'netsuite_mcp에 연결'을 클릭합니다.
  1. NetSuite로 리디렉션됩니다. 필요한 MCP 권한을 가진 비관리자 역할로 로그인한 다음, HubSpot이 NetSuite에 액세스할 수 있도록 승인하십시오.
  2. 승인 후 HubSpot으로 리디렉션되며 연결이 설정됩니다.

Breeze Assistant에서 커넥터 사용

연결이 완료되면 Breeze Assistant에 NetSuite에서 정보를 가져오거나 작업을 수행하도록 요청하십시오.

  1. 상단 탐색 모음에서 'Breeze Assistant'를 클릭합니다. 
  2. '+'를 클릭한 다음 '커넥터'로 이동합니다.
  3. NetSuite 커넥터 스위치를 클릭하여 켭니다.
  4. 그런 다음 프롬프트를 입력하세요.
    예를 들어, 다음과 같은 작업을 수행할 수 있습니다. 
    • Breeze Assistant에게 NetSuite 내 특정 회사의 최근 5건의 판매 주문 내역(세부 항목, 금액 및 현재 상태 포함)을 보여달라고 요청하세요.
    • Breeze Assistant에게 NetSuite의 모든 자회사에서 60일 이상 연체된 미결제 청구서를 금액 순으로 정렬하여 표시해 달라고 요청하세요.
    • Breeze Assistant에게 NetSuite에서 이번 주에 생성되었으며 아직 처리 대기 상태인 모든 판매 주문을 표시해 달라고 요청합니다.
    • Breeze Assistant에게 NetSuite에서 올해 1분기와 2분기의 자회사별 총 매출을 비교해 달라고 요청하세요.
    • Breeze Assistant에게 NetSuite의 특정 자회사에서 지난 6개월 이내에 NetSuite 주문을 처음 한 모든 고객을 보여달라고 요청하세요.
    • Breeze Assistant에게 NetSuite 내 특정 회사의 전체 계정 요약(모든 주문, 청구서, 결제 및 미해결 사항 포함)을 제공해 달라고 요청하세요.
  1. 오른쪽 하단의 '보내기' 아이콘을 클릭하세요.
  2. Breeze Assistant가 NetSuite 데이터를 사용하여 응답을 생성합니다.

 
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.
목차 /ko/integrations/connect-netsuite-to-breeze-assistant 메뉴

관련 콘텐츠

New call-to-action