Claude + Crisphive MCP로 현장 작업을 위한 디스패칭 에이전트 구축하기

내용 소개: Claude를 실제(샌드박스) 현장 작업 일정에 연결하고, 자연어로 작업을 예약하며, P0 긴급 상황에 맞춰 전면 연쇄 재일정을 조율한 뒤, 프로덕션 강화 체크리스트로 마무리하는 단계별 튜토리얼입니다. 소요 시간: 약 15분. 비용: 없음 — 샌드박스는 무료이며, 신용카드가 필요 없고 MCP 호출 비용도 청구되지 않습니다.

튜토리얼을 마치면 다음과 같이 작동하는 어시스턴트를 갖추게 됩니다:

사용자: David Okafor(613-555-0198) 고객의 99 Bank St 긴급 배관 작업이 지금 들어왔습니다 — 재일정 조율되는 항목을 보여주세요.

Claude: 디스패치 도구를 호출하여 계획을 반환합니다 — 긴급 작업이 오후 1:15에 배치되고, 2개 작업이 새로운 예정 도착 시간(ETA)으로 이동하며, 1개 SLA가 아슬아슬한 것으로 표시됩니다. 아직 최종 확정되지는 않았습니다. 승인하시겠습니까?

이 대화 내용에서 중요한 점은 Claude가 하지 않은 일입니다. Claude는 계획을 지어내지 않았습니다. Claude는 요청의 의도를 해석할 뿐이며, Crisphive의 결정론적 제약 조건 솔버가 이동 시간, 기술, 자격증, 보장된 휴식 시간 및 SLA를 엄격한 제약 조건으로 적용하여 일정을 계산하고 승인을 위해 반환합니다. 동일한 입력에는 매번 동일한 일정이 산출됩니다. 이러한 역할 분담이 이 튜토리얼의 전체 아키텍처이므로, 시작하기 전에 다이어그램을 하나 살펴보는 것이 좋습니다:

사용자(자연어)
→ Claude(의도 해석, 도구 선택)
→ Crisphive MCP 서버 — https://api.crisphive.com/mcp (43개 도구)
→ REST API → 결정론적 제약 조건 솔버
← 검토 가능한 계획(이동된 작업, 새로운 ETA, SLA 영향)
← Claude가 계획 및 트레이드오프 설명
사용자 승인 → 일정 확정

준비 사항

• Claude 계정 — claude.ai, Claude Desktop, Claude Code 모두 지원되며, 커넥터 지원 여부는 요금제에 따라 달라집니다.

• Crisphive로 현장 작업 비즈니스를 운영 중인 경우: 추가로 필요한 것이 없습니다 — 비즈니스 소유자로 OAuth 로그인하시면 됩니다.

• Crisphive 비즈니스 계정이 없는 개발자의 경우: 무료 샌드박스 키가 필요합니다. 개발자 페이지에서 가입하고 chsk_test_ 키를 발급받으세요 — 동일한 기본 URL을 사용하는 격리된 테스트 환경입니다. 신용카드나 영업 전화는 필요 없습니다.

두 경우 모두 별도의 설치나 실행이 필요하지 않습니다. MCP 서버는 Streamable HTTP를 통해 호스팅되는 원격 서버입니다.

1단계 — Claude를 Crisphive에 연결하기

경로 A — 운영자용 (OAuth, 원클릭)

Claude 커넥터 디렉터리의 Crisphive 항목을 열고 '연결(Connect)'을 클릭합니다. Crisphive 비즈니스 소유자로 로그인하고 연결을 승인하라는 메시지가 표시됩니다. 설정은 이것으로 완료됩니다.

수동 설정을 선호하시나요? claude.ai 또는 Claude Desktop에서 Settings → Connectors → Add custom connector로 이동하여 https://api.crisphive.com/mcp 를 붙여넣고, 동의 화면이 열리면 OAuth 로그인을 완료하세요.

경로 B — 개발자용 (Claude Code + 샌드박스 키)

claude mcp add --transport http crisphive https://api.crisphive.com/mcp

