허브스팟 MCP 서버

개요

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

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

왜 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"
      ]
    }
  }
}

Docker 이미지 빌드

Docker 이미지를 로컬로 빌드하려면:

git clone https://github.com/buryhuang/mcp-hubspot.git
cd mcp-hubspot
docker build -t mcp-hubspot .

다중 플랫폼 빌드의 경우:

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

개발

pip install -e .

특허

MIT 라이센스

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

표준화된 인터페이스를 통해 AI 모델이 HubSpot CRM 데이터 및 운영과 상호 작용할 수 있도록 하여 연락처 및 회사 관리를 지원합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

HubSpot MCP Server
SheffieldP
-
security
A
license
-
quality
A server that enables AI models to interact with HubSpot CRM data and operations through a standardized interface, supporting contact and company management with multi-user token-based authentication.
Last updated -
Python
MIT License
HubSpot MCP
shinzo-labs
A
security
A
license
A
quality
A Model Context Protocol implementation for the HubSpot API that provides a standardized interface for accessing and managing CRM data, including companies, contacts, deals, and other objects with comprehensive CRUD operations and association management.
Last updated -
101
148
10
JavaScript
MIT License
HubSpot MCP Server
KaranThink41
-
security
A
license
-
quality
A Model Context Protocol server that provides tools for interacting with HubSpot CRM, allowing users to create, update, delete, and fetch summary records stored as Note engagements in HubSpot.
Last updated -
JavaScript
MIT License
HubSpot MCP Server
KaranThink41
A
security
A
license
A
quality
Enables AI models to interact with HubSpot CRM data and operations through a standardized interface while providing a centralized shared space for teams to share conversation summaries in real time.
Last updated -
8
Python
MIT License

View all related MCP servers

HubSpot MCP Server