허브스팟 MCP 서버

HubSpot API를 위한 MCP 서버를 사용하면 Claude가 HubSpot CRM과 상호 작용하여 판매 분석 및 통찰력을 얻을 수 있습니다.

부인 성명
이 오픈소스 프로젝트는 HubSpot과 제휴 관계가 없으며, HubSpot의 보증을 받지 않습니다. HubSpot API와 상호 작용하는 독립적인 구현체입니다.

도구

핵심 CRM 도구

hubspot_search_contacts
- 쿼리 문자열을 사용하여 HubSpot에서 연락처 검색
- 필수 입력 사항:
  - query (문자열): 검색 쿼리 문자열(이메일, 이름 등)
- 선택 입력 사항:
  - count (숫자, 기본값: 10): 반환할 최대 연락처 수
  - propertyList (배열): 결과에 포함할 속성 목록
- 반환: 속성이 있는 일치하는 연락처 목록
hubspot_get_contact
- ID로 특정 연락처 가져오기
- 필수 입력 사항:
  - contactId (문자열): 검색할 연락처의 ID
- 선택 입력 사항:
  - properties (배열): 결과에 포함할 속성 목록
- 반환: 지정된 속성에 대한 연락처 정보
hubspot_create_contact
- HubSpot에서 새 연락처 만들기
- 필수 입력 사항:
  - properties (객체): 최소한 email 필드가 있는 연락처 속성
- 반품: 연락처 정보가 생성되었습니다.
hubspot_update_contact
- HubSpot에서 기존 연락처 업데이트
- 필수 입력 사항:
  - contactId (문자열): 업데이트할 연락처의 ID
  - properties (객체): 업데이트할 속성을 문의합니다.
- 반품: 연락처 확인 업데이트됨
hubspot_list_deals
- 페이지네이션을 사용하여 HubSpot에 거래 목록 표시
- 선택 입력 사항:
  - limit (숫자, 기본값: 10, 최대: 100): 반환할 최대 거래 수
  - after (문자열): 다음 페이지의 페이지 번호 커서
  - properties (배열): 결과에 포함할 속성 목록
- 반품: 거래 목록 및 세부 정보
hubspot_get_deal
- ID로 특정 거래를 받으세요
- 필수 입력 사항:
  - dealId (문자열): 검색할 거래의 ID
- 선택 입력 사항:
  - properties (배열): 결과에 포함할 속성 목록
- 반환: 지정된 속성에 대한 거래 세부 정보
hubspot_create_deal
- HubSpot에서 새 거래를 만듭니다
- 필수 입력 사항:
  - properties (객체): 최소한 dealname 필드가 있는 거래 속성
- 반품: 거래 세부정보 생성됨
hubspot_update_deal
- HubSpot에서 기존 거래 업데이트
- 필수 입력 사항:
  - dealId (문자열): 업데이트할 거래의 ID
  - properties (객체): 업데이트할 거래 속성
- 반품: 업데이트된 거래 확인
hubspot_list_companies
- 페이지 매김을 사용하여 HubSpot에 회사 목록 표시
- 선택 입력 사항:
  - limit (숫자, 기본값: 10, 최대: 100): 반환할 최대 회사 수
  - after (문자열): 다음 페이지의 페이지 번호 커서
  - properties (배열): 결과에 포함할 속성 목록
- 반환: 회사 목록 및 세부 정보
hubspot_get_company

ID로 특정 회사 가져오기
필수 입력 사항:
- companyId (문자열): 검색할 회사의 ID
선택 입력 사항:
- properties (배열): 결과에 포함할 속성 목록
반환: 지정된 속성을 포함하는 회사 세부 정보

영업 분석 도구

hubspot_get_sales_analytics

특정 기간 동안의 집계된 판매 분석 데이터를 얻으세요
필수 입력 사항:
- period (문자열): 분석 데이터를 그룹화할 기간(일별, 주별, 월별, 분기별, 연간)
- startDate (문자열): ISO 형식(YYYY-MM-DD)의 분석 시작 날짜
선택 입력 사항:
- endDate (문자열): ISO 형식의 분석 종료 날짜
- pipeline (문자열): 필터링할 파이프라인 ID
- dealStage (문자열): 필터링할 거래 단계 ID
- dealOwner (문자열): 필터링할 거래 소유자 ID
반품: 기간별로 그룹화된 집계된 판매 지표

hubspot_get_deal_history

