허브스팟 MCP 서버

개요

HubSpot CRM과의 통합을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 통해 AI 모델은 표준화된 인터페이스를 통해 HubSpot 데이터 및 운영과 상호 작용할 수 있습니다.

모델 컨텍스트 프로토콜과 그 작동 방식에 대한 자세한 내용은 Anthropic의 MCP 설명서를 참조하세요.

구성 요소

자원

서버는 다음과 같은 리소스를 제공합니다.

• hubspot://hubspot_contacts : HubSpot 연락처에 대한 액세스를 제공하는 동적 리소스
• hubspot://hubspot_companies : HubSpot 회사에 대한 액세스를 제공하는 동적 리소스
• hubspot://hubspot_recent_engagements : 지난 3일간의 HubSpot 참여에 대한 액세스를 제공하는 동적 리소스

모든 리소스는 HubSpot에서 해당 객체가 수정되면 자동으로 업데이트됩니다.

예시 프롬프트

• LinkedIn 프로필 웹페이지에서 복사하여 Hubspot 연락처를 만듭니다.지엑스피1
• 회사의 최신 활동을 알아보세요:
  What's happening latestly with my pipeline?

도구

서버는 HubSpot 객체를 관리하기 위한 다양한 도구를 제공합니다.

연락처 관리 도구

• hubspot_get_contacts
  • HubSpot에서 연락처 검색
  • 입력이 필요하지 않습니다
  • 반환: 연락처 객체 배열
• hubspot_create_contact
  • HubSpot에서 새 연락처를 만듭니다(생성 전 중복 여부를 확인합니다)
  • 입력:
    • firstname (문자열): 연락처의 이름
    • lastname (문자열): 연락처의 성
    • email (문자열, 선택 사항): 연락처의 이메일 주소
    • properties (사전, 선택 사항): 추가 연락처 속성
      • 예: {"phone": "123456789", "company": "HubSpot"}
  • 행동:
    • 동일한 이름과 성을 가진 기존 연락처 확인
    • company 속성에 제공된 경우 동일한 회사와의 일치도 확인합니다.
    • 일치하는 항목이 발견되면 기존 연락처 정보를 반환합니다.
    • 일치하는 항목이 없는 경우에만 새 연락처를 만듭니다.

회사 관리 도구

• hubspot_get_companies
  • HubSpot에서 회사 검색
  • 입력이 필요하지 않습니다
  • 반환: 회사 객체 배열
• hubspot_create_company
  • HubSpot에서 새 회사를 만듭니다(만들기 전에 중복 여부를 확인합니다)
  • 입력:
    • name (문자열): 회사 이름
    • properties (dict, 선택 사항): 추가 회사 속성
      • 예: {"domain": "example.com", "industry": "Technology"}
  • 행동:
    • 동일한 이름을 가진 기존 회사를 확인합니다.
    • 일치하는 항목이 발견되면 기존 회사 세부 정보를 반환합니다.
    • 일치하는 항목이 없는 경우에만 새 회사를 만듭니다.
• hubspot_get_company_activity
  • 특정 회사의 활동 내역 가져오기
  • 입력:
    • company_id (문자열): HubSpot 회사 ID
  • 반환: 활동 객체 배열

참여 도구

• hubspot_get_recent_engagements
  • 지난 3일간 모든 회사와 연락처의 HubSpot 참여를 받아보세요.
  • 입력이 필요하지 않습니다
  • 반환: 전체 메타데이터가 포함된 참여 객체 배열

다중 사용자 지원

이 MCP 서버는 각자 고유한 액세스 토큰을 가진 여러 HubSpot 사용자와 함께 작동하도록 설계되었습니다. 이 서버는 액세스 토큰에 전역 환경 변수를 사용하지 않습니다.

대신, MCP 서버에 대한 각 요청에는 다음 방법 중 하나로 사용자의 특정 액세스 토큰이 포함되어야 합니다.

1. 요청 헤더에 X-HubSpot-Access-Token: your-token-here
2. 요청 본문에서 accessToken 으로 : {"accessToken": "your-token-here"}
3. 요청 본문에 hubspotAccessToken 입력합니다: {"hubspotAccessToken": "your-token-here"}

이 디자인을 사용하면 사용자 토큰을 자체 백엔드(예: Supabase)에 저장하고 각 요청과 함께 전달할 수 있습니다.

다중 사용자 통합 예시

설정

필수 조건

각 사용자마다 HubSpot 액세스 토큰이 필요합니다. 다음 방법으로 획득할 수 있습니다.

1. HubSpot 계정에서 개인 앱 만들기: HubSpot 개인 앱 가이드를 따르세요.
   • HubSpot 계정 설정으로 이동하세요
   • 통합 > 개인 앱으로 이동
   • "비공개 앱 만들기"를 클릭하세요
   • 기본 정보를 입력하세요:
     • 앱 이름 지정
     • 설명 추가
     • 로고 업로드(선택 사항)
   • 필요한 범위를 정의하세요.
     • oauth(필수)
   • 선택적 범위:
     • crm.dealsplits.read_write
     • crm.객체.회사.읽기
     • crm.objects.companies.write
     • crm.객체.연락처.읽기
     • crm.객체.연락처.쓰기
     • crm.객체.거래.읽기
   • 앱을 검토하고 생성하세요
   • 생성된 액세스 토큰을 복사하세요

참고: 액세스 토큰을 안전하게 보관하고 버전 제어에 커밋하지 마세요.

도커 설치

이미지를 로컬에서 빌드하거나 Docker Hub에서 가져올 수 있습니다. 이미지는 Linux 플랫폼용으로 빌드되었습니다.

지원 플랫폼

• 리눅스/amd64
• 리눅스/arm64
• 리눅스/arm/v7

옵션 1: Docker Hub에서 가져오기

옵션 2: 로컬로 빌드

컨테이너를 실행합니다.

크로스 플랫폼 퍼블리싱

여러 플랫폼에 Docker 이미지를 게시하려면 docker buildx 명령을 사용할 수 있습니다. 다음 단계를 따르세요.

1. 새로운 빌더 인스턴스를 만듭니다 (아직 만들지 않았다면):
   docker buildx create --use
2. 여러 플랫폼에 대한 이미지를 빌드하고 푸시합니다 .
   docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push .
3. 지정된 플랫폼에서 이미지를 사용할 수 있는지 확인하세요 .
   docker buildx imagetools inspect buryhuang/mcp-hubspot:latest

Claude Desktop과 함께 사용

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 mcp-hubspot을 자동으로 설치하려면:

Docker 사용법

개발

개발 환경을 설정하려면:

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.