허브스팟 MCP 서버

도커 허브 라이센스: MIT

개요

AI 어시스턴트가 HubSpot CRM 데이터와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 AI 모델을 HubSpot 계정과 연결하여 연락처, 회사 및 참여 데이터에 직접 액세스할 수 있도록 합니다. 내장된 벡터 스토리지 및 캐싱 메커니즘은 HubSpot API의 한계를 극복하고 응답 시간을 단축하는 데 도움이 됩니다.

저희 구현 방식은 가장 자주 사용되고 가치가 높은 HubSpot 작업을 우선시하며, 강력한 오류 처리 및 API 안정성을 제공합니다. 각 구성 요소는 AI 친화적인 상호작용에 최적화되어 있어 복잡하고 여러 단계로 구성된 CRM 워크플로에서도 안정적인 성능을 보장합니다.

Related MCP server: HubSpot MCP

왜 MCP-HubSpot인가요?

직접 CRM 액세스 : 중간 단계 없이 Claude 및 기타 AI 도우미를 HubSpot 데이터에 연결합니다.
컨텍스트 유지 : FAISS를 사용한 벡터 저장을 통해 이전 상호 작용에 대한 의미 검색이 가능해집니다.
제로 구성 : 최소한의 설정으로 간단한 Docker 배포

예시 프롬프트

지엑스피1

What's happening lately with my pipeline?

사용 가능한 도구

이 서버는 HubSpot 관리 및 데이터 검색을 위한 도구를 제공합니다.

도구	목적
`hubspot_create_contact`	중복 방지를 통해 연락처 생성
`hubspot_create_company`	중복 방지를 통해 기업을 만들어 보세요
`hubspot_get_company_activity`	특정 회사의 활동 검색
`hubspot_get_active_companies`	가장 최근에 활동한 회사 검색
`hubspot_get_active_contacts`	가장 최근에 활동한 연락처 검색
`hubspot_get_recent_conversations`	메시지가 포함된 최근 대화 스레드 검색
`hubspot_search_data`	이전에 검색된 HubSpot 데이터에 대한 의미 검색

성능 특징

벡터 스토리지 : 효율적인 의미 검색 및 검색을 위해 FAISS 활용
스레드 수준 인덱싱 : 정확한 검색을 위해 각 대화 스레드를 개별적으로 저장합니다.
임베딩 캐싱 : 자동 캐싱을 갖춘 SentenceTransformer 사용
영구 저장소 : 데이터는 구성 가능한 저장소 디렉토리의 세션 간에 유지됩니다.
다중 플랫폼 지원 : 다양한 아키텍처에 최적화된 Docker 이미지

설정

필수 조건

다음 범위의 HubSpot 액세스 토큰이 필요합니다.

crm.objects.contacts(읽기/쓰기)
crm.objects.companies(읽기/쓰기)
판매-이메일-읽기

빠른 시작

# Install via Smithery (recommended) npx -y @smithery/cli@latest install mcp-hubspot --client claude # Or pull Docker image directly docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest

Docker 구성

Claude 데스크톱에서 수동 구성:

{ "mcpServers": { "hubspot": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "HUBSPOT_ACCESS_TOKEN=your_token", "-v", "/path/to/storage:/storage", # Optional persistent storage "buryhuang/mcp-hubspot:latest" ] } } }