OpenConnector용 HubSpot MCP 인증 앱 만들기

OpenConnector의 현재 HubSpot 제공자는 HubSpot의 원격 MCP OAuth 흐름을 사용합니다. HubSpot에서 MCP 인증 앱을 만들고 클라이언트 ID와 클라이언트 시크릿을 복사한 다음, OpenConnector의 hubspot 서비스에 해당 값을 저장하세요.

OpenConnector 서비스

HubSpot 제공자는 https://mcp.hubspot.com를 통해 연결됩니다. HubSpot의 MCP 인증 앱은 HubSpot 측 권한과 계정 인증 흐름을 제어합니다.

사전 요구 사항

• 실행 중인 OpenConnector 런타임.
• Developer Platform 및 MCP Auth Apps에 접근할 수 있는 HubSpot 계정.
• 연결하려는 HubSpot 계정의 MCP 인증 앱을 만들 수 있는 권한.
• 사용자가 브라우저에서 여는 OpenConnector 오리진(예: http://localhost:3000 또는 https://connect.example.com).

1단계: OpenConnector 콜백 URL 설정

OpenConnector 오리진 뒤에 /oauth/callback를 추가하여 콜백 URL을 만드세요. 로컬 테스트에는 http://localhost:3000/oauth/callback를 사용하세요. 공개 배포의 경우 OOMOL_CONNECT_ORIGIN을 설정하고 OpenConnector를 다시 시작한 다음, 공개 콜백 URL(예: https://connect.example.com/oauth/callback)을 사용하세요.

2단계: HubSpot MCP 인증 앱 만들기

HubSpot에서:

1. 연결하려는 HubSpot 계정을 엽니다.
2. 개발을 엽니다.
3. MCP 인증 앱을 엽니다.
4. 새 MCP 인증 앱을 만듭니다.
5. 식별 가능한 앱 이름을 입력합니다.
6. 리디렉션 URL을 정확한 OpenConnector 콜백 URL로 설정합니다.
7. 앱을 저장합니다.

HubSpot의 공식 가이드는 Integrate AI tools with the HubSpot MCP server입니다.

3단계: 클라이언트 자격 증명 복사

HubSpot MCP 인증 앱 세부 정보에서 다음을 복사하세요:

4단계: OpenConnector에 HubSpot 클라이언트 저장

OpenConnector 웹 콘솔을 사용하세요:

1. OpenConnector 웹 콘솔(예: http://localhost:3000)을 엽니다.
2. 제공자를 열고 HubSpot을 선택합니다.
3. Configure OAuth Client 또는 Edit OAuth Client를 선택합니다.
4. HubSpot 클라이언트 ID와 클라이언트 시크릿을 붙여넣습니다.
5. Save OAuth Client를 선택합니다.

5단계: 연결 및 테스트

OAuth 클라이언트를 저장한 후 HubSpot 제공자 페이지에서 연결을 선택하세요. HubSpot 계정을 선택하고 접근을 승인한 다음 OpenConnector로 돌아와 제공자 페이지에 계정이 연결됨으로 표시되는지 확인하세요.

hubspot.list_properties과 같은 CRM 작업을 실행하기 전에 콘솔 작업 세부 정보를 사용하세요.

문제 해결