Install
npx -y @ckalima/pipedrive-mcp-server init누구에게 맞나
Claude Code 또는 Claude Desktop에서 Pipedrive CRM 데이터를 직접 조회, 생성, 갱신하려면 이 서비스가 맞다. 로컬 또는 자체 호스팅용 MCP 서버이며 인증은 Pipedrive API 키다.
이미 Pipedrive 계정과 API 키가 있고 클라이언트가 STDIO MCP를 실행할 수 있는 사람에게 맞다. 공식은 현재 전송이 STDIO뿐이고 호스팅 OAuth는 없다고 적었다. 원격 HTTP 접속이나 OAuth 로그인이 필요하면 이 페이지에 쓸 경로가 없다.
패키지 이름은 스코프가 있는 @ckalima/pipedrive-mcp-server여야 한다. 공식은 분명히 말한다. 옛 조각이 스코프 없는 pipedrive-mcp-server를 인용하면 그것은 다른 무관 패키지니 잘못 설치하지 말 것.
3분 만에 첫 시도 끝내기
공식 권장 경로는 안내형 설치다. 전제: Pipedrive API 키를 준비하고, 클라이언트는 Claude Code 또는 Claude Desktop, 전송은 STDIO만.
터미널에서 실행한다:
npx -y @ckalima/pipedrive-mcp-server init
안내에 따라 서버를 클라이언트 설정에 쓴다. 설정을 손으로 고쳐야 하면 명령은 npx, 인수는 -y와 @ckalima/pipedrive-mcp-server이며 환경 변수에 PIPEDRIVE_API_KEY를 둔다. 예시 키 문자열을 쓰지 말고 스코프 없는 패키지 이름도 쓰지 말 것.
첫 시도는 PIPEDRIVE_MODE를 read-only로 둔다. 공식은 이 등급을 읽기 전용으로 정의한다. 기본 등급 safe-write는 이미 비파괴 쓰기를 포함하므로 첫 시도에 맞지 않다.
그다음 저위험 호출을 한 번 한다. CRM 데이터를 조회한다. 공식은 도우미에서 Query, create, and update CRM data를 할 수 있다고 적었다. 첫 시도는 Query만. 공식은 구체 도구 이름이나 객체 유형을 주지 않았다. 클라이언트가 이 서버에 대해 나열한 조회류 도구만 쓴다. 나타나지 않은 도구 이름을 만들지 말고 레코드를 생성하거나 갱신하지 말 것.
성공 신호: Pipedrive에 이미 있는 레코드의 조회 결과가 돌아오고 쓰기는 없다. 현재 등급에서 쓰기류 도구가 보이지 않으면 공식과 같다. 등급 밖 도구는 숨겨지고 직접 호출도 거부된다.
사용 사례
사례 1: 읽기 전용 CRM 조회. PIPEDRIVE_MODE를 read-only로 두고 기존 데이터를 조회한다. 공식은 Query CRM data까지만 썼고 어떤 객체, 필터, 페이지 나누기는 쓰지 않았다. 성공 시 기존 레코드가 보여야 한다. 한 번 조회를 완전한 데이터 내보내기로 보지 말 것.
사례 2: 기본 safe-write 등급에서 레코드를 생성하거나 갱신한다. 공식은 기본 등급이 읽기와 비파괴 쓰기이며 create와 update에 해당한다고 적었다. 이는 CRM을 바꾼다. 호출 전에 바꿀 업무 데이터가 무엇인지 확인한다. 공식은 필드 목록이나 예시 페이로드를 주지 않았다. 클라이언트가 보여 주는 생성 또는 갱신 능력만 쓰고, 실행 전에 쓸 내용을 다시 말한다. 삭제, 변환, 기타 되돌릴 수 없는 쓰기는 이 등급에 없다. 공식은 full 등급에서만 연다고 한다.
사용 경계
PIPEDRIVE_MODE는 read-only, safe-write(기본), full이 있다. 등급 밖 도구는 도구 목록에 나오지 않고 직접 호출도 거부된다. Deletes, conversions 및 기타 irreversible writes는 full이 필요하다. 첫 시도에서 이 등급을 열지 말 것.
전송은 현재 STDIO만. Streamable HTTP는 계획 중인 표시일 뿐이며 이 페이지에서 이미 제공된 것으로 볼 수 없다. 인증은 Pipedrive API 키이며 호스팅 OAuth는 없다. 키는 로컬 환경 변수에 있고 조회와 쓰기 모두 네트워크로 나가 Pipedrive에 닿는다.
공식은 속도 제한도 철회도 쓰지 않았다. 쓰기가 성공하면 Pipedrive에서 직접 되돌려야 한다. 패키지 이름을 스코프 없는 pipedrive-mcp-server로 잘못 쓰면 공식은 다른 무관 패키지라고 한다.