도구 목록
세일즈맵 MCP 서버가 제공하는 29개 도구의 상세 스펙입니다.
AI는 대화 맥락에 따라 적절한 도구를 자동으로 선택합니다. 이 문서는 어떤 도구가 있는지 이해하고, 원하는 작업이 가능한지 확인하는 용도입니다.
스키마 탐색
salesmap-list-objects
오브젝트 목록을 조회합니다. 기본 오브젝트(고객·회사·리드·딜·상품·견적서)와 커스텀 오브젝트 모두를 포함합니다.
사용 예시: "우리 워크스페이스에 어떤 커스텀 오브젝트가 있어?"
salesmap-list-properties
오브젝트의 필드 스키마(이름·유형·옵션)를 조회합니다.
objectType
enum
✅
deal lead people organization product quote quote-product todo custom-object
사용 예시: "딜 오브젝트에 어떤 필드가 있는지 알려줘"
salesmap-list-associations
오브젝트에 어떤 연결 관계가 있는지 스키마를 조회합니다. salesmap-batch-read-objects의 associationList에 넣을 관계명을 확인하는 용도입니다.
objectType
string
✅
deal lead people organization 또는 커스텀 오브젝트 이름 (예: 티켓)
사용 예시: "딜에는 어떤 오브젝트를 연결할 수 있어?"
salesmap-create-property
필드를 생성합니다.
objectType
enum
✅
people organization deal lead product quote quote-product todo custom-object
name
string
✅
필드 이름
type
enum
✅
string number date dateTime boolean singleSelect multiSelect multiAttachment user multiUser
customObjectDefinitionName
string
조건부 필수
objectType이 custom-object일 때 대상 커스텀 오브젝트 이름 (ID 대신 사용 가능)
customObjectDefinitionId
string
조건부 필수
objectType이 custom-object일 때 대상 커스텀 오브젝트 ID
options
array
조건부 필수
type이 singleSelect(1개 이상)·multiSelect(2개 이상)일 때의 선택지 목록
description
string
필드 설명
preventDuplicates
boolean
같은 값이 중복 등록되지 않도록 막는 유니크 필드로 설정 (기본 false)
required
boolean
생성 모달 UI에서 입력 강제 여부 (기본 false)
showInCreateForm
boolean
생성 모달 UI에 표시 여부 (기본 false)
formula
string
계산 수식. 입력 시 계산 유형 필드가 되며 type은 계산 결과의 타입이 됨
사용 예시: "티켓 오브젝트에 중요도 필드 추가해줘"
레코드 검색
salesmap-search-objects
필터 조건으로 레코드를 검색합니다. 필터 그룹 간 OR, 그룹 내 필터 간 AND로 동작합니다. 결과는 id·name만 반환하며, 상세 필드는 salesmap-batch-read-objects로 이어서 조회합니다.
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인 것 검색해줘"
레코드 목록 조회
웹 폼, 시퀀스, 상품 목록 조회만 지원합니다.
고객, 회사, 리드, 딜 등 조회는 salesmap-search-objects를 사용합니다.
salesmap-list-webforms
웹 폼 목록을 조회합니다.
after
string (optional)
페이지네이션 커서
salesmap-list-sequences
시퀀스 목록을 조회합니다.
after
string (optional)
페이지네이션 커서
salesmap-list-products
상품 목록을 조회합니다.
after
string (optional)
페이지네이션 커서
레코드 CRUD
salesmap-batch-read-objects
여러 레코드를 한 번에 조회합니다 (최대 500개). 연결된 레코드도 함께 인라인으로 받을 수 있습니다.
objectType
string
✅
people organization deal lead 또는 커스텀 오브젝트 이름 (예: 티켓)
objectIds
string[]
✅
레코드 ID 배열 (1~500개)
fieldList
string[]
반환할 필드 이름 목록 (한글). 생략 시 전체 필드 반환
associationList
string[]
인라인으로 포함할 연결 관계명 목록. 관계명은 salesmap-list-associations로 확인
고객·회사 연결 같은 관계형 필드는 fieldList가 아닌 associationList로 조회합니다.
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
customObjectDefinitionName
string
조건부 필수
커스텀 오브젝트 이름 (custom-object일 때, ID 대신 사용 가능)
customObjectDefinitionId
string
조건부 필수
커스텀 오브젝트 Definition ID (custom-object일 때, 이름과 둘 중 하나만)
딜/리드 생성 시 peopleId 또는 organizationId 중 하나 이상 필요합니다.
딜 생성 시 pipelineId, pipelineStageId는 salesmap-get-pipelines로 확인하세요.
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
confirmed
boolean
false=미리보기, true=실제 삭제
활동 이력
salesmap-list-engagements
레코드의 활동 타임라인을 조회합니다. 활동 유형별로 독립된 목록과 커서를 반환합니다.
objectType
string
✅
people organization deal lead 또는 커스텀 오브젝트 이름
objectId
string
✅
레코드 ID
types
enum[]
조회할 활동 유형. todo note recording meeting email alimtalk sms (생략 시 전체)
limit
number
유형별 반환 건수 (1~50, 기본 5)
after
string
페이지네이션 커서 (types로 유형을 한정한 뒤 사용)
사용 예시: "이 고객과 주고받은 이메일 이력 보여줘"
salesmap-list-changelog
레코드의 필드 변경 이력을 조회합니다 (누가·언제·무엇을 바꿨는지).
objectType
enum
✅
people organization deal lead
objectId
string
✅
레코드 ID
after
string
페이지네이션 커서
노트·견적서
salesmap-list-notes
노트 목록을 조회합니다. 담당자·유형·날짜·연결 레코드 기준으로 필터할 수 있습니다.
startDate
string
작성일 시작 (예: 2026-01-01)
endDate
string
작성일 종료 (예: 2026-06-30)
owner
string
작성한 담당자 (사용자 이름 또는 userId)
type
string
노트 유형 이름 (예: 미팅, 콜)
leadId
string
연결된 리드 ID
dealId
string
연결된 딜 ID
peopleId
string
연결된 고객 ID
organizationId
string
연결된 회사 ID
after
string
페이지네이션 커서
사용 예시: "이번 주에 작성된 미팅 노트 모아줘"
salesmap-read-note
노트(메모)의 상세 내용을 조회합니다.
noteId
string
✅
노트 UUID
salesmap-create-note
레코드에 노트(메모)를 추가합니다.
objectType
enum
✅
people organization deal lead custom-object
objectId
string
✅
대상 레코드 ID
note
string
✅
노트 내용
salesmap-get-quotes
딜/리드에 연결된 견적서 목록을 조회합니다.
objectType
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-get-pipelines
파이프라인 목록과 각 단계의 ID를 조회합니다. 딜·리드 생성/검색 시 필요합니다.
objectType
string
✅
deal lead 또는 커스텀 오브젝트 이름 (예: 티켓)
salesmap-get-lead-time
딜/리드의 파이프라인 단계 별 체류 시간을 분석합니다.
objectType
enum
✅
deal lead
objectId
string
✅
레코드 ID
사용 예시: "이 딜이 각 단계에서 며칠씩 걸렸는지 분석해줘"
서버 스크립트
salesmap-run-script
AI가 작성한 JavaScript를 세일즈맵 서버에서 직접 실행합니다. 수백 건 레코드를 순회·집계하는 대량 작업을 도구 여러 번 호출 없이 단일 호출로 처리합니다 (최대 50초).
script
string
✅
실행할 JavaScript 코드. salesmap.get/post/getAll로 세일즈맵 API 호출
사용 예시: "전체 딜을 담당자별로 집계해서 합계 금액 알려줘"
단건 조회·생성 같은 일반 작업엔 전용 도구가 자동 선택되고, run-script는 대량 순회·집계가 필요할 때만 사용됩니다.
유틸리티
salesmap-get-guide
세일즈맵 MCP 사용 가이드를 조회합니다. 오브젝트 모델·시나리오별 도구 조합·필드 입력 규칙·계산 수식 문법이 담겨 있어, AI가 세일즈맵 구조를 이해하는 데 사용합니다.
salesmap-get-api-ref
세일즈맵 REST API 레퍼런스 전문을 조회합니다. 주로 salesmap-run-script 작성 전에 AI가 엔드포인트·요청 형식을 확인하는 용도입니다.
salesmap-report-feedback
세일즈맵 MCP의 버그·부족한 기능·개선 요청을 개발팀에 전달합니다.
category
enum
✅
bug missing-tool tool-limitation friction feature-request
summary
string
✅
한 줄 요약
detail
string
✅
무엇을 하려 했고 왜 막혔는지
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 키 소유자의 정보를 조회합니다.
도구 권한
읽기
21개
list-objects, list-properties, list-associations, search-objects, batch-read-objects, list-engagements, list-changelog, list-notes, read-note, get-quotes, get-pipelines, get-lead-time, get-link, list-users, list-teams, get-user-details, get-guide, get-api-ref, list-products, list-sequences, list-webforms
쓰기
7개
create-property, create-object, update-object, create-note, create-quote, run-script, report-feedback
삭제
1개
delete-object
모든 도구는 API 토큰 소유자의 권한 범위 안에서만 동작합니다. 읽기 전용 사용자의 토큰으로는 쓰기·삭제 도구를 사용할 수 없습니다.
Last updated
Was this helpful?