HubSpot MCP (Official)
HubSpot의 공식 Remote MCP 서버를 통해 HubSpot CRM 데이터에 안전하게 접근할 수 있습니다.
💡
이 페이지는 HubSpot의 공식 Remote MCP 서버 연동 방법을 안내합니다. AIP Built-in HubSpot MCP에 대해서는 HubSpot 페이지를 참고하세요.
개요
HubSpot은 공식 Remote MCP 서버(https://mcp.hubspot.com)를 제공합니다. 이 서버를 통해 AI 에이전트가 HubSpot CRM 데이터에 자연어로 접근할 수 있습니다.
QueryPie AIP에서는 이 공식 MCP 서버를 사전 구성된 Remote MCP로 제공하며, 연동을 위해 HubSpot Developer Portal에서 Client ID와 Client Secret을 발급받아야 합니다.
지원 데이터
현재 HubSpot 공식 MCP 서버는 다음 CRM 객체에 대한 읽기 전용 접근을 지원합니다:
- 연락처 (Contacts)
- 회사 (Companies)
- 거래 (Deals)
- 티켓 (Tickets)
- 장바구니 (Carts)
- 제품 (Products)
- 주문 (Orders)
- 라인 아이템 (Line Items)
- 인보이스 (Invoices)
- 견적서 (Quotes)
- 구독 (Subscriptions)
📖
자세한 내용은 HubSpot 공식 문서: Integrate with the Remote HubSpot MCP Server 를 참고하세요.
Client ID / Secret 발급 방법
Step 1: HubSpot Developer Portal 접속
- HubSpot 계정에 로그인합니다.
- Development 메뉴로 이동합니다.
- 좌측 사이드바에서 MCP Auth Apps를 선택합니다.
Step 2: MCP Auth App 생성
- 우측 상단의 Create MCP auth app을 클릭합니다.
- 다음 정보를 입력합니다:
- App name: 앱 이름 (예: QueryPie AIP)
- Description: 앱 설명 (선택)
- Redirect URL: AIP에서 제공하는 OAuth 콜백 URL
- Icon: 앱 아이콘 (선택)
- Create를 클릭합니다.
Step 3: Client ID / Secret 확인
앱 생성이 완료되면 앱 상세 페이지로 이동합니다. 이 페이지에서 Client ID와 Client Secret을 확인하고 복사합니다.
Step 4: AIP에서 연동 설정
- QueryPie AIP 관리 화면에서 HubSpot MCP (Official) 항목을 선택합니다.
- 발급받은 Client ID와 Client Secret을 입력합니다.
- 연동을 완료합니다.
⚠️
MCP Auth App 생성 시 별도의 scope 설정은 필요하지 않습니다. 사용 가능한 scope는 MCP 서버의 도구와 설치 시 사용자가 부여하는 권한에 따라 자동으로 결정됩니다.
참고 자료
Last updated on