본문으로 바로 가기

AI가 매장에 바로 붙습니다

피클이 쓰는 MCP 도구와 주문 API를 ChatGPT, Claude 같은 AI 비서에도 엽니다.

도구 15종 온라인A2A 0.3.0Idempotency-Key

라이브 도구

15종

읽기 8, 쓰기 7

읽기 비중

53%

인증 없이 읽는 도구

MCP 왕복

27ms

지금 이 화면이 tools/list 를 읽은 시간

주문 멱등

1건

같은 키로 두 번 보내도 주문은 하나

연결 주소

MCP
https://api.pepper.ai.kr/mcpJSON-RPC 도구 15종, stateless
에이전트 카드
https://api.pepper.ai.kr/.well-known/agent-card.jsonPepper Store Order & Reservation Agent
A2A 메시지
https://api.pepper.ai.kr/a2amessage/send, tasks/get
OpenAPI
https://api.pepper.ai.kr/v1/openapi.jsonREST 계약, 쓰기 요청은 Idempotency-Key 필수
매장 조회
https://api.pepper.ai.kr/v1/stores인증 없이 읽는 공개 스냅샷

MCP 도구

이름은 모두 pepper_ 로 시작합니다. 목록은 api 가 돌려주는 값입니다.

  • Pepper 매장 찾기pepper_search_storesPepper 에 등록된 공개 매장을 찾는다(search stores). 이름 일부(query)와 이행 방식(fulfillment: delivery·pickup·reservation)으로 거른다. 위치 반경 검색은 아직 지원하지 않는다.읽기
  • Pepper 매장 정보pepper_get_store매장 프로필(store profile): 영업 상태, 영업시간, 배달·픽업·예약 설정, 최소 주문 금액, 배달비. 금액은 정수 원, 시각은 +09:00.읽기
  • Pepper 메뉴pepper_get_menu구조화 메뉴(menu): 카테고리·메뉴·옵션 그룹(필수 여부·최소/최대)·품절. 주문에는 menu_id·group_id·option_id 를 그대로 쓴다.읽기
  • Pepper 배달 견적pepper_quote_delivery주소로 배달 가능 여부·배달비·예상 시간을 계산한다(delivery quote). quote_id 는 배달 주문에 넣는다.읽기
  • Pepper 픽업 시각pepper_get_pickup_slots픽업 가능한 시각(pickup slots). 불가 슬롯은 reason 이 있다. 고른 슬롯은 pepper_hold_pickup_slot 으로 120초 잡는다.읽기
  • Pepper 예약 잔여석pepper_get_availability날짜·인원으로 예약 가능한 시각(availability)을 조회한다. 불가 시각은 reason 이 있다.읽기
  • Pepper 주문 검증pepper_validate_order부작용 없이 주문 초안을 검증하고 서버 금액을 계산한다(validate order). 사람에게 보여 줄 합계는 이 결과의 금액만 쓴다.읽기
  • Pepper 배달 주문pepper_create_delivery_order배달 주문을 만든다(create delivery order). 사람의 최종 확인 뒤 호출하고 human_confirmation 을 넣는다. 전화는 phone_token 만. 온라인 결제는 응답의 결제 링크에서 사람이 승인한다.쓰기
  • Pepper 픽업 주문pepper_create_pickup_order픽업 주문을 만든다(create pickup order). 먼저 pepper_hold_pickup_slot 으로 받은 slot_hold_id 가 필요하다. 사람의 최종 확인 뒤 호출한다.쓰기
  • Pepper 픽업 시각 잡기pepper_hold_pickup_slot픽업 슬롯을 120초 동안 잡는다(hold pickup slot). 그 안에 pepper_create_pickup_order 를 호출한다.쓰기
  • Pepper 주문 상태pepper_get_order주문 상태·타임라인·가능한 다음 행동(get order). 이 키로 만든 주문만 볼 수 있다.읽기
  • Pepper 주문 취소pepper_cancel_order주문을 취소한다(cancel order). 매장이 접수한 뒤에는 거절될 수 있다(CANCEL_NOT_ALLOWED). 선결제는 자동 환불된다.쓰기
  • Pepper 예약 생성pepper_create_reservation매장의 잔여석을 점유해 방문 예약을 만든다(create reservation). 사람의 최종 확인을 받은 뒤 호출한다. 결과는 confirmed·pending_store 또는 waitlisted, 만석이면 CAPACITY_FULL(대안 시각 recovery 포함).쓰기
  • Pepper 예약 변경pepper_modify_reservation예약 인원·시각을 바꾼다(modify reservation). 늘어난 좌석을 못 받으면 기존 예약이 그대로 유지된다.쓰기
  • Pepper 예약 취소pepper_cancel_reservation예약을 취소한다(cancel reservation). 반환된 좌석은 대기 손님에게 자동으로 넘어간다.쓰기

도구 하나가 REST 엔드포인트 하나와 같은 서비스 함수를 붙니다.

에이전트 키 만들기

키에 붙일 스코프

키를 만들면 모양과 스코프를 그대로 확인할 수 있습니다.

이 키는 화면 안에서만 쓰는 데모입니다. 실제 발급은 운영 CLI(`agent:issue`)가 하고, 발급한 키는 저장소·브라우저에 남기지 않습니다.

요청 시험

읽기 요청만 보냅니다. 주문 만들기 같은 쓰기는 여기서 보내지 않습니다(매번 주문이 쌓입니다).

같은 요청을 두 번 보내면

  • 처음 보내는 키주문이 만들어지고 저장된 응답을 돌려줍니다. order_id, 링크, 결제 상태가 함께 옵니다.201
  • 같은 키, 같은 본문새 주문을 만들지 않고 처음 저장한 응답을 그대로 재생합니다. 손님이 버튼을 두 번 눌러도 주문은 1건입니다.201
  • 같은 키, 다른 본문키를 다른 요청에 재사용했습니다. 처음부터 다시 시도해야 하며, 이 오류는 retryable 이 아닙니다.409 IDEMPOTENCY_KEY_REUSED
  • 같은 키, 아직 처리 중앞선 요청이 끝나지 않았습니다. retryable 이라 잠시 뒤 같은 키로 다시 보내면 됩니다.409 IDEMPOTENCY_IN_PROGRESS

쓰기 요청에는 `Idempotency-Key` 헤더가 필요합니다. 오류 응답에는 `code`, `retryable`, `recovery` 가 함께 오므로 그 값으로 다음 행동을 정합니다.

  1. 매장과 메뉴 읽기pepper_search_stores, pepper_get_menu
  2. 주문 확인과 생성pepper_validate_order 뒤 멱등 키로 생성
  3. 진행 확인pepper_get_order 로 상태를 읽고 취소도

모든 응답은 금액이 원 단위 정수, 시각이 ISO 8601 +09:00 이고 개인정보는 마스킹된 값만 돌려줍니다.