허브스팟 MCP 서버

원활한 HubSpot CRM 통합을 위한 강력한 MCP(Model Context Protocol) 서버 구현으로, AI 어시스턴트가 HubSpot 데이터와 상호 작용할 수 있습니다.

개요

이 MCP 서버는 HubSpot CRM API와 상호 작용하기 위한 포괄적인 도구 세트를 제공하여 AI 도우미가 다음을 수행할 수 있도록 합니다.

• HubSpot CRM에서 연락처와 회사를 만들고 관리하세요.
• 자세한 회사 활동 내역 및 참여 일정을 검색합니다.
• HubSpot 인스턴스 전체에서 최근 참여 데이터에 액세스하세요.
• 최근 활동한 회사 및 연락처 목록을 받으세요
• AI 어시스턴트 인터페이스를 벗어나지 않고도 CRM 작업을 수행하세요

왜 이 MCP 서버를 사용해야 하나요?

• 원활한 AI 통합 : AI 어시스턴트를 HubSpot CRM 데이터에 직접 연결
• 간소화된 CRM 작업 : 자연어 명령을 통해 일반적인 HubSpot 작업 수행
• 실시간 데이터 액세스 : HubSpot 인스턴스에서 최신 정보를 얻으세요
• 보안 인증 : HubSpot의 보안 API 토큰 인증을 사용합니다.
• 확장 가능한 디자인 : 필요에 따라 더 많은 HubSpot API 기능을 쉽게 추가할 수 있습니다.

설치

지엑스피1

구성

서버에는 HubSpot API 액세스 토큰이 필요합니다. 다음 방법으로 토큰을 얻을 수 있습니다.

1. HubSpot 개발자 계정 으로 이동
2. 필요한 범위(연락처, 회사, 참여)를 갖춘 개인 앱 만들기
3. 생성된 액세스 토큰 복사

토큰은 두 가지 방법으로 제공할 수 있습니다.

1. 환경 변수로서:
   HUBSPOT_ACCESS_TOKEN=your-access-token
2. 명령줄 인수로:
   npm start -- --access-token=your-access-token

개발을 위해 프로젝트 루트에 .env 파일을 만들어 환경 변수를 저장합니다.

용법

서버 시작

SSE 서버에서 인증 구현

SSE 서버는 인증을 위해 mcp-proxy-auth 패키지를 사용합니다. 인증을 구현하려면 다음을 수행하세요.

1. 패키지를 설치하세요:
   npm install mcp-proxy-auth
2. AUTH_SERVER_URL 환경 변수를 API 키 확인 엔드포인트를 가리키도록 설정합니다.
   export AUTH_SERVER_URL=https://your-auth-server.com/verify
3. 인증을 사용하여 SSE 서버를 실행합니다.
   npx mcp-proxy-auth node dist/index.js
4. SSE URL은 다음에서 확인할 수 있습니다.
   localhost:8080/sse?apiKey=apikey
   인증을 위해 apikey 실제 API 키로 바꾸세요.

mcp-proxy-auth 패키지는 다음과 같은 프록시 역할을 합니다.

• SSE 서버에 대한 요청을 가로채기
• 인증 서버에 대해 API 키를 확인합니다.
• 인증된 요청만 SSE 엔드포인트에 도달하도록 허용합니다.

AI 어시스턴트와 통합

이 MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 지원하는 AI 어시스턴트와 함께 작동하도록 설계되었습니다. 서버가 실행되면 호환되는 AI 어시스턴트가 HubSpot CRM 데이터와 상호 작용하는 데 사용할 수 있는 도구 세트가 제공됩니다.

사용 가능한 도구

이 서버는 다음과 같은 강력한 HubSpot 통합 도구를 제공합니다.

1. 허브스팟_연락처_생성
   • 중복 검사를 통해 HubSpot에서 새 연락처 만들기
   • 매개변수:
     • firstname (문자열, 필수): 연락처의 이름
     • lastname (문자열, 필수): 연락처의 성
     • email (문자열, 선택 사항): 연락처의 이메일 주소
     • properties (객체, 선택 사항): 회사, 전화번호 등과 같은 추가 연락처 속성
   • 예:
     { "firstname": "John", "lastname": "Doe", "email": "john.doe@example.com", "properties": { "company": "Acme Inc", "phone": "555-123-4567", "jobtitle": "Software Engineer" } }
2. 허브스팟_회사_만들기
   • HubSpot에서 중복 검사를 통해 새 회사를 만듭니다.
   • 매개변수:
     • name (문자열, 필수): 회사 이름
     • properties (객체, 선택 사항): 추가 회사 속성
   • 예:
     { "name": "Acme Corporation", "properties": { "domain": "acme.com", "industry": "Technology", "phone": "555-987-6543", "city": "San Francisco", "state": "CA" } }
3. 허브스팟_회사_활동_받기
   • 특정 회사의 포괄적인 활동 내역을 확인하세요
   • 매개변수:
     • company_id (문자열, 필수): HubSpot 회사 ID
   • 이메일, 통화, 회의, 메모, 작업을 포함한 자세한 참여 데이터를 반환합니다.
4. 허브스팟_최근_참여_가져오기
   • 모든 연락처와 회사의 최근 참여 활동을 확인하세요.
   • 매개변수:
     • days (숫자, 선택 사항, 기본값: 7): 되돌아볼 일 수
     • limit (숫자, 선택 사항, 기본값: 50): 반환할 최대 참여 수
   • 최근 CRM 활동의 모든 연대순 목록을 반환합니다.
5. 허브스팟_활성_회사_만들기
   • HubSpot에서 가장 최근에 활동한 회사를 받으세요
   • 매개변수:
     • limit (숫자, 선택, 기본값: 10): 반환할 최대 회사 수
   • 마지막 수정 날짜별로 정렬된 반품 회사
6. 허브스팟_활성_연락처_받기
   • HubSpot에서 가장 최근에 활성화된 연락처 가져오기
   • 매개변수:
     • limit (숫자, 선택 사항, 기본값: 10): 반환할 최대 연락처 수
   • 마지막 수정 날짜별로 정렬된 연락처를 반환합니다.

서버 확장

이 서버는 쉽게 확장할 수 있도록 설계되었습니다. 새로운 HubSpot API 기능을 추가하려면 다음을 수행하세요.

1. src/hubspot-client.ts 의 HubSpotClient 클래스에 새로운 메서드를 추가합니다.
2. src/index.ts 의 setupToolHandlers 메서드에 새 도구를 등록합니다.
3. npm run build 로 프로젝트를 다시 빌드하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

키워드

HubSpot, CRM, 모델 컨텍스트 프로토콜, MCP, AI 어시스턴트, TypeScript, API 통합, HubSpot API, CRM 통합, 연락처 관리, 회사 관리, 참여 추적, AI 도구