> For the complete documentation index, see [llms.txt](https://guide.roundhr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.roundhr.com/round-ai/mcp.md).

# MCP 연동

{% hint style="warning" %}
MCP 연동은 엔터프라이즈 플랜의 관리자 권한 이상만 사용 가능합니다.\
Beta 기간 동안은 모든 플랜의 관리자 권한 이상 사용 가능합니다.
{% endhint %}

{% hint style="danger" %}
**MCP 연동은 조직별 사전 승인이 필요합니다.**\
Beta 기간 동안에는 라운드HR 운영팀의 승인을 받은 조직만 MCP 기능을 이용할 수 있습니다.\
승인되지 않은 조직은 OAuth 인증 단계에서 차단되며, **\[허용]을 클릭해도 연동이 완료되지 않고 라운드HR 홈으로 이동되며 안내 메시지가 표시됩니다.**\
사용을 원하시면 [고객지원](mailto:operation@roundhr.com)으로 문의해주세요.
{% endhint %}

**MCP**(**Model Context Protocol**)는 AI 모델이 외부 데이터에 접근할 수 있게 해주는 연결 프로토콜입니다. 라운드HR MCP 서버를 연동하면 Claude, ChatGPT 등 AI를 활용하여 채용 데이터를 자유롭게 분석할 수 있습니다.

## 1. Claude 연동 (OAuth 방식)

***

[Claude](https://claude.ai/)에서 라운드HR MCP를 직접 연동하는 방법입니다.

{% hint style="warning" %}
Claude 무료 버전도 사용 가능하지만 사용량 제한이 있어 **Pro 플랜 이상**을 권장합니다.
{% endhint %}

### Claude에 MCP 서버 연동하기

* [claude.ai](https://claude.ai/)에 접속하여 로그인합니다.
* **사용자 지정 → 커넥터**로 이동한 후 **+** 버튼을 클릭하여 \[커스텀 커넥터 추가]를 선택합니다.

<figure><img src="/files/5SzuQkDiwokjrCvHhsHM" alt="Claude 사용자 지정 > 커넥터에서 [커스텀 커넥터 추가]를 선택하는 화면"><figcaption><p>커스텀 커넥터 추가 진입</p></figcaption></figure>

* \[커스텀 커넥터 추가] 팝업에 라운드HR MCP 서버 정보를 입력한 후 \[추가]를 클릭합니다.
  * **이름**: `라운드HR`
  * **원격 MCP 서버 URL**: `https://mcp.roundhr.com`

<figure><img src="/files/anDvObZUAqNUWwOnZx1M" alt="커스텀 커넥터 추가 팝업. 이름 라운드HR과 원격 MCP 서버 URL 입력"><figcaption><p>MCP 서버 정보 입력</p></figcaption></figure>

* \[연결]을 클릭하면 브라우저가 열립니다.

<figure><img src="/files/929WmpFdhVB4g8rE8lLE" alt="커넥터 목록에서 [연결]을 클릭해 브라우저 인증을 시작하는 화면"><figcaption><p>연결 시작</p></figcaption></figure>

* \[허용]을 클릭하면 인증이 완료됩니다.

<figure><img src="/files/r4cN3cVp6dKYjMgjyv7o" alt="라운드HR OAuth 인증 화면의 [허용] 버튼"><figcaption><p>인증 허용</p></figcaption></figure>

* 정상적으로 연동되면 연동 목록에 라운드HR이 표시됩니다.

<figure><img src="/files/lOovbKjDd9t4ZSQt56Lp" alt="연동 완료 후 커넥터 목록에 표시된 라운드HR"><figcaption><p>연동 완료</p></figcaption></figure>

## 2. Chat GPT 연동(OAuth 방식)

Chat GPT(웹)에서 라운드HR MCP를 직접 연동하는 방법입니다.

{% hint style="warning" %}
Chat GPT의 웹 버전에서만 연동이 가능합니다.(데스크탑앱에서는 연동 X)
{% endhint %}

### Chat GPT에 MCP 서버 연동하기

* [Chat GPT](https://chatgpt.com/)에 접속하여 로그인합니다.
* **설정 > 앱 > 고급설정**으로 이동합니다.

<figure><img src="/files/b0ouxDeq3SicmjSyQOjQ" alt="ChatGPT 설정 > 앱 > 고급설정 메뉴로 이동하는 화면"><figcaption><p>ChatGPT 고급설정 진입</p></figcaption></figure>

<figure><img src="/files/GwWKnNAGSqxSw5qiQdgy" alt="고급설정의 개발자 모드 토글"><figcaption><p>개발자 모드 활성화</p></figcaption></figure>

* 개발자 모드 토글을 ON합니다.
* 상단의 \[앱 만들기]를 클릭합니다.

<figure><img src="/files/dUBi7lDSPeLno3rtUOJr" alt="상단의 [앱 만들기] 버튼을 클릭하는 화면"><figcaption><p>앱 만들기</p></figcaption></figure>

\[앱 만들기] 팝업에 라운드HR MCP 서버 정보를 입력한 후 \[만들기]를 클릭합니다.

* **이름**: `라운드HR`
* **MCP 서버 URL**: `https://mcp.roundhr.com`
* **인증 방식** : OAuth

<figure><img src="/files/OyEnSjFnT3KVZpe4c1k4" alt="앱 만들기 팝업. 이름 라운드HR, MCP 서버 URL, OAuth 인증 방식 입력"><figcaption><p>앱 정보 입력</p></figcaption></figure>

<figure><img src="/files/BI9x8MSMiVjG6CzJpriG" alt="[만들기] 클릭 후 OAuth 인증을 진행하는 화면"><figcaption><p>OAuth 인증</p></figcaption></figure>

* 활성화된 앱에 \[라운드HR]이 보이면 연결이 완료된 것입니다.

<figure><img src="/files/vjsWX1QDQpJZqjfpBp29" alt="활성화된 앱 목록에 표시된 라운드HR"><figcaption><p>연결 완료</p></figcaption></figure>

### Chat GPT에서 라운드 MCP 사용하기

* 대화창에서 \*\*\[더보기] > \[라운드HR]\*\*을 선택 후 질문을 합니다.

<figure><img src="/files/nlBBwTiFAFMp2b4exfnw" alt="대화창의 [더보기] > [라운드HR] 선택 후 질문하는 화면"><figcaption><p>라운드HR MCP 사용</p></figcaption></figure>

## 3. Smithery를 통한 연동 (OAuth 방식)

***

[Smithery](https://smithery.ai/)를 통해 Claude 데스크탑앱에 라운드HR MCP를 연동하는 방법입니다.

{% hint style="info" %}
**Smithery**는 MCP 서버를 쉽게 검색하고 연동할 수 있는 플랫폼입니다.
{% endhint %}

### 3-1. Smithery에서 연결 URL 복사하기

* [Smithery](https://smithery.ai/)에 접속 후 회원가입합니다.
* 검색창에서 `roundHR`을 검색합니다.
* **connection URL**을 복사합니다.

<figure><img src="/files/OQQQzF8TJjmEwIIDLYly" alt="Smithery에서 roundHR을 검색한 결과 화면"><figcaption><p>Smithery에서 roundHR 검색</p></figcaption></figure>

<figure><img src="/files/ctCBapYIXe9Og5tixEkG" alt="roundHR MCP의 connection URL을 복사하는 화면"><figcaption><p>connection URL 복사</p></figcaption></figure>

### 3-2. Claude 데스크탑앱에 연동하기

* Claude 데스크탑앱을 실행하고 설정 → 커넥터 → \[커스텀 커넥터 추가]를 클릭합니다.
* 이름과 MCP URL을 입력합니다.
  * **이름**: 구분할 수 있도록 자유롭게 입력
  * **MCP URL**: Smithery에서 복사한 connection URL을 붙여넣기

> `https://smithery-mcp.roundhr.com`

<figure><img src="/files/2TvVCFImuFVaglsndTfG" alt="Claude 데스크탑앱 커스텀 커넥터 추가에 이름과 MCP URL을 입력하는 화면"><figcaption><p>커넥터 정보 입력</p></figcaption></figure>

* 정상적으로 연동이 되었다면 커넥터 리스트에 추가됩니다.
* 리스트에서 \[연결]을 클릭하면 브라우저가 열립니다.

<figure><img src="/files/R3NhpoGAMK653QULPd2e" alt="커넥터 리스트에 추가된 라운드HR과 [연결] 버튼"><figcaption><p>커넥터 연결</p></figcaption></figure>

* \[허용]을 클릭하면 인증이 완료됩니다.
* 정상적으로 연동되면 커넥터 목록에 라운드HR이 표시됩니다.

## 4. 데이터 분석 시작하기

***

MCP 연동이 완료되면 AI를 활용하여 채용 데이터를 분석할 수 있습니다.

### 4-1. 데이터 분석용 프로젝트 생성하기

* Claude에서 새 프로젝트를 생성합니다.

<figure><img src="/files/pcV7gX7OMeYnFvJwY1tV" alt="Claude에서 새 프로젝트를 생성하는 화면"><figcaption><p>프로젝트 생성</p></figcaption></figure>

### 4-2. 프로젝트 지침 설정하기

{% hint style="info" %}
프로젝트의 지침을 설정하면 원하는 방향으로 분석을 조절할 수 있습니다.\
지침의 내용은 자유롭게 수정 가능합니다.
{% endhint %}

* 프로젝트의 지침에 아래 내용을 붙여 넣습니다.

```
[Role]
당신은 시니어 채용 데이터 분석가입니다.

[Task]
라운드HR MCP를 이용해서 채용 관련 데이터를 분석하고 숨겨진 인사이트 및 액션 아이템을 도출합니다.
필요에 따라 그래프나 표를 이용하여 분석합니다.
```

<figure><img src="/files/ZUYzf67yTrZQc5i6ce9L" alt="프로젝트 지침에 분석용 프롬프트를 붙여넣은 화면"><figcaption><p>프로젝트 지침 설정</p></figcaption></figure>

### 4-3. 데이터 분석하기

* 자유롭게 질문을 작성하여 채용 데이터를 분석합니다.

<figure><img src="/files/cTIOZvF6ncS7dS8vxgN1" alt="라운드HR MCP로 채용 데이터를 분석한 대화 화면"><figcaption><p>데이터 분석 예시</p></figcaption></figure>

{% hint style="success" %}
**MCP 분석 팁**: Claude **설정 → 프로필 설정**에서 본인의 업무, 관심사 등을 작성해두면 맞춤형 답변을 제공받을 수 있습니다.
{% endhint %}

## FAQ

***

<details>

<summary>지원자 정보 보안은 문제 없나요?</summary>

MCP 서버에 연결된 DB는 통계 분석을 위해 **비식별화된 데이터만** 별도로 구성했기 때문에 지원자를 식별하여 데이터를 확인할 수 없습니다.

</details>

<details>

<summary>볼 수 있는 데이터의 범위는 어떻게 되나요?</summary>

OAuth 인증을 통해 **우리 조직의 데이터만** 확인할 수 있습니다. 공고별 권한이 적용되지 않고 조직의 모든 공고 데이터를 확인할 수 있기 때문에, **관리자 권한**을 가진 사용자만 연동할 수 있습니다.

</details>

<details>

<summary>대화가 길어질수록 답변이 이상해져요</summary>

AI는 메모리를 이용해 이전 대화 내용을 어느 정도 기억하며 답변합니다. 다만 메모리 한계로 대화가 길어지면 앞의 대화 내용이 소실되어 답변 정확도가 달라질 수 있습니다. 대화가 길어지면 **새 대화를 시작**하는 것을 권장합니다.

</details>

<details>

<summary>질문을 했는데 '라운드 MCP'를 확인할 수 없다고 떠요</summary>

MCP 연동 후 리프레시가 되지 않았을 수 있습니다. 클로드 데스크탑앱을 **완전히 종료 후 재실행**한 다음 다시 질문해보세요.

</details>

<details>

<summary>[허용]을 눌렀는데 연동이 되지 않고 홈 화면으로 이동돼요</summary>

MCP 기능은 **조직별 사전 승인**이 필요합니다. 승인되지 않은 조직은 OAuth 인증 시점에 차단되어, \[허용]을 클릭해도 연동이 완료되지 않고 라운드HR 홈으로 리다이렉트되며 "MCP 연동은 사전 승인이 필요합니다" 안내 메시지가 표시됩니다.\
라운드HR [고객지원](mailto:support@roundhr.com)으로 조직 정보와 함께 MCP 사용 승인을 요청해주세요.

</details>