실제 비즈니스 대신 격리된 샌드박스에 세션을 고정하려면 테스트 키를 첨부하세요:

claude mcp add --transport http crisphive https://api.crisphive.com/mcp --header "Authorization: Bearer chsk_test_YOUR_KEY"

Cursor, VS Code, Windsurf, Cline, Zed, LM Studio, Gemini CLI 등 다른 MCP 클라이언트도 동일한 URL을 사용하며, 전체 클라이언트 목록은 GitHub README에서 확인할 수 있습니다. stdio만 지원하는 클라이언트는 mcp-remote로 브리지할 수 있습니다.

체크포인트: Claude에게 "어떤 Crisphive 도구를 사용할 수 있나요?"라고 물어보세요 — 작업 예약 및 약속, 작업 지시서 추적, 디스패치 및 가용성, 고객(CRM) 동기화, 서비스 카탈로그, 팀 및 명단, 서비스 지역, 차량 fleet 등 8개 그룹에 걸친 43개 도구가 표시되어야 합니다.

2단계 — 일정 확인해 보기

디렉터리 목록에 있는 3가지 프롬프트로 시작해 보세요 — Crisphive가 이 커넥터를 설명하는 모든 문서에서 제공하는 동일한 프롬프트입니다.

먼저 다음 항목을 시도해 보세요:

1. 내일 Marie Tremblay(613-555-0142) 고객을 위해 145 Laurier Ave W 주소로 2시간 소요되는 HVAC 작업을 예약해 주세요.

2. David Okafor(613-555-0198) 고객의 99 Bank St 긴급 배관 작업이 지금 들어왔습니다 — 재일정 조율되는 항목을 보여주세요.

3. 내일 일정을 정리해 주고 리스크가 있는 항목을 표시해 주세요.

3번 프롬프트를 먼저 실행해 보세요 — 읽기 전용이므로 연결이 정상적으로 완료되었는지 안전하게 확인하기에 좋습니다.

예상 결과: Claude가 디스패치 및 가용성 도구와 작업 지시서 도구를 호출한 후, 내일 일정을 시간순 타임라인으로 반환합니다 — 작업 간 이동 구간, 작업별 여유 시간, 리스크 요소(촉박한 이동 시간, 지연 가능성이 높은 작업)가 표시됩니다. 현황판의 어떤 작업도 이동하지 않으며, 읽기 프롬프트는 데이터를 변경하지 않습니다.

3단계 — 자연어로 작업 예약하기

이제 1번 프롬프트를 실행합니다:

내일 Marie Tremblay(613-555-0142) 고객을 위해 145 Laurier Ave W 주소로 2시간 소요되는 HVAC 작업을 예약해 주세요.

호출되는 도구: 작업 예약 및 약속, 고객 동기화(올바른 계정에 예약이 배정되도록 함), 디스패치 및 가용성(실제로 작업을 맡을 수 있는 인원 확인).

예상 결과: 배치 근거(어떤 작업자인지, 해당 작업자인 이유 — 기술, 자격증, 근접성, 기존 경로 — 및 정확한 시간대)가 포함된 작업 예약 결과가 생성됩니다. 제약 조건 엔진의 계산을 더 까다롭게 테스트하고 싶다면 요청을 다음과 같이 구체화해 보세요:

동일한 작업이지만 가스 설비 자격증이 있는 작업자만 배정하고, 누구의 하루 이동 시간도 20분 이상 늘어나지 않아야 합니다.

솔버는 이러한 조건을 제안이 아닌 엄격한 제약 조건(hard constraint)으로 처리합니다. 조건을 충족하는 사람이 없으면 추측 대신 제한 요소가 무엇인지 명시된 "실행 가능한 시간 슬롯 없음" 응답을 정확하게 반환합니다.

4단계 — P0 긴급 상황 수용하기 (연쇄 재일정 조율)

