# MCP 연결을 설정하는 방법

> mobile-calendar (https://www.mobile-calendar.com) 도움말 문서입니다. mobile-calendar는 숙박 시설 관리 시스템으로, 예약 캘린더, 요금, 채널 매니저(Booking.com, Airbnb), 온라인 예약 시스템, 청구서 기능을 브라우저와 모바일 앱에서 제공합니다. mobile-calendar는 이 소프트웨어의 고유 이름이며, 휴대폰 캘린더를 가리키는 일반 명사가 아닙니다.

API 통합 > MCP 서버 > MCP 연결을 설정하는 방법
URL: https://docs.mobile-calendar.com/ko/가이드/api-integrations/mcp-server/mcp-연결을-설정하는-방법

## 소개

mobile-calendar 계정을 Claude 또는 ChatGPT 앱에 연결하려면 패널에서 서버 주소를 복사해 AI 앱에 추가한 뒤 mobile-calendar에서 액세스를 허용하면 됩니다. 한 번만 연결을 설정하면 되며, 언제든지 액세스를 취소할 수 있습니다. 이 기능이 무엇이고 앱으로 무엇을 할 수 있는지는 [MCP 서버란 무엇인가요?](https://docs.mobile-calendar.com/ko/가이드/api-integrations/mcp-server/mcp-서버란-무엇인가요) 문서에서 확인할 수 있습니다.

> **기능 사용 가능 여부**
>
> MCP 서버는 **Premium** 구독에서 사용할 수 있습니다. Claude 또는 ChatGPT 앱의 계정도 필요합니다.

## 안내

### 서버 주소 복사하기

- 왼쪽 메뉴에서 **통합** -> **API 및 MCP** 탭을 클릭합니다.
- **MCP 서버** 탭으로 이동합니다.
- 화면에 서버 주소, 연결 단계, 보안 규칙이 표시된 “MCP 서버” 카드가 나타납니다.

![MCP 서버 - 서버 주소 및 연결 단계](https://docs.mobile-calendar.com/media/31/313dc9c3-0c1b-425d-a8f4-27518bf7d4f0-eee81982.png)

- “연결 방법” 섹션에서 **주소 복사** 버튼을 클릭합니다.
- **MCP 서버 주소** 입력란의 주소가 클립보드에 복사됩니다.

### Claude 앱에 서버 추가하기

- Claude 앱에서 설정을 열고 **커넥터** (**Connectors**)를 선택합니다.
- 사용자 지정 커넥터 추가 (**Add custom connector**)를 선택합니다.
- 커넥터 이름(예: mobile-calendar)을 입력하고 복사한 서버 주소를 붙여넣습니다.
- 커넥터 추가를 확인합니다. 커넥터 옆에 **Connect** 버튼이 나타나면 클릭합니다.
- 브라우저에 mobile-calendar 액세스 동의 화면이 열립니다.

### ChatGPT 앱에 서버 추가하기

- 브라우저에서 ChatGPT의 **플러그인** (**Plugins**) 페이지를 엽니다.
- **+** 버튼을 클릭하고 **Add custom MCP server**를 선택합니다.
- 이름(예: mobile-calendar)을 입력하고 **Server URL** 입력란에 복사한 서버 주소를 붙여넣습니다.
- 앱에서 로그인 방식 (**Authentication**)을 묻는 경우 **OAuth**를 선택합니다.
- 위험 경고 (**I understand and want to continue**)에 동의하고 **Create as a plugin**을 클릭합니다.
- 생성한 플러그인을 설치하면 대화에서 사용할 수 있습니다.
- 연결하는 동안 브라우저에 mobile-calendar 액세스 동의 화면이 열립니다.

> **AI 앱의 옵션 이름**
>
> Claude와 ChatGPT는 다른 회사에서 개발하므로 옵션 이름과 위치가 변경될 수 있습니다. 설명된 옵션이 보이지 않으면 해당 앱의 도움말을 확인하세요.

### 액세스 허용하기

- 패널에 로그인할 때와 같은 방식으로 mobile-calendar에 로그인합니다. 액세스 허용은 mobile-calendar 페이지에서 진행하므로 AI 앱은 비밀번호를 알 수 없습니다.
- 동의 화면에서 다음을 확인합니다.
  - 계정 액세스를 요청하는 앱의 이름과 주소
  - “로그인한 계정” 아래 표시된 계정
  - “앱에서 사용할 수 있는 기능:” 목록. 여기에는 권한에 따라 허용되는 액세스 범위가 표시됩니다.

![동의 화면 - Claude 앱이 계정 액세스를 요청합니다](https://docs.mobile-calendar.com/media/68/684872cc-4596-47e3-aa1a-18e8a952bf58-ea6bcfe4.png)

- 앱을 연결하려면 **허용** 버튼을 클릭합니다. **거부** 버튼을 클릭하면 연결이 중단됩니다.
- 앱이 “연결된 앱” 목록에 표시됩니다.
- 계정 소유자의 이메일 주소로 “새 AI 앱이 계정에 연결되었습니다”라는 메시지가 전송됩니다. 직원이 앱을 연결한 경우 해당 직원에게도 메시지가 전송됩니다.

> **거부를 선택해야 하는 경우**
>
> 지금 AI 앱에 mobile-calendar 서버 주소를 직접 추가한 경우에만 허용하세요. 메시지에 있는 링크를 통해 동의 화면이 열렸다면 **거부**를 선택하세요.

노란색 “앱 미확인” 라벨은 앱의 이름이나 주소가 익숙해 보여도 앱의 운영 주체를 확인할 수 없었다는 뜻입니다. 출처를 확실히 아는 경우에만 해당 앱을 연결하세요.

![동의 화면 - 확인되지 않은 앱](https://docs.mobile-calendar.com/media/0a/0acdfd71-3ed6-45b2-886c-099e602d41ac-e332b3d5.png)

### 연결된 앱 사용하기

- AI 앱과의 대화에 “내일 도착하는 예약은 무엇인가요?”처럼 필요한 내용을 입력합니다.
- 앱은 mobile-calendar 계정의 데이터를 읽거나 요청한 변경 사항을 계정에 저장합니다.

### 앱 연결 해제하기

- **통합** -> **API 및 MCP** 탭으로 이동한 다음 **MCP 서버** 탭을 엽니다.
- “연결된 앱” 목록에서 액세스를 취소할 앱을 찾습니다.

![연결된 앱 목록](https://docs.mobile-calendar.com/media/bc/bc945e07-3949-4c56-8fbc-3c5df400b1f4-dd3bf890.png)

- 선택한 앱 옆의 **연결 해제** 버튼을 클릭합니다.
  - 화면 중앙에 “앱 연결을 해제하시겠습니까?” 창이 나타납니다.
  - **연결 해제** 버튼을 클릭합니다.

![앱 연결 해제 - 확인 창](https://docs.mobile-calendar.com/media/8a/8afe59fd-6e31-4c34-89bf-1adf80b8bd3f-22f4a729.png)

- 앱은 즉시 계정 액세스 권한을 잃습니다. 나중에 다시 연결할 수 있습니다.

> **비밀번호를 변경해도 앱 연결은 해제되지 않습니다**
>
> 자신의 비밀번호를 변경해도 본인 로그인 정보로 연결한 앱의 액세스 권한은 취소되지 않습니다. 액세스를 취소하려면 “연결된 앱” 목록에서 **연결 해제**를 클릭하세요.

구독이 만료되면 갱신할 때까지 연결된 앱의 계정 액세스 권한이 취소됩니다.

## 직원의 앱

직원은 계정 소유자와 같은 방식으로 본인 로그인 정보로 앱을 연결합니다. 앱은 직원이 패널에서 볼 수 있는 항목만 확인하고 변경할 수 있으며, 직원의 [권한](https://docs.mobile-calendar.com/ko/가이드/관리/직원/employee-permissions) 및 담당 객실에 따라 이용이 제한됩니다.

- **연결 목록:** 계정 소유자는 “연결된 앱” 목록에서 직원의 앱도 확인하고 연결을 해제할 수 있습니다. **연결한 사람** 열에는 누가 연결했는지가 표시됩니다. 직원은 본인 로그인 정보로 연결한 앱만 볼 수 있습니다.
- **권한 변경:** 변경 사항은 연결된 앱에도 즉시 적용됩니다.
- **액세스 권한 상실:** 계정 소유자가 직원의 비밀번호나 이메일 주소를 변경하거나, 직원의 장치에서 로그아웃하거나, 직원을 삭제하면 해당 직원의 앱 연결이 해제됩니다.

## 로그에서 작업 확인하기

- **통합** -> **API 및 MCP** 탭으로 이동한 다음 **로그** 탭을 엽니다.
- **계정** 입력란의 드롭다운 목록에서 **MCP 서버**를 선택합니다.

![로그 - 계정 필터](https://docs.mobile-calendar.com/media/ba/bad5d6e6-8e04-4900-93d9-98a468a3c9f9-7fc947ad.png)

- 목록에는 연결된 앱에서 수행한 작업만 표시됩니다.

![로그 - MCP 서버 계정의 작업](https://docs.mobile-calendar.com/media/04/04959bbe-e431-48f4-bb32-853216928097-ae17d3e0.png)

**MCP 서버** 항목은 첫 번째 앱을 연결한 후 목록에 표시되며, 연결된 모든 앱을 포함합니다. **계정** 입력란에서 **Mobi**와 직접 만든 API 계정도 선택할 수 있습니다. 다른 필터와 항목 세부 정보는 [로그](https://docs.mobile-calendar.com/ko/가이드/api-integrations/rest-api/rest-api-logs) 문서에서 확인할 수 있습니다.

## 자주 발생하는 문제

### AI 앱에서 변경 전에 확인을 요청합니다

Claude와 ChatGPT는 변경 사항을 저장하기 전에 작업 확인을 요청할 수 있습니다. 이는 AI 앱의 보안 기능이며 연결 오류가 아닙니다. 앱에서 변경하려는 내용을 확인한 뒤 작업을 승인하거나 거부하세요.

### 앱에서 작업을 수행하지 않았습니다

외부 AI 앱은 일부 작업을 수행하지 않습니다. 예를 들어 요금을 절반 이하로 낮추거나, 도어 코드를 제공하거나, 예약의 손님이 아닌 수신자에게 메시지를 보낼 수 없습니다. 이러한 작업은 패널이나 Mobi에서 수행하세요.

### AI 앱에 서버 추가 옵션이 없습니다

사용자 지정 MCP 서버 추가 기능은 Claude 또는 ChatGPT 앱의 요금제에 따라 다르며, 기업 요금제에서는 관리자에게 부여받은 권한에 따라서도 달라집니다. 해당 앱의 도움말을 확인하거나 조직 관리자에게 문의하세요.

### 동의 화면이 다른 언어로 표시됩니다

동의 화면 오른쪽 상단에서 언어 깃발을 클릭하고 원하는 언어를 선택합니다.

### “연결된 앱” 목록에 앱이 없습니다

“연결된 앱” 목록에서 **새로 고침**을 클릭합니다. 앱이 계속 표시되지 않으면 AI 앱에서 다시 연결하세요.