HubSpot MCP

허브스팟 MCP

HubSpot API에 대한 MCP(모델 컨텍스트 프로토콜) 구현으로 CRM 데이터에 액세스하고 관리하기 위한 표준화된 인터페이스를 제공합니다.

특징

• HubSpot CRM API에 대한 전체 내용
• 모든 표준 CRM 객체(회사, 연락처, 거래 등) 지원
• CRM Associations v4를 통한 고급 협회 관리
• 속성 검증을 통한 회사별 엔드포인트
• 효율적인 데이터 관리를 위한 일괄 작업
• 고급 검색 및 필터링 기능
• Zod 를 사용한 유형 안전 매개변수 검증

필수 조건

API 키가 없는 경우 여기 단계에 따라 액세스 토큰을 받으세요. OAuth 지원은 향후 개선될 예정입니다.

클라이언트 구성

MCP 클라이언트를 서버와 함께 구성하는 데에는 여러 가지 옵션이 있습니다. 호스팅/원격 서버 설정의 경우 Smithery API 키 와 함께 Smithery CLI를 사용하세요. 로컬 설치의 경우 npx 사용하거나 소스에서 빌드하세요. 각 옵션에 대한 설명은 아래에서 확인할 수 있습니다.

Smithery 원격 서버(추천)

MCP 클라이언트 config.json 에 원격 서버를 추가하려면 Smithery CLI 에서 다음 명령을 실행하세요.

지엑스피1

메시지가 표시되면 HUBSPOT_ACCESS_TOKEN 입력하세요.

스미서리 SDK

자체 에이전트 애플리케이션을 개발하는 경우 여기의 보일러플레이트 코드를 사용할 수 있습니다.

NPX 로컬 설치

npx 를 사용하여 로컬로 서버를 설치하려면 MCP 클라이언트 config.json 에 다음을 추가하세요.

소스에서 빌드

1. 리포지토리 다운로드:

2. 패키지 설치(복제된 저장소 내부):

3. MCP 클라이언트 config.json 에 다음을 추가하세요.

구성 변수

지원되는 도구

핵심 CRM 객체

기본 객체 작업

• crm_list_objects : 선택적 필터링 및 페이지 매김을 사용하여 CRM 객체를 나열합니다.
• crm_get_object : ID로 단일 CRM 객체를 가져옵니다.
• crm_create_object : 새로운 CRM 객체를 생성합니다.
• crm_update_object : 기존 CRM 객체 업데이트
• crm_delete_object : CRM 객체 삭제

검색 및 일괄 작업

• crm_search_objects : 고급 필터를 사용하여 CRM 객체 검색
• crm_batch_create_objects : 단일 요청에서 여러 객체를 생성합니다.
• crm_batch_update_objects : 단일 요청에서 여러 객체를 업데이트합니다.
• crm_batch_delete_objects : 단일 요청에서 여러 객체를 삭제합니다.

CRM 레코드 관리

회사

• 기본 작업:
  • crm_create_company : 검증된 속성을 사용하여 새 회사를 만듭니다.
  • crm_update_company : 기존 회사 업데이트
  • crm_get_company : ID로 단일 회사 가져오기
  • crm_search_companies : 특정 필터로 회사 검색
• 배치 작업:
  • crm_batch_create_companies : 단일 요청으로 여러 회사 생성
  • crm_batch_update_companies : 단일 요청으로 여러 회사 업데이트
• 부동산 관리:
  • crm_get_company_properties : 사용 가능한 모든 회사 속성을 가져옵니다.
  • crm_create_company_property : 새로운 회사 속성을 만듭니다.

콘택트 렌즈

• 기본 작업:
  • crm_create_contact : 검증된 속성을 사용하여 새 연락처를 만듭니다.
  • crm_update_contact : 기존 연락처 정보 업데이트
  • crm_get_contact : ID로 단일 연락처 가져오기
  • crm_search_contacts : 특정 필터로 연락처 검색
• 배치 작업:
  • crm_batch_create_contacts : 단일 요청으로 여러 연락처를 생성합니다.
  • crm_batch_update_contacts : 단일 요청으로 여러 연락처 업데이트
• 부동산 관리:
  • crm_get_contact_properties : 사용 가능한 모든 연락처 속성을 가져옵니다.
  • crm_create_contact_property : 새 연락처 속성을 만듭니다.

리드

• 기본 작업:
  • crm_create_lead : 검증된 속성을 사용하여 새 리드를 만듭니다.
  • crm_update_lead : 기존 리드의 정보를 업데이트합니다.
  • crm_get_lead : ID로 단일 리드 가져오기
  • crm_search_leads : 특정 필터로 리드 검색
• 배치 작업:
  • crm_batch_create_leads : 단일 요청으로 여러 리드 생성
  • crm_batch_update_leads : 단일 요청으로 여러 리드 업데이트
• 부동산 관리:
  • crm_get_lead_properties : 사용 가능한 모든 리드 속성을 가져옵니다.
  • crm_create_lead_property : 새로운 리드 속성을 만듭니다.

참여 관리

약혼 세부 정보

• 기본 작업:
  • engagement_details_get : 특정 참여에 대한 세부 정보를 가져옵니다.
  • engagement_details_create : 새로운 참여를 만듭니다
  • engagement_details_update : 기존 참여 업데이트
  • engagement_details_delete : 약혼 삭제
  • engagement_details_list : 필터링을 통해 모든 참여를 나열합니다.
  • engagement_details_get_associated : 연관된 참여를 가져옵니다.

전화