이 단계야말로 단순한 캘린더 챗봇과 디스패칭 에이전트를 구분 짓는 핵심입니다. 누수관이 터진 긴급 상황에서는 몇 시가 편한지 물어볼 여유가 없습니다 — 하루 일정이 진행 중일 때 어떻게 작업자의 일정을 자동으로 재조율할 수 있을까요?

David Okafor(613-555-0198) 고객의 99 Bank St 긴급 배관 작업이 지금 들어왔습니다 — 재일정 조율되는 항목을 보여주세요.

호출되는 도구: 디스패치 및 가용성, 작업 예약, 작업 지시서 도구 — 그리고 솔버가 연쇄 재일정 조율(cascade reschedule)을 실행합니다. 긴급 작업 삽입으로 영향을 받는 모든 하위 작업을 재계획하며, 이동 시간, 준비 작업, 자재 수급, 보장된 휴식 시간, SLA 시간대를 모두 엄격한 제약 조건으로 유지합니다. 전체 연쇄 계산은 3초 미만으로 완료됩니다(이러한 제약 조건이 활성화된 20개 장소, 3대 차량 fleet 시뮬레이션 기준).

예상 결과 — 그리고 이 점이 중요합니다 — 변경이 아닌 '계획'이 반환됩니다. Claude는 긴급 작업이 배치되는 위치, 이동되는 모든 작업, 각각의 새로운 ETA, 전체 SLA 영향을 포함한 이중 계획을 제시합니다. 승인하기 전까지는 아무것도 확정되지 않습니다. 이 서버의 모든 상태 변경 흐름은 설계상 미리보기/확정(preview/commit) 쌍으로 작동합니다. 실제 디스패치 현황판을 임의로 변경할 수 있는 에이전트는 기능이 아니라 장애 요소입니다.

승인한 뒤 다음과 같이 물어보세요:

오후 2시 온수기 작업은 이동되었는데 오후 3시 점검 작업은 왜 이동되지 않았나요?

Claude는 모델의 상상이 아닌 솔버의 실제 출력 결과를 바탕으로 — 결합된 제약 조건, 존재했던 여유 시간 등 — 사유를 설명합니다.

5단계 — 환경에 맞게 커스텀하기

기본 에이전트를 확장할 수 있는 3가지 방향입니다. 각 방향은 프롬프트 하나로 실행할 수 있습니다:

• 가용 시간 탐색: "어떤 작업도 리스크에 노출시키지 않으면서 아내와 자전거를 탈 수 있는 3시간의 여유 시간을 주간 근무 시간 중에서 찾아주세요." — 일정의 여유 시간을 기준으로 빈 시간대의 순위를 매기며, 기존 일정은 이동하지 않습니다.

• 기술 및 이동 거리 매칭: "목요일 오전에 Kanata에서 20분 거리 내에 있는 가스 설비 자격증 보유 작업자 중 작업이 가능한 사람은 누구인가요?"

• 관리자 브리핑: "내일 전체 팀의 일정을 일상적인 언어로 요약해 주세요. 리스크가 어디에 있는지, 과도하게 일정이 잡힌 곳이 있는지 알려주세요."

동일한 43개 도구가 디스패처, 개발자, 비즈니스 소유자 모두에게 제공되며, 차이점은 어떤 어조로 질문하는가뿐입니다. Claude용 MCP 페이지에서 세 가지 어조의 복사 가능한 프롬프트 라이브러리를 확인할 수 있습니다.

대화창 대신 소프트웨어 형태로 직접 구현하고 싶으신가요? 동일한 엔진이 REST API로도 제공됩니다 — docs.crisphive.com에서 시작하시거나, MCP와 직접 API 적용 중 적합한 선택 방식을 비교해 둔 통합 경로 비교 가이드를 참고하세요.

6단계 — 프로덕션 강화 체크리스트

샌드박스 단계를 벗어나기 전에 확인하세요:

