---
title: OpenConnector용 HubSpot MCP 인증 앱 만들기
description: HubSpot MCP 인증 앱을 만들고 OpenConnector 리디렉션 URL을 구성한 다음 OAuth를 통해 HubSpot을 연결하세요.
lang: ko
canonical_url: https://oomol.com/ko/docs/openconnector-hubspot-oauth-app/
markdown_url: https://oomol.com/ko/docs/openconnector-hubspot-oauth-app.md
---

# OpenConnector용 HubSpot MCP 인증 앱 만들기

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

## OpenConnector 서비스

| 서비스 ID | 제공자 | 인증 유형 |
| --- | --- | --- |
| `hubspot` | HubSpot 원격 MCP 서버 | PKCE를 사용하는 OAuth2 |

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](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)입니다.

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

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

| HubSpot 값 | OpenConnector 필드 |
| --- | --- |
| 클라이언트 ID | `clientId` |
| 클라이언트 시크릿 | `clientSecret` |

## 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 작업을 실행하기 전에 콘솔 작업 세부 정보를 사용하세요.

## 문제 해결

| 증상 | 확인할 사항 |
| --- | --- |
| HubSpot에서 클라이언트 ID가 유효하지 않다고 표시됨 | 다른 HubSpot 앱 유형이 아닌 MCP 인증 앱에서 클라이언트 ID를 복사했는지 확인하세요. |
| 리디렉션 또는 콜백 실패 | HubSpot의 리디렉션 URL이 `<openconnector-origin>/oauth/callback`와 정확히 일치해야 합니다. |
| 토큰 교환 실패 | HubSpot MCP 인증 앱이 PKCE를 사용하는 OAuth를 지원하고 OpenConnector가 현재 HubSpot 제공자를 사용 중인지 확인하세요. |
| HubSpot 계정 선택이 잘못됨 | 브라우저에서 추가 HubSpot 계정에서 로그아웃하거나 인증을 위해 별도 브라우저 프로필을 사용하세요. |
| 작업에서 권한 오류 반환 | 연결된 HubSpot 사용자의 권한과 HubSpot MCP 앱의 현재 접근 규칙을 확인하세요. |