허브스팟 MCP 서버

개요

이 프로젝트는 HubSpot CRM과 통합되고 중앙 집중식 공유 공간 기능을 포함하는 모델 컨텍스트 프로토콜(MCP) 서버를 구현합니다. 이 서버를 통해 AI 모델은 표준화된 인터페이스를 통해 HubSpot 데이터 및 운영과 상호 작용할 수 있으며, 팀원들은 주요 대화 요약을 실시간으로 공유할 수 있습니다.

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

구성 요소

자원

어떤 리소스도 구현되지 않습니다. 궁극적으로 시스템은 도구에 의해 구동됩니다.

예시 프롬프트

LinkedIn 프로필 웹페이지에서 복사하여 HubSpot 연락처를 만듭니다.

지엑스피1

회사의 최신 활동을 알아보세요:

# Example VB.NET prompt
- What's happening latestly with my pipeline?

공유 공간의 예:

회의가 끝나면 AI 명령 상자에서 "회사에서 공유 공간을 통해 대화 요약을 하는 게 가능할까요? (예/아니요)"라고 묻습니다. 확인 시 대화 요약은 중앙에 저장되고 회사의 모든 권한이 있는 관리자가 접근할 수 있습니다.

도구

이 서버는 새로운 공유 공간 도구와 함께 HubSpot 객체를 관리하기 위한 여러 도구를 제공합니다.

연락처 관리 도구

hubspot_create_contact
- HubSpot에서 새 연락처를 만듭니다(중복 확인 필요).
- 입력:
  - 이름(문자열)
  - 성(문자열)
  - 이메일(문자열, 선택 사항)
  - 속성(사전, 선택 사항; 예: {"phone": "123456789", "company": "HubSpot"})

회사 관리 도구

hubspot_create_company
- HubSpot에 새로운 회사를 만듭니다(중복 검사 포함).
- 입력:
  - 이름(문자열)
  - 속성(사전, 선택 사항)
hubspot_get_company_activity
- 특정 회사의 활동 내역을 검색합니다.
- 입력:
  - 회사 ID(문자열)

참여 도구

hubspot_get_recent_engagements
- 최근의 참여 활동을 검색합니다.
- 입력:
  - 일(정수, 기본값 7)
  - 제한(정수, 기본값 50)
hubspot_get_recent_companies
- 가장 최근에 활동한 회사를 검색합니다.
- 입력:
  - 제한(정수, 기본값 10)
hubspot_get_recent_contacts
- 가장 최근에 활동한 연락처를 검색합니다.
- 입력:
  - 제한(정수, 기본값 10)

공유 공간 도구

create_shared_summary
- 공유 공간에 새로운 대화 요약을 만듭니다.
- 입력:
  - user_id(문자열, 사용자의 이메일/ID)
  - 회사 ID(문자열)
  - 요약(문자열)
get_shared_summaries
- 특정 회사의 모든 대화 요약을 검색합니다.
- 입력:
  - user_id(문자열)
  - 회사 ID(문자열)

이러한 공유 공간 도구를 사용하면 권한이 있는 관리자가 회의 요약을 공유하여 실시간 팀 협업과 주요 통찰력에 대한 중앙 집중식 접근이 가능해집니다.

설정

Smithery를 통해 설치

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

npx -y @smithery/cli install buryhuang/mcp-hubspot --client claude

필수 조건

HubSpot 액세스 토큰이 필요합니다. HubSpot 계정에서 비공개 앱을 생성하여 액세스 토큰을 받으세요(HubSpot 비공개 앱 가이드 참조). 토큰을 안전하게 보관하세요.

도커 설치

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

docker pull buryhuang/mcp-hubspot:latest

옵션 2: 로컬로 빌드

docker build -t mcp-hubspot .

컨테이너를 실행합니다.

docker run -e HUBSPOT_ACCESS_TOKEN=your_access_token_here buryhuang/mcp-hubspot:latest

또는 토큰을 인수로 전달합니다.

docker run buryhuang/mcp-hubspot:latest --access-token your_access_token_here

크로스 플랫폼 퍼블리싱

새로운 빌더 인스턴스를 만듭니다.

docker buildx create --use

다양한 플랫폼을 구축하고 푸시하세요.

docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push .

이미지를 확인하세요:

docker buildx imagetools inspect buryhuang/mcp-hubspot:latest

Claude Desktop과 함께 사용

Smithery를 통해 설치

npx -y @smithery/cli@latest install mcp-hubspot --client claude

Docker 사용법

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HUBSPOT_ACCESS_TOKEN=your_access_token_here",
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

또는 명령줄 인수를 사용합니다.

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-hubspot:latest",
        "--access-token",
        "your_access_token_here"
      ]
    }
  }
}

개발

개발 환경을 설정하려면:

pip install -e .

공유 공간 통합

공유 공간 기능은 별도의 모듈(shared_space.py)에 구현되어 있습니다. 이 모듈은 다음을 수행합니다.

외부 JSON 파일이나 데이터베이스에서 동적 사용자 역할을 로드합니다.
대화 요약에 대한 CRUD 엔드포인트(create_summary, get_summaries, update_summary, delete_summary)를 구현합니다.
실시간 알림 플레이스홀더를 트리거합니다(나중에 SSE 또는 WebSockets와 통합할 수 있음).

메인 server.py 파일은 이러한 함수를 가져와서 새로운 MCP 도구(create_shared_summary 및 get_shared_summaries)로 등록합니다.

특허

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

업데이트된 README에서는 이제 HubSpot MCP 통합을 사용한 추가 공유 공간 기능을 반영하고 시스템이 어떻게 구성되고 사용되는지 설명합니다.

HubSpot MCP Server

Integrations