• 기본 작업:
  • calls_create : 새로운 통화 기록을 만듭니다
  • calls_get : 통화 세부 정보 가져오기
  • calls_update : 통화 기록 업데이트
  • calls_archive : 통화를 보관합니다
  • calls_list : 모든 통화를 나열합니다
  • calls_search : 통화 검색
• 배치 작업:
  • calls_batch_create : 여러 통화 생성
  • calls_batch_read : 여러 호출을 읽습니다.
  • calls_batch_update : 여러 호출 업데이트
  • calls_batch_archive : 여러 통화를 보관합니다

이메일

• 기본 작업:
  • emails_create : 새로운 이메일 레코드를 만듭니다.
  • emails_get : 이메일 세부 정보 가져오기
  • emails_update : 이메일 업데이트
  • emails_archive : 이메일 보관
  • emails_list : 모든 이메일 나열
  • emails_search : 이메일 검색
• 배치 작업:
  • emails_batch_create : 여러 개의 이메일 생성
  • emails_batch_read : 여러 개의 이메일을 읽습니다.
  • emails_batch_update : 여러 이메일 업데이트
  • emails_batch_archive : 여러 개의 이메일을 보관합니다.

회의

• 기본 작업:
  • meetings_create : 새로운 회의를 만듭니다
  • meetings_get : 회의 세부 정보 가져오기
  • meetings_update : 회의 업데이트
  • meetings_delete : 회의 삭제
  • meetings_list : 모든 회의를 나열합니다
  • meetings_search : 회의 검색
• 배치 작업:
  • meetings_batch_create : 여러 회의 만들기
  • meetings_batch_update : 여러 회의 업데이트
  • meetings_batch_archive : 여러 회의를 보관합니다

노트

• 기본 작업:
  • notes_create : 새로운 노트를 만듭니다
  • notes_get : 노트 세부 정보 가져오기
  • notes_update : 메모 업데이트
  • notes_archive : 메모 보관
  • notes_list : 모든 노트를 나열합니다
  • notes_search : 노트 검색
• 배치 작업:
  • notes_batch_create : 여러 개의 노트를 만듭니다
  • notes_batch_read : 여러 개의 노트 읽기
  • notes_batch_update : 여러 개의 노트 업데이트
  • notes_batch_archive : 여러 개의 노트를 보관합니다

작업

• 기본 작업:
  • tasks_create : 새로운 작업을 생성합니다
  • tasks_get : 작업 세부 정보 가져오기
  • tasks_update : 작업 업데이트
  • tasks_archive : 작업 보관
  • tasks_list : 모든 작업 나열
  • tasks_search : 작업 검색
• 배치 작업:
  • tasks_batch_create : 여러 작업 생성
  • tasks_batch_read : 여러 작업 읽기
  • tasks_batch_update : 여러 작업 업데이트
  • tasks_batch_archive : 여러 작업 보관

협회 및 관계

CRM 협회 v4

• 기본 작업:
  • crm_list_association_types : 사용 가능한 연관 유형을 나열합니다.
  • crm_get_associations : 객체 간의 모든 연결을 가져옵니다.
  • crm_create_association : 협회를 생성합니다
  • crm_delete_association : 연관관계 삭제
• 배치 작업:
  • crm_batch_create_associations : 여러 연관관계 생성
  • crm_batch_delete_associations : 여러 연관관계 삭제

커뮤니케이션 선호도

구독 관리

• 기본 작업:
  • communications_get_preferences : 연락처 기본 설정 가져오기
  • communications_update_preferences : 연락처 기본 설정 업데이트
  • communications_unsubscribe_contact : 글로벌 구독 취소
  • communications_subscribe_contact : 글로벌 구독
  • communications_get_subscription_definitions : 구독 정의 가져오기
• 대량 작업:
  • communications_get_subscription_status : 여러 연락처의 상태 가져오기
  • communications_update_subscription_status : 여러 연락처의 상태 업데이트

제품

기본 작업:

• products_create : 주어진 속성을 사용하여 제품을 생성하고 ID를 포함한 객체의 사본을 반환합니다.
• products_read : ID로 식별된 객체를 읽습니다.
• products_update : ID로 식별된 객체의 부분 업데이트를 수행합니다. 읽기 전용이거나 존재하지 않는 속성은 오류를 발생시킵니다. 속성 값은 빈 문자열을 전달하여 지울 수 있습니다.
• products_archive : ID로 식별된 객체를 휴지통으로 이동합니다.
• products_list : 제품 페이지를 읽습니다. properties 쿼리 매개변수를 통해 반환되는 내용을 제어합니다. after 는 마지막으로 성공적으로 읽은 리소스의 페이징 커서 토큰이며, 더 많은 결과가 포함된 페이지 응답의 paging.next.after JSON 속성으로 반환됩니다.
• products_search : 제품 검색

배치 작업:

• products_batch_create : 제품 배치를 생성합니다.
• products_batch_read : 내부 ID 또는 고유 속성 값으로 제품 배치를 읽습니다. 사용자 지정 고유 값 속성으로 레코드를 검색하려면 idProperty 매개변수로 레코드를 검색합니다.
• products_batch_update : 내부 ID 또는 idProperty 쿼리 매개변수로 지정된 고유 값으로 제품 배치를 업데이트합니다.
• products_batch_archive : ID별로 제품 배치를 보관합니다.

기여하다

여러분의 참여를 환영하며 적극 권장합니다! 이슈, 참여 방법, 연락처 정보는 CONTRIBUTING.md에서 확인하세요.