1. 키 만료 주기 — 기본 만료 기간은 30일이며, 만료 알림 이메일은 개발자가 아닌 비즈니스 소유자에게 발송됩니다. 프로덕션 에이전트의 경우 365일 키를 발급하고 2개 키 교체 방식을 운영하세요: 키 B 발급 → 배포 → 키 B 트래픽 확인 → 키 A 폐기. 에이전시의 에이전트가 출시 한 달 만에 API_KEY_EXPIRED로 작동을 멈추는 것은 단순 버그가 아니라 고객 이탈로 이어지는 심각한 사안입니다.

2. 사용자에게는 OAuth를, 서비스에는 API 키를 우선 적용하세요. OAuth 토큰은 Claude 커넥터 설정이나 Crisphive 계정 등 양쪽 모두에서 취소할 수 있으며, 키가 대화창에 노출되지 않습니다.

3. 미리보기/확정 기능을 켜두세요. "클릭 횟수를 줄이기 위해" 연쇄 재조율을 자동 승인하고 싶은 유혹을 피하세요 — 승인 단계가 존재해야 내일 일정을 수동으로 조정할 디스패처가 에이전트의 동작을 감사하고 검증할 수 있습니다.

4. 권한 범위 점검: 커넥터는 일정 관련 데이터(작업, 작업 지시서, 고객, 팀, 카탈로그, 지역, fleet)만 조회할 수 있습니다. 청구 및 결제 데이터는 노출되지 않습니다. 하위 시스템에 구축하는 모든 항목에서도 이 규칙이 유지되는지 확인하세요.

5. 샌드박스에서 예외 케이스(unhappy path)를 먼저 테스트하세요: 불가능한 작업(자격 있는 작업자 없음), SLA를 위반하는 연쇄 재조율, 세션 도중 취소된 토큰 등. 사용자에게 기억되는 것은 에이전트의 에러 처리 능력입니다.

자주 묻는 질문

이 기능을 테스트하려면 Crisphive 비즈니스 계정이 필요한가요?

아닙니다 — 무료 chsk_test_ 샌드박스는 동일한 기본 URL에서 제공되는 격리된 테스트 환경이며 신용카드가 필요하지 않습니다. OAuth 로그인은 실제 비즈니스를 소유자로 연결할 때 사용됩니다.

Claude가 직접 일정을 계획하나요?

아닙니다 — 그리고 이것이 핵심입니다. Claude는 요청 내용을 해석할 뿐이며, 모든 예약, 연쇄 재조율 및 일정 변경은 Crisphive의 결정론적 제약 조건 솔버에 의해 계산됩니다. 같은 질문을 두 번 하면 매번 동일한 계획을 얻게 됩니다.

에이전트가 제 확인 없이 실제 일정을 변경할 수 있나요?

없습니다. 기존 작업을 이동하는 모든 조작은 검토 가능한 계획(이동된 작업, 새로운 ETA, SLA 영향)으로 반환되며, 사용자가 승인한 후에만 확정됩니다.

MCP 서버 이용 시 추가 비용이 드나요?

아닙니다. MCP 액세스는 모든 비즈니스 요금제 및 무료 개발자 샌드박스에 포함되어 있습니다 — MCP 호출, 연쇄 재조율, 일정 재조율 및 조회 작업은 비용이 청구되지 않으며, 실제 진행 중인 작업 수에 대해서만 청구됩니다.

Claude 외에 어떤 클라이언트를 사용할 수 있나요?

Streamable HTTP를 통한 원격 MCP 서버를 지원하는 모든 클라이언트(ChatGPT, Gemini CLI, Cursor, VS Code, Windsurf, Cline, Zed, LM Studio 등)에서 사용할 수 있습니다. stdio 전용 클라이언트는 mcp-remote로 연결할 수 있습니다.

현장 작업 팀을 운영 중이며 지난 화요일 일정에 이 엔진을 적용했을 때 어떤 결과가 나왔을지 확인해 보고 싶으신가요? 무료 섀도 일정 감사(Shadow Schedule Audit) 신청하기 — 최근 하루 치의 작업 데이터를 보내주시면 48시간 이내에 단축 가능한 이동 시간과 확보 가능한 가용 용량을 분석해 드립니다.