Skip to Content

HubSpot

HubSpot CRM과 연결하여 연락처, 회사, 거래, 작업, 제품, 노트 등 CRM 데이터를 조회하고 관리할 수 있습니다.

주요 기능

  • CRM 객체(연락처, 회사, 거래 등) 배치 조회
  • 여러 레코드를 한 번에 생성, 수정, 삭제
  • 작업(Tasks) 관리
  • 제품(Products) 관리
  • 노트(Notes) 관리
  • 티켓(Tickets) 관리

기본 정보

인증 방식

OAuth 2.0 인증을 사용합니다.

인증 과정

  1. 사용자 인증 요청
  2. HubSpot에서 인증 및 권한 승인
  3. Access Token 발급
  4. API 호출 시 Authorization 헤더에 Bearer Token 포함

지원하는 MCP 도구

HubSpot MCP는 총 50개의 도구를 제공하며, 주요 CRM 객체에 대한 배치 작업을 지원합니다.

작업(Tasks) 관리 도구

tasks_batch_create

여러 작업을 한 번에 생성합니다.

tasks_batch_read

여러 작업을 한 번에 조회합니다.

tasks_batch_update

여러 작업을 한 번에 수정합니다.

tasks_batch_archive

여러 작업을 한 번에 아카이브(삭제)합니다.

제품(Products) 관리 도구

products_batch_create

여러 제품을 한 번에 생성합니다.

products_batch_read

여러 제품을 한 번에 조회합니다.

products_batch_update

여러 제품을 한 번에 수정합니다.

products_batch_archive

여러 제품을 한 번에 아카이브(삭제)합니다.

노트(Notes) 관리 도구

notes_batch_create

여러 노트를 한 번에 생성합니다.

notes_batch_read

여러 노트를 한 번에 조회합니다.

notes_batch_update

여러 노트를 한 번에 수정합니다.

notes_batch_archive

여러 노트를 한 번에 아카이브(삭제)합니다.

연락처(Contacts) 관리 도구

contacts_batch_create

여러 연락처를 한 번에 생성합니다.

contacts_batch_read

여러 연락처를 한 번에 조회합니다.

contacts_batch_update

여러 연락처를 한 번에 수정합니다.

contacts_batch_archive

여러 연락처를 한 번에 아카이브(삭제)합니다.

회사(Companies) 관리 도구

companies_batch_create

여러 회사를 한 번에 생성합니다.

companies_batch_read

여러 회사를 한 번에 조회합니다.

companies_batch_update

여러 회사를 한 번에 수정합니다.

companies_batch_archive

여러 회사를 한 번에 아카이브(삭제)합니다.

거래(Deals) 관리 도구

deals_batch_create

여러 거래를 한 번에 생성합니다.

deals_batch_read

여러 거래를 한 번에 조회합니다.

deals_batch_update

여러 거래를 한 번에 수정합니다.

deals_batch_archive

여러 거래를 한 번에 아카이브(삭제)합니다.

티켓(Tickets) 관리 도구

tickets_batch_create

여러 티켓을 한 번에 생성합니다.

tickets_batch_read

여러 티켓을 한 번에 조회합니다.

tickets_batch_update

여러 티켓을 한 번에 수정합니다.

tickets_batch_archive

여러 티켓을 한 번에 아카이브(삭제)합니다.

사용 예시

예를 들어,

  • Prompt로 “이번 주에 완료해야 할 작업 목록을 보여줘” 라고 입력하면,
  • LLM은 MCP를 통해 tasks_batch_read 도구를 호출하여 작업 목록을 조회합니다.
  • 그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.

OAuth 앱 설정 방법

  1. HubSpot 개발자 계정 에 로그인합니다.
  2. Apps 메뉴로 이동합니다.
  3. Create app 버튼을 클릭합니다.
  4. 앱 이름과 설명을 입력합니다.
  5. Auth 탭에서 다음을 설정합니다:
    • Redirect URLs: AIP에서 제공하는 Redirect URL을 입력합니다.
    • Scopes: 필요한 권한을 선택합니다 (CRM 객체별 read/write 권한).
  6. Client IDClient Secret을 복사합니다.
  7. AIP의 MCP 연동 페이지에서 HubSpot을 선택하고 Connect & Install 버튼을 클릭합니다.
  8. HubSpot 인증 페이지에서 권한을 승인합니다.

주의사항

  • HubSpot의 API 사용 제한(Rate Limit)이 적용됩니다.
  • 배치 작업은 한 번에 최대 100개의 레코드를 처리할 수 있습니다.
  • 삭제 작업(archive)은 되돌릴 수 없으니 신중하게 사용하세요.
  • OAuth 인증 시 필요한 권한(Scopes)을 올바르게 설정해야 합니다.
  • CRM 객체에 대한 접근 권한은 HubSpot 계정의 권한에 따라 제한됩니다.
Last updated on