CRM Connect

특정 CRM 전용 스킬이 아니라 어떤 CRM이든 API로 연결하는 방법론. 한 번 연결하면 프로젝트에 "연결 카드"를 남겨 다음 세션부터 재사용한다.

Gates (처음 연결할 때, 순서대로)

G1 — CRM 식별. 유저에게 묻는다: 어떤 CRM? 어떤 작업(리드 입력/딜 관리/리포트)? 그 CRM의 공식 API 문서를 찾는다 (웹 검색 또는 문서 도구). 문서 없이 엔드포인트를 추측하지 않는다.

G2 — 인증. 우선순위: API 키 > Personal Access Token > OAuth2(에이전트에겐 최후 수단). 키는 env 변수로만 (HUBSPOT_API_KEY, PIPEDRIVE_API_TOKEN 등 CRM별 이름). 파일/채팅에 키 값 기록 금지. 유저가 키 발급 위치를 모르면 해당 CRM의 Settings → API/Integrations 경로를 안내.

G3 — 최소 읽기로 검증. 가장 싼 read 호출(연락처 1건 목록 등)이 200을 반환하는지 확인. 실패 시 인증 방식(헤더 vs Basic vs query param)부터 재확인 — CRM마다 다르다.