Claude + Crisphive MCP로 현장 운영 AI 배차 에이전트 구축하기

개요: Claude를 실시간(샌드박스) 현장 운영 스케줄에 연결하고, 자연어로 작업을 예약하며, 전체 연쇄 재스케줄링을 통해 P0 긴급 상황을 처리한 뒤, 운영 환경 적용 체크리스트로 마무리하는 단계별 튜토리얼입니다. 소요 시간: 약 15분. 비용: 무료(샌드박스는 신용카드가 필요 없으며, MCP 호출은 과금되지 않습니다).

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

사용자: David Okafor(613-555-0198) 고객님의 99 Bank St 배관 긴급 작업 지금 추가해줘. 스케줄 변경 사항 보여줘.

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

이 대화 내용에서 중요한 점은 Claude가 하지 않은 일입니다. 바로 계획을 지어내지 않았다는 것입니다. Claude는 요청을 해석할 뿐이며, 스케줄 계산은 Crisphive의 확정적 제약 조건 해석기(deterministic constraint solver)가 수행합니다. 이동 시간, 보유 기술, 자격증, 보장된 휴식 시간, 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 사업자 계정이 없는 개발자의 경우: 무료 샌드박스 키. 개발자 페이지에서 가입하고 동일한 베이스 URL을 바라보는 격리된 테스트 환경용 chsk_test_ 키를 발급받으세요. 신용카드가 필요 없으며 영업 전화도 없습니다.

두 경우 모두 로컬에 설치하거나 실행할 프로그램이 없습니다. 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) 동기화, 서비스 카탈로그, 작업 팀 및 명부, 서비스 구역, 차량 관리 등 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분 이상 늘어나지 않게 해줘.

해석기는 이 조건들을 단순 권장 사항이 아닌 엄격한 제약 조건으로 처리합니다. 조건에 맞는 작업자가 없다면 임의로 추측하지 않고, 제약 요인을 명시하며 배정 가능한 시간대가 없음을 정확히 안내합니다.

4단계 — P0 긴급 상황 대응하기(연쇄 재스케줄링)

이 단계는 단순한 달력 연동 챗봇과 배차 에이전트의 차이를 명확히 보여줍니다. 갑작스러운 누수 사고는 일정을 물어보고 발생하지 않습니다. 하루 일정이 진행 중인 상황에서 긴급 작업이 들어왔을 때 어떻게 자동으로 작업을 재배치할 수 있을까요?

David Okafor(613-555-0198) 고객의 99 Bank St 위치 배관 긴급 작업 지금 추가해줘. 스케줄 변경 사항 보여줘.

호출되는 도구: 배차 및 이동 가능 시간, 작업 예약, 작업 지시서 도구가 연동되며 해석기가 연쇄 재스케줄링을 실행합니다. 긴급 작업 삽입으로 영향을 받는 모든 후속 작업에 대해 이동 시간, 준비 작업, 자재 수급, 보장된 휴식 시간, SLA 준수 여부를 엄격한 제약 조건으로 반영하여 재계산합니다. 해당 제약 조건이 활성화된 차량 3대, 20개 장소 규모의 시뮬레이션에서 전체 연쇄 계산은 3초 미만으로 완료됩니다.

예상 결과(가장 중요한 부분): 즉시 변경되는 것이 아니라 검토용 계획이 제시됩니다. Claude는 긴급 작업이 배치되는 위치, 이동하는 모든 작업, 변경된 ETA, 전체 SLA 영향을 포함한 전체안을 제시합니다. 사용자가 승인하기 전까지는 실제 반영되지 않습니다. 이 서버의 모든 상태 변경 작업은 사전 검토 및 승인 구조로 설계되어 있습니다. 실제 배차판을 사전에 알리지 않고 임의로 변경하는 에이전트는 기능이 아니라 장애 요인입니다.

승인한 뒤 다음과 같이 질문해보세요.

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

Claude는 모델의 추측이 아닌 해석기의 실제 계산 결과(적용된 제약 조건, 존재했던 여유 시간)를 바탕으로 이유를 설명합니다.

5단계 — 맞춤형으로 활용하기

프롬프트 입력만으로 기본 에이전트를 확장할 수 있는 3가지 활용법입니다.

• 여유 시간 탐색: "이번 주 업무 시간 중 기존 작업에 영향을 주지 않고 아내와 자전거를 탈 수 있는 3시간의 여유 시간을 찾아줘." — 스케줄 여유도(slack)에 따라 빈 시간대의 순위를 매기며, 실제 스케줄은 이동하지 않습니다.

• 기술 및 이동 거리 매칭: "가스 설비 자격증이 있는 작업자 중 목요일 오전에 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, 서비스는 키 방식 권장. OAuth 토큰은 Claude 커넥터 설정이나 Crisphive 계정 양쪽에서 모두 취소할 수 있으며, 채팅 창에 API 키가 노출되지 않습니다.

3. 미리보기/확정(preview/commit) 단계 유지. "클릭 횟수를 줄이기 위해" 연쇄 변경을 자동 승인하려는 유혹을 견디세요. 승인 단계가 있어야 이튿날 스케줄을 수동 조정하는 배차 담당자가 에이전트의 작업 내역을 추적하고 감사할 수 있습니다.

4. 권한 범위 확인. 커넥터는 스케줄링 관련 데이터(작업, 작업 지시서, 고객, 작업 팀, 서비스 카탈로그, 구역, 차량)만 조회할 수 있습니다. 청구 및 결제 데이터는 노출되지 않습니다. 하위 시스템을 구축할 때도 이 원칙이 유지되는지 확인하세요.

5. 예외 상황(Unhappy path)을 샌드박스에서 먼저 테스트. 수행 불가능한 작업(자격 보유자 없음), SLA를 위배하는 연쇄 재스케줄링, 세션 중 토큰 취소 등의 상황을 검증하세요. 에이전트의 예외 처리 성능이 곧 사용자 경험을 결정합니다.

자주 묻는 질문

이 기능을 테스트하려면 Crisphive 사업자 계정이 필요한가요?

아니요. 무료 chsk_test_ 샌드박스는 동일한 베이스 URL을 기반으로 한 격리된 테스트 환경이며 신용카드가 필요하지 않습니다. OAuth 로그인은 실제 사업체와 연결할 때 사업주 권한으로 진행하는 방식입니다.

Claude가 직접 스케줄링을 계산하나요?

아니요, 그리고 그것이 핵심입니다. Claude는 요청을 해석할 뿐이며, 모든 예약, 연쇄 재스케줄링, 변경 사항은 Crisphive의 확정적 제약 조건 해석기(deterministic constraint solver)가 계산합니다. 같은 질문을 두 번 던지면 정확히 같은 스케줄이 생성됩니다.

에이전트가 내 허락 없이 실제 스케줄을 변경할 수 있나요?

아니요. 기존 작업을 이동하는 모든 변경 사항은 검토 가능한 계획(작업 이동, 새로운 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시간 이내에 단축된 이동 시간과 추가 확보 가능한 용량을 진단해 드립니다.