# AI 서비스별 연결 방법

> Claude, ChatGPT, Claude Code, Codex에 모모콜을 연결하고 첫 질문까지 해 보는 순서입니다. 어떤 서비스든 서버 주소 하나와 로그인 한 번이면 됩니다.

- 원문 주소: https://momocall.kr/docs/ai/connect
- 쓸 수 있는 요금제: 모든 요금제
- 마지막 확인: 2026-11-16
- 이런 분께 맞아요:
  - 대화형 AI만 쓰는 분: Claude 웹이나 ChatGPT 창에서 바로 통화 내용을 묻고 싶을 때 → Claude·ChatGPT 항목
  - 개발 도구를 쓰는 분: 터미널에서 Claude Code·Codex로 스크립트·연동을 만들 때 → Claude Code·Codex 항목

모든 AI 서비스에서 연결 순서는 같습니다.

1. AI 서비스에 서버 주소 `https://mcp.momocall.kr/mcp`를 등록합니다.
2. 브라우저에 **모모콜 연결** 화면이 뜨면 본인 확인을 합니다.
3. AI가 읽을 항목을 고르고 **허용**을 누릅니다.

```text
https://mcp.momocall.kr/mcp
```

## 본인 확인과 읽을 항목 고르기

연결 화면에서 세 가지 방법 중 하나로 본인을 확인합니다.

| 방법 | 언제 쓰나요 | 순서 |
|---|---|---|
| **모모콜 앱으로 QR 승인** (기본) | PC에서 연결할 때 | 화면의 QR을 휴대폰 카메라로 찍기 → 모모콜 앱의 승인 화면(현재는 "PC 로그인"으로 표시)에서 PC 화면에 보이는 숫자와 같은 숫자 고르기 |
| **이 휴대폰의 모모콜 앱으로 승인** | 휴대폰 브라우저에서 연결할 때 | 버튼을 누르면 모모콜 앱이 열림 → 승인 → 브라우저로 돌아옴 |
| **Google로 로그인** | 모모콜 앱에 Google 계정으로 가입한 경우 | 앱에서 쓰는 Google 계정으로 로그인 |

그다음 AI가 읽을 항목을 고릅니다.

| 항목 | 기본값 | 설명 |
|---|---|---|
| 연결 상태·AI 검색 남은 횟수 | 필수 | 연결이 잘 됐는지, 크레딧이 얼마나 남았는지 |
| 통화기록 | 필수 | 시각·방향·통화 시간·상대 이름 |
| 통화 요약 | 켜짐 | 앱이 만든 요약과 통화에서 나온 할 일 |
| 일정·할 일 | 켜짐 | 통화에서 뽑힌 일정과 할 일 |
| AI 검색 실행 | 켜짐 | 자연어 검색. 회당 크레딧 1개 사용 |
| 통화 전체 대화 내용(전사) | **꺼짐** | 말한 그대로의 기록. 가격·조건처럼 원문 확인이 필요할 때만 켜세요 |

> [!TIP]
> 처음에는 전사를 끈 채로 연결해 보세요. 대부분의 일은 요약만으로 충분합니다. 나중에 전사가 필요해지면 AI가 `INSUFFICIENT_SCOPE` 오류를 알려 주는데, 그때 다시 연결하면서 전사 항목만 추가로 체크하면 됩니다.

> [!WARNING]
> 동의 화면 맨 위에 연결하려는 AI 서비스 주소가 표시됩니다. `claude.ai`, `chatgpt.com`이 아닌 낯선 주소가 크게 보이면 직접 연결을 시작한 게 맞는지 확인하세요. 내가 시작하지 않은 연결 요청은 승인하지 마세요.

## Claude (웹·데스크톱 앱)

1. Claude에서 **설정 → 커넥터**로 갑니다.
2. **커스텀 커넥터 추가**를 누릅니다.
3. 이름에 `모모콜`, URL에 `https://mcp.momocall.kr/mcp`를 넣고 추가합니다.
4. **연결**을 누르면 모모콜 연결 화면이 열립니다. 본인 확인 후 항목을 고르고 허용합니다.
5. 새 대화에서 입력창의 도구 메뉴에 모모콜이 켜져 있는지 확인하고 질문합니다.

