도구 목록

세일즈맵 MCP 서버가 제공하는 19개 도구의 상세 스펙입니다.

AI 어시스턴트는 대화 맥락에 따라 적절한 도구를 자동으로 선택합니다. 이 문서는 어떤 도구가 있는지 이해하고, 원하는 작업이 가능한지 확인하는 용도입니다.

스키마 탐색

salesmap-list-properties

오브젝트의 필드 스키마(이름·유형·옵션)을 조회합니다.

파라미터	타입	필수	설명
objectType	enum	✅	deal lead people organization product quote todo custom-object

사용 예시: “딜 오브젝트에 어떤 필드가 있는지 알려줘”

---

레코드 검색

salesmap-search-objects

필터 조건으로 레코드를 검색합니다. 필터 그룹 간 OR, 그룹 내 필터 간 AND로 동작합니다.

파라미터	타입	필수	설명
objectType	enum	✅	people organization deal lead
filterGroups	array	✅	필터 그룹 배열 (최대 3개 그룹, 그룹당 최대 3개 필터)
after	string		페이지네이션 커서

필터 객체 구조:

필드	타입	설명
propertyName	string	필드 이름
operator	enum	비교 연산자 (아래 표 참조)
value	string | number | string[]	검색 값

지원 연산자 목록

연산자	설명
EQ	같음
NEQ	같지 않음
EXISTS	값 있음
NOT_EXISTS	값 없음
CONTAINS	포함
NOT_CONTAINS	포함하지 않음
LT / LTE	미만 / 이하
GT / GTE	초과 / 이상
IN / NOT_IN	목록에 포함 / 불포함
LIST_CONTAIN / LIST_NOT_CONTAIN	리스트 필드에 포함 / 불포함
DATE_ON_OR_AFTER	이후 날짜
DATE_ON_OR_BEFORE	이전 날짜
DATE_IS_SPECIFIC_DAY	특정 날짜
DATE_BETWEEN	날짜 범위
DATE_MORE_THAN_DAYS_AGO	N일 이전보다 오래됨
DATE_LESS_THAN_DAYS_AGO	N일 이내
DATE_LESS_THAN_DAYS_LATER	앞으로 N일 이내
DATE_MORE_THAN_DAYS_LATER	앞으로 N일 이후
DATE_AGO	N일 전
DATE_LATER	N일 후

사용 예시: “이번 달 생성된 딜 중 상태가 Won인 것 검색해줘”

---

레코드 CRUD

salesmap-batch-read-objects

여러 레코드를 한 번에 조회합니다 (최대 20개).

파라미터	타입	필수	설명
objectType	enum	✅	people organization deal lead custom-object product
objectIds	string[]	✅	레코드 ID 배열 (1~20개)
properties	string[]		반환할 필드 이름 목록. 생략 시 전체 필드 반환. 다건 조회 시 지정 권장.

salesmap-create-object

새 레코드를 생성합니다.

파라미터	타입	필수	설명
objectType	enum	✅	people organization deal lead custom-object product
properties	object		필드 key-value 예: { "이름": "홍길동", "금액": 50000 }
note	string		초기 메모
peopleId	string	조건부 필수	연결할 고객 ID
organizationId	string	조건부 필수	연결할 회사 ID
customObjectDefinitionId	string	조건부 필수	Definition ID (custom-object 필수)

딜/리드 생성 시 peopleId 또는 organizationId 중 하나 이상 필요합니다. 딜 생성 시 pipelineId, pipelineStageId는 salesmap_get_pipeline_ids로 확인하세요.

salesmap-update-object

기존 레코드를 수정합니다.

파라미터	타입	필수	설명
objectType	enum	✅	people organization deal lead custom-object
objectId	string	✅	레코드 ID
properties	object		변경할 필드 key-value
peopleId	string		연결 고객 변경
organizationId	string		연결 회사 변경

salesmap-delete-object

기존 레코드를 삭제합니다.

파라미터	타입	필수	설명
objectType	enum	✅	deal lead
objectId	string	✅	레코드 ID
comfirmed	boolean		false=미리보기, true=실제 삭제

---

관계 조회

salesmap-list-associations

레코드에 연결된 다른 레코드들을 조회합니다.

파라미터	타입	필수	설명
objectType	enum	✅	people organization deal lead custom-object note
objectId	string	✅	출발 레코드 ID
toObjectType	enum	✅	도착 레코드 ID

사용 예시: “이 회사에 연결된 딜 목록 보여줘”

활동 이력

salesmap-list-changelog

레코드의 필드 변경 이력을 조회합니다.

파라미터	타입	필수	설명
objectType	enum	✅	people organization deal lead
objectId	string	✅	레코드 ID
after	string		페이지네이션 커서

노트·견적서

salesmap-create-note

레코드에 메모(노트)를 추가합니다.

파라미터	타입	필수	설명
objectType	enum	✅	people organization deal lead custom-object
objectId	string	✅	대상 레코드 ID
note	string	✅	노트 내용

salesmap-get-quotes

딜/리드에 연결된 견적서 목록을 조회합니다.

파라미터	타입	필수	설명
obectType	enum	✅	deal lead
objectId	string	✅	딜/리드 ID

salesmap-create-quote

견적서를 생성합니다. dealId 또는 leadId 중 하나를 지정해야 합니다.

파라미터	타입	필수	설명
name	string	✅	견적서 이름
dealId	string	조건부 필수	연결할 딜 ID
leadId	string	조건부 필수	연결할 리드 ID
note	string		노트
isMainQuote	boolean		메인 견적서 여부
quoteProductList	array		상품 목록
properties	object		커스텀 필드

salesmap-list-engagements

레코드의 활동 타임라인을 조회합니다. (이메일·노트·TODO·웹폼·미팅 등)

파라미터	타입	필수	설명
objectType	enum	✅	people organization deal lead
objectId	string	✅	레코드 ID
after	string		페이지네이션 커서

파이프라인·분석

salesmap-get-pipelines

파이프라인 목록과 각 단계의 ID를 조회합니다. 딜·리드 생성/검색 시 필요합니다.

파라미터	타입	필수	설명
objectType	enum	✅	deal lead

salesmap-get-lead-time

딜/리드의 파이프라인 단계 별 체류 시간을 분석합니다.

파라미터	타입	필수	설명
objectType	enum	✅	deal lead
objectId	string	✅	레코드 ID

사용 예시: “이 딜이 각 단계에서 며칠씩 걸렸는지 분석해줘”

유틸리티

salesmap-get-link

레코드의 세일즈맵 웹 URL을 생성합니다.

파라미터	타입	필수	설명
objectType	enum	✅	people organization deal lead custom-object product quote
objectId	string	✅	레코드 ID

salesmap-list-users

CRM 사용자 목록을 조회합니다. 담당자 지정·변경 시 필요합니다.

파라미터	타입	필수	설명
after	string		페이지네이션 커서

salesmap-list-teams

팀 목록 + 소속 멤버를 조회합니다.

파라미터	타입	필수	설명
after	string		페이지네이션 커서

salesmap-get-user-details

현재 API 키 소유자의 정보를 조회합니다.

---

도구 권한

구분	도구 수	해당 도구
읽기	14개	list-properties, search-objects, batch-read-objects, list-associations, list-engagements, list-changelog, read-note, get-quotes, get-pipelines, get-lead-time, get-link, list-users, list-teams, get-user-details
쓰기	4개	create-object, update-object, create-note, create-quote
삭제	1개	delete-object