개요 · Overview
사용 주체는 손님 본인의 AI 비서입니다. 다른 사람을 대신 부르는 기능은 아직 없습니다.
The caller is the passenger's own AI assistant. Booking on behalf of others is not supported yet.
엔드포인트 · Endpoints
| 이름 · Name | 주소 · URL |
|---|---|
| MCP (Streamable HTTP) | https://dev.api.don.rocks/mcp |
| Protected resource metadata (RFC 9728) | https://dev.api.don.rocks/.well-known/oauth-protected-resource/mcp |
| Authorization server metadata (RFC 8414) | https://dev.api.don.rocks/.well-known/oauth-authorization-server |
스테이징 주소는 공개하지 않습니다.
Staging endpoints are not published.
인증 흐름 · Authentication
MCP 인증 규격(OAuth 2.1)을 따릅니다. 로그인은 사용자 전화번호와 문자 인증번호입니다.
Follows the MCP authorization spec (OAuth 2.1). Sign-in is the user's phone number and an SMS code.
- 토큰 없이
POST /mcp→401+WWW-Authenticate: Bearer resource_metadata=…Call without a token → 401 pointing to resource metadata - 보호 리소스 메타데이터 → 인가 서버 메타데이터Fetch protected resource metadata, then authorization server metadata
- 클라이언트 등록: CIMD 우선, DCR 허용 — 지원 클라이언트 목록 안에서만Client registration: CIMD preferred, DCR allowed — supported clients only
- authorize(PKCE S256,
resource) → DON 로그인: 전화번호 → 문자 인증번호 → 동의(클라이언트 이름 + redirect 호스트, 개인정보 제3자 제공·국외 이전 동의)Sign in with phone number and SMS code, then consent (client name and redirect host shown, plus consent to provide data to the AI company abroad) - code +
iss(RFC 9207) → token. access·refresh 수명은 예정 · TBDExchange the code (check iss) for tokens. Access and refresh lifetimes: TBD - 연결 끊기:
disconnect도구(예정 · TBD), 토큰 revoke(RFC 7009)Disconnect: disconnect tool (TBD) and token revocation
scopes ride:request 부르기 · request a ride ride:read 상태 보기 · read ride status ride:cancel 취소 · cancel a ride
도구 · Tools
| 도구 · Tool | 입력 · Input | 하는 일 · What it does |
|---|---|---|
request_ride | pickup(필수, 200자 이하), destination(선택, 200자 이하)pickup required, destination optional, up to 200 characters each | 부르기. 진행 중 호출이 있으면 새로 만들지 않고 그 상태를 돌려줍니다Requests a ride; if one is active, returns it instead |
get_ride_status | rideId(없으면 진행 중 호출)rideId, defaults to the active ride | 상태·기사·차량 번호·도착 예정·위치 링크Status, driver, plate, ETA, tracking link |
cancel_ride | rideId(없으면 진행 중 호출)rideId, defaults to the active ride | 취소. 탑승 뒤엔 불가Cancels; not possible after pickup |
McpRideStatus { rideId, status, message, driver, etaMinutes, trackUrl }
status: confirming → dispatching → accepted → arrived → onboard → completed
terminal: completed · cancelled · failedmessage는 손님에게 그대로 전할 한국어 한 줄입니다. 도착 시간은 약속하지 말고 etaMinutes를 쓰세요.
message is a one-line Korean sentence to relay as is. Do not promise arrival times; use etaMinutes.
request_ride는 실제 택시를 보냅니다. 부르기 전에 출발지를 사용자에게 확인하고, 자동으로 다시 시도하지 마세요.
request_ride sends a real taxi. Confirm the pickup with the user first and do not retry it automatically.
도구 JSON 스키마 파일 · Tool schemas (JSON): 예정 · TBD
예시 대화 · Examples
- 정상: 부르기 → 배정 → 도착Happy path: request → assigned → arrived
- 진행 중 호출이 있을 때A ride is already active
- 출발지가 애매할 때(확인 1회)Ambiguous pickup (one confirmation)
- 취소Cancel
[확정 전] 서버 구현 뒤 실제 응답으로 채웁니다. / Filled with real responses after the server is built.
제한과 오류 · Limits and errors
| 경우 · Case | 응답 · Response |
|---|---|
| 진행 중 호출 1건(문자·MCP 공통)One active ride per phone (SMS and MCP) | request_ride가 기존 호출 상태를 돌려줌request_ride returns the active ride |
| 토큰 없음·만료·다른 audienceMissing, expired or wrong-audience token | 401 |
| 권한 부족Insufficient scope | 403 insufficient_scope |
| 배차 실패No driver found | status = failed |
| 인증번호 발송 제한SMS code rate limit | 예정 · TBD |
지원 클라이언트 · Supported clients
| 클라이언트 · Client | 연결 방법 · How to connect | 확인 날짜 · Checked | 상태 · Status |
|---|---|---|---|
| Claude | 설정 → 커넥터 → URL 추가Settings → Connectors → add URL | — | 확인 중Testing |
| ChatGPT | 개발자 모드에서 URL 추가Add the URL in developer mode | — | 확인 중Testing |
| Claude Code | claude mcp add --transport http don https://dev.api.don.rocks/mcp | — | 확인 중Testing |
이 목록 밖의 클라이언트는 연결되지 않습니다. 받는 회사를 처리방침에 먼저 적어야 해서, 늘릴 때는 처리방침을 고치고 7일 전에 알립니다. 실제로 연결해 본 것만 ‘지원’으로 바꿉니다.
Clients not on this list cannot connect. We add clients after updating the privacy policy with 7 days' notice. Only clients we have tested are marked supported.
데이터와 개인정보 · Data and privacy
- 받는 값: 전화번호, 출발지·목적지 문장We receive: phone number, pickup and destination text
- 에이전트 플랫폼으로 가는 정보: 도구 응답(상태·기사 이름·차량 번호·도착 예정·위치 링크)Sent to the agent platform: tool responses (status, driver name, plate, ETA, tracking link)
- 저장 위치: 한국 리전Stored in Korea (AWS Seoul)
- 지도 결과는 24시간 안에 삭제Map results deleted within 24 hours
- 연결 끊기 = 동의 철회Disconnecting withdraws consent
등재 현황 · Directory listings
아직 등재된 디렉터리가 없습니다.
Not listed yet.
변경 이력 · 문의 · Changelog · Contact
변경 이력: 아직 없습니다(첫 공개 전).
Changelog: none yet (before first release).
문의 · Contact: support@don.taxi · llms.txt