> [!NOTE]
> Claude Team·Enterprise 조직은 소유자가 조직 설정에서 커넥터를 먼저 추가해야 구성원이 연결할 수 있습니다. 커스텀 커넥터를 쓸 수 있는 요금제와 메뉴 이름은 Claude 정책에 따라 바뀔 수 있습니다.

## ChatGPT

ChatGPT는 외부 MCP 서버를 **개발자 모드**에서 연결합니다.

1. ChatGPT 웹에서 **설정 → 앱(앱 및 커넥터) → 고급 설정**으로 가서 **개발자 모드**를 켭니다.
2. 같은 화면에서 **앱 만들기**(또는 커넥터 만들기)를 누릅니다.
3. 이름 `모모콜`, MCP 서버 URL `https://mcp.momocall.kr/mcp`, 인증 방식 **OAuth**를 고르고 만듭니다.
4. 모모콜 연결 화면에서 본인 확인 후 허용합니다.
5. 대화창의 **+ → 개발자 모드**에서 모모콜을 선택한 뒤 질문합니다.

> [!NOTE]
> 개발자 모드를 쓸 수 있는 ChatGPT 요금제와 메뉴 이름은 OpenAI 정책에 따라 바뀔 수 있습니다. 모모콜 도구는 모두 읽기 전용이라 ChatGPT가 쓰기 확인 창을 띄우지 않습니다.

## Claude Code

**플러그인으로 설치하는 방법(권장)** 은 MCP 서버 연결과 업무 스킬 3종을 한 번에 설치합니다.

```text
/plugin install momocall --marketplace cashcall-team/momocall-plugins
```

MCP 서버만 따로 등록하려면 터미널에서 한 줄로 등록합니다. `--scope user`를 붙이면 모든 프로젝트에서 쓸 수 있습니다.

```bash
claude mcp add --transport http --scope user momocall https://mcp.momocall.kr/mcp
```

1. Claude Code를 실행하고 `/mcp`를 입력합니다.
2. 목록에서 `momocall`을 고르고 **Authenticate**를 누르면 브라우저가 열립니다.
3. 본인 확인과 항목 선택을 마치면 Claude Code로 돌아와 `connected`로 바뀝니다.
4. "어제부터 오늘까지 놓친 약속 정리해줘"처럼 질문합니다.

### 업무 스킬 함께 설치하기

모모콜은 자주 쓰는 업무 3가지를 **스킬**로 드립니다. 스킬을 설치하면 "놓친 약속 찾아줘"라고만 해도 AI가 정해진 순서와 안전 규칙대로 일합니다.

| 스킬 | 이럴 때 |
|---|---|
| `follow-up-review` | 놓친 약속·후속 연락 점검 |
| `customer-briefing` | 특정 고객 통화 준비 |
| `crm-integration-builder` | 통화 데이터를 CRM에 연동 |

#### 스킬은 어떤 파일인가요

