# 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=""><figcaption></figcaption></figure>

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

<figure><img src="/files/anDvObZUAqNUWwOnZx1M" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/929WmpFdhVB4g8rE8lLE" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/r4cN3cVp6dKYjMgjyv7o" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/lOovbKjDd9t4ZSQt56Lp" alt=""><figcaption></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=""><figcaption></figcaption></figure>

<figure><img src="/files/GwWKnNAGSqxSw5qiQdgy" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/dUBi7lDSPeLno3rtUOJr" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/OyEnSjFnT3KVZpe4c1k4" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/BI9x8MSMiVjG6CzJpriG" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/vjsWX1QDQpJZqjfpBp29" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/nlBBwTiFAFMp2b4exfnw" alt=""><figcaption></figcaption></figure>

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

***

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

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

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

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

<figure><img src="/files/OQQQzF8TJjmEwIIDLYly" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ctCBapYIXe9Og5tixEkG" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/2TvVCFImuFVaglsndTfG" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/R3NhpoGAMK653QULPd2e" alt=""><figcaption></figcaption></figure>

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

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

***

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

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

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

<figure><img src="/files/pcV7gX7OMeYnFvJwY1tV" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

<figure><img src="/files/ZUYzf67yTrZQc5i6ce9L" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/cTIOZvF6ncS7dS8vxgN1" alt=""><figcaption></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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.roundhr.com/round-ai/mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.