# MCP (Beta)

## MCP 소개

세일즈맵 MCP를 사용하면 AI 어시스턴트가 세일즈맵 CRM 데이터를 직접 조회하고 관리할 수 있습니다.

### MCP란?

MCP(Model Context Protocol)는 AI 모델이 외부 서비스의 기능을 표준화된 함수 형태로 호출할 수 있게 해주는 프로토콜입니다.

기존에는 AI가 외부 서비스와 연동하려면 각 서비스의 REST API 엔드포인트, 인증 방식, 요청 포맷 등을 개별적으로 구성해야 했습니다. MCP는 이러한 복잡성을 MCP 서버가 내부적으로 처리하고, AI에게는 통일된 도구 호출 인터페이스만 노출합니다.

세일즈맵 MCP 서버를 연결하면, 별도의 API 연동 작업 없이 AI와 대화만으로 CRM 작업을 수행할 수 있습니다.

### 무엇을 할 수 있나요?

| 기능           | 예시                             |
| ------------ | ------------------------------ |
| **데이터 조회**   | ”이번 달 신규 딜 목록 보여줘”             |
| **레코드 생성**   | ”홍길동 고객 정보 등록해줘”               |
| **레코드 수정**   | ”A 딜 상태를 Won으로 변경해줘”           |
| **검색 및 분석**  | ”지난 분기 Lost된 딜 중 금액 상위 5개 찾아줘” |
| **견적서 관리**   | ”이 딜에 견적서 만들어줘”                |
| **파이프라인 분석** | ”이 딜이 각 단계에서 며칠씩 머물렀는지 알려줘”    |

### 동작 방식

```
사용자 ↔ AI 클라이언트 ↔ 세일즈맵 MCP 서버 ↔ 세일즈맵 API
```

1. AI 클라이언트(Claude Desktop, Cursor 등)에서 세일즈맵 MCP 서버를 연결합니다
2. 자연어로 요청하면 AI가 적절한 도구를 선택하여 실행합니다
3. 세일즈맵 API를 통해 실제 CRM 데이터를 조회/생성/수정합니다

**모든 요청은 사용자 본인의 API 토큰으로 처리되며**, 서버는 토큰을 저장하지 않습니다. 기존 세일즈맵 권한 체계가 그대로 적용됩니다.

### 지원 AI 클라이언트

현재 MCP를 지원하는 주요 AI 클라이언트:

* **Claude Desktop** (권장) — Anthropic의 공식 데스크톱 앱
* **Claude Code** — Anthropic의 CLI 도구
* **Cursor** — AI 코드 에디터
* 기타 MCP 프로토콜을 지원하는 클라이언트

> 이 가이드에서는 Claude Desktop 기준으로 설명합니다.

### 제공 도구 (16개)

| 카테고리   | 도구 수 | 설명                          |
| ------ | ---- | --------------------------- |
| 스키마 탐색 | 1개   | CRM 필드 구조 조회                |
| 검색     | 1개   | 조건 기반 레코드 검색                |
| CRUD   | 4개   | 레코드 조회·생성·수정                |
| 지원 도구  | 10개  | 연관관계, 메모, 견적서, 파이프라인, 사용자 등 |

자세한 내용은 도구 레퍼런스에서 확인하세요.


---

# 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://docs.salesmap.kr/developers/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.