- 스킬은 **프로그램이 아니라 마크다운 문서**입니다. AI에게 "이 순서로 일하고, 이것은 하지 마라"를 알려 주는 작업 절차서입니다. 설치해도 무언가가 자동으로 실행되지 않습니다.
- 모모콜 플러그인에는 실행 파일, 스크립트, 자동 실행 훅, 비밀값이 없습니다. 들어 있는 것은 스킬 문서 3개, 공통 안전 규칙 문서, MCP 서버 주소 한 줄(`.mcp.json`)뿐입니다.
- 모든 파일은 공개 저장소 [cashcall-team/momocall-plugins](https://github.com/cashcall-team/momocall-plugins)에서 설치 전에 직접 읽어 볼 수 있습니다. 변경 이력과 버전 태그도 그곳에 남습니다.

> [!WARNING]
> 스킬은 AI의 행동을 바꾸는 지시문이므로, 출처를 알 수 없는 스킬은 설치하지 마세요. 모모콜 스킬은 위 공식 저장소에서만 배포합니다. 다른 곳에서 받은 "모모콜 스킬"은 공식 파일이 아닙니다.

플러그인으로 설치했다면 스킬도 함께 설치되어 있습니다. 특정 버전에 고정하려면 태그를 지정해 마켓플레이스를 추가합니다.

```text
/plugin marketplace add cashcall-team/momocall-plugins@v1.0.0
/plugin install momocall@momocall-plugins
```

> [!AGENT]
> 사용자가 "모모콜 스킬 설치해줘"라고 하면 공식 저장소 `cashcall-team/momocall-plugins`에서만 설치하세요. 설치 전에 설치 위치를 알려 주고 확인을 받고, 같은 이름의 스킬이 이미 있으면 덮어쓰기 전에 물어보세요.

## Codex (CLI·IDE 확장)

Codex CLI와 IDE 확장은 같은 설정 파일(`~/.codex/config.toml`)을 씁니다.

```bash
codex mcp add momocall --url https://mcp.momocall.kr/mcp
```

```bash
codex mcp login momocall
```

1. 첫 명령으로 서버를 등록하고, 두 번째 명령으로 브라우저 로그인을 합니다.
2. 본인 확인과 항목 선택을 마치면 터미널에 로그인 완료가 표시됩니다.
3. `codex`를 실행해 질문합니다. `/mcp`로 연결 상태를 확인할 수 있습니다.

설정 파일에 직접 적어도 됩니다.

```toml
[mcp_servers.momocall]
url = "https://mcp.momocall.kr/mcp"
```

스킬은 공식 저장소를 내려받아 Codex 사용자 스킬 폴더(`~/.codex/skills`)에 복사합니다.

```bash
git clone --depth 1 https://github.com/cashcall-team/momocall-plugins.git
cp -R momocall-plugins/plugins/momocall/skills/* ~/.codex/skills/
```

## 그 밖의 AI 도구

Cursor, VS Code, Windsurf 등 **원격 MCP(Streamable HTTP)와 OAuth를 지원하는 도구**라면 같은 주소로 연결됩니다. 도구의 MCP 설정에 다음처럼 넣고, 처음 쓸 때 뜨는 로그인 창에서 본인 확인을 하세요.

```json
{
  "mcpServers": {
    "momocall": { "url": "https://mcp.momocall.kr/mcp" }
  }
}
```

> [!NOTE]
> API 키를 직접 넣는 방식은 지원하지 않습니다. 반드시 OAuth 로그인으로 연결됩니다. 브라우저를 열 수 없는 서버 환경에서는 쓸 수 없습니다.

## 연결 확인과 해제

- **연결 확인**: AI에게 "모모콜 연결 상태 알려줘"라고 물으면 허용한 항목, 남은 AI 검색 크레딧, 가장 최근 동기화된 통화 시각을 알려 줍니다.
- **연결 해제**: 연결한 AI 서비스의 커넥터·MCP 설정에서 모모콜을 삭제하세요(Claude Code는 `claude mcp remove momocall`, Codex는 `codex mcp remove momocall`). 모모콜 서버에 남은 연결 권한까지 바로 끊고 싶다면 고객센터(cs@sellking.kr)로 요청해 주세요. 앱 안의 연결 관리 화면은 준비 중입니다.
- **항목 바꾸기**: AI 서비스에서 모모콜 연결을 지운 뒤 다시 연결하면서 항목을 새로 고릅니다.

> [!LIMIT]
> - 앱 QR 승인은 3분, 연결 동의 화면은 10분 안에 끝내야 합니다. 시간이 지나면 AI 서비스에서 연결을 처음부터 다시 시작하세요.
> - 30일 동안 AI가 모모콜을 한 번도 읽지 않으면 연결이 만료됩니다. 다시 로그인하면 됩니다.
