허브스팟 MCP 서버

개요

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

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

구성 요소

자원

어떤 리소스도 구현되지 않았습니다. 결국 우리에게 필요한 것은 도구뿐입니다.

예시 프롬프트

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

도구

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

연락처 관리 도구

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

회사 관리 도구

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

참여 도구

• hubspot_get_recent_engagements
  • 모든 연락처와 회사의 최근 참여 활동을 확인하세요.
  • 입력:
    • days (정수, 선택 사항): 되돌아볼 일 수(기본값: 7)
    • limit (정수, 선택 사항): 반환할 최대 참여 수(기본값: 50)
  • 반환: 전체 메타데이터가 포함된 참여 객체 배열
• hubspot_get_recent_companies
  • HubSpot에서 가장 최근에 활동한 회사를 받으세요
  • 입력:
    • limit (정수, 선택 사항): 반환할 최대 회사 수(기본값: 10)
  • 반환: 전체 메타데이터가 포함된 회사 개체 배열
• hubspot_get_recent_contacts
  • HubSpot에서 가장 최근에 활성화된 연락처 가져오기
  • 입력:
    • limit (정수, 선택 사항): 반환할 최대 연락처 수(기본값: 10)
  • 반환: 전체 메타데이터가 포함된 연락처 객체 배열

설정

Smithery를 통해 설치

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

필수 조건

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

1. HubSpot 계정에서 개인 앱 만들기: HubSpot 개인 앱 가이드를 따르세요.
   • HubSpot 계정 설정으로 이동하세요
   • 통합 > 개인 앱으로 이동
   • "비공개 앱 만들기"를 클릭하세요
   • 기본 정보를 입력하세요:
     • 앱 이름 지정
     • 설명 추가
     • 로고 업로드(선택 사항)
   • 필요한 범위를 정의하세요.
     • 티켓
     • crm.객체.연락처.쓰기
     • crm.objects.contacts.sensitive.read
     • crm.objects.companies.sensitive.read
     • 판매-이메일-읽기
     • crm.objects.deals.sensitive.read
     • crm.objects.companies.write
     • crm.객체.회사.읽기
     • crm.객체.거래.읽기
     • crm.objects.deals.write
     • 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 라이선스에 따라 라이선스가 부여되었습니다.