거래 변경 사항의 전체 내역을 확인하세요
필수 입력 사항:
- dealId (문자열): 내역을 가져올 거래의 ID
반환: 타임스탬프 및 수정된 속성을 포함한 거래 변경 내역

hubspot_get_deal_notes

특정 거래와 관련된 메모를 받으세요
필수 입력 사항:
- dealId (문자열): 메모를 가져올 거래의 ID
선택 입력 사항:
- limit (숫자, 기본값: 20): 반환할 최대 노트 수
- after (문자열): 다음 페이지 결과에 대한 페이지 번호 커서
반환: 내용 및 생성 타임스탬프가 포함된 메모 목록

hubspot_get_engagements_by_deal

거래와 관련된 모든 참여 활동을 가져옵니다.
필수 입력 사항:
- dealId (문자열): 참여를 얻기 위한 거래의 ID
선택 입력 사항:
- types (배열): 포함할 참여 유형(통화, 이메일, 회의, 작업, 메모)
- limit (숫자, 기본값: 20): 반환할 최대 참여 수
- after (문자열): 다음 페이지 결과에 대한 페이지 번호 커서
반환: 세부 정보 및 유형 정보가 포함된 참여 목록

hubspot_get_sales_performance

특정 기간 동안 영업 담당자의 성과 지표를 얻으세요
필수 입력 사항:
- period (문자열): 성과 데이터를 그룹화할 기간(일별, 주별, 월별, 분기별, 연간)
- startDate (문자열): ISO 형식(YYYY-MM-DD)의 분석 시작 날짜
선택 입력 사항:
- endDate (문자열): ISO 형식의 분석 종료 날짜
- ownerIds (배열): 분석에 포함할 소유자 ID 목록
- pipeline (문자열): 필터링할 파이프라인 ID
반품: 거래 수, 수익, 승률 등 각 영업 담당자의 성과 측정 항목

hubspot_get_pipeline_analytics

단계별 전환율을 포함한 특정 판매 파이프라인에 대한 분석을 받으세요
필수 입력 사항:
- pipelineId (문자열): 분석할 파이프라인의 ID
- period (문자열): 분석 데이터를 그룹화할 기간(일별, 주별, 월별, 분기별, 연간)
- startDate (문자열): ISO 형식(YYYY-MM-DD)의 분석 시작 날짜
선택 입력 사항:
- endDate (문자열): ISO 형식의 분석 종료 날짜
반환: 거래 수, 가치, 전환율 및 단계 시간을 포함한 파이프라인 단계 측정 항목

hubspot_get_forecast_analytics

현재 파이프라인과 과거 실적을 기반으로 예상 판매 데이터를 얻으세요.
필수 입력 사항:
- period (문자열): 예측 데이터를 그룹화할 기간(월별, 분기별, 연간)
선택 입력 사항:
- numberOfPeriods (숫자, 기본값: 3): 예측할 미래 기간 수
- pipeline (문자열): 필터링할 파이프라인 ID
반환: 과거 데이터와 현재 파이프라인을 기반으로 미래 기간에 대한 예상 판매 지표

설정

HubSpot 비공개 앱 만들기:
- HubSpot 계정으로 이동하세요
- 설정 → 계정 설정 → 통합 → 비공개 앱으로 이동합니다.
- "비공개 앱 만들기"를 클릭하세요
- 앱 이름을 지정하고 적절한 범위(연락처, 거래, 회사)를 설정합니다.
- 앱을 생성하고 개인 앱 토큰을 복사하세요.
필수 범위:
- crm.objects.contacts.read
- crm.objects.contacts.write
- crm.objects.deals.read
- crm.objects.deals.write
- crm.objects.companies.read
- crm.objects.companies.write
- crm.objects.owners.read
- crm.objects.quotes.read
- crm.objects.line_items.read
- crm.objects.custom.read
- crm.schemas.deals.read
- crm.schemas.contacts.read
- crm.schemas.companies.read
- crm.schemas.custom.read

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요.

엔피엑스

지엑스피1

도커

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "HUBSPOT_API_KEY", "mcp/hubspot"],
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

문제 해결

오류가 발생하면 다음 사항을 확인하세요.

모든 필수 범위가 HubSpot 개인 앱에 추가되었습니다.
API 키가 구성에 올바르게 복사되었습니다.
귀하의 HubSpot 플랜에는 사용하려는 API에 대한 액세스가 포함되어 있습니다.

짓다

Docker 빌드:

docker build -t mcp/hubspot -f Dockerfile .

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

HubSpot MCP Server

Integrations