본문으로 건너뛰기
에이전트 연결 · For AI agents

개발자 문서

Developer docs

표준 MCP 서버 하나로 연결합니다. 서버 구현 전인 값은 ‘예정’으로 표시합니다.
One standard MCP server. Values not final yet are marked TBD.

개요 · 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.

AI 비서ClientMCP 서버dev.api.don.rocks/mcp인가 서버DON (OAuth 2.1)사용자User1. POST /mcp (토큰 없음 · no token)2. 401 + resource_metadata3. GET 보호 리소스 메타데이터 (RFC 9728)4. GET 인가 서버 메타데이터 (RFC 8414)5. 클라이언트 등록 · CIMD / DCR6. authorize (PKCE S256, resource)7. 전화번호 → 문자 인증번호 → 동의8. code + iss (RFC 9207)9. token (code_verifier)10. access · refresh token11. POST /mcp + Bearer → 도구 호출
인증 흐름. 실선은 요청, 점선은 응답입니다. Authentication flow. Solid lines are requests, dashed lines are responses.
  1. 토큰 없이 POST /mcp → 401 + WWW-Authenticate: Bearer resource_metadata=…Call without a token → 401 pointing to resource metadata
  2. 보호 리소스 메타데이터 → 인가 서버 메타데이터Fetch protected resource metadata, then authorization server metadata
  3. 클라이언트 등록: CIMD 우선, DCR 허용 — 지원 클라이언트 목록 안에서만Client registration: CIMD preferred, DCR allowed — supported clients only
  4. 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)
  5. code + iss(RFC 9207) → token. access·refresh 수명은 예정 · TBDExchange the code (check iss) for tokens. Access and refresh lifetimes: TBD
  6. 연결 끊기: 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_ridepickup(필수, 200자 이하), destination(선택, 200자 이하)pickup required, destination optional, up to 200 characters each부르기. 진행 중 호출이 있으면 새로 만들지 않고 그 상태를 돌려줍니다Requests a ride; if one is active, returns it instead
get_ride_statusrideId(없으면 진행 중 호출)rideId, defaults to the active ride상태·기사·차량 번호·도착 예정·위치 링크Status, driver, plate, ETA, tracking link
cancel_riderideId(없으면 진행 중 호출)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 · failed

message는 손님에게 그대로 전할 한국어 한 줄입니다. 도착 시간은 약속하지 말고 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 token401
권한 부족Insufficient scope403 insufficient_scope
배차 실패No driver foundstatus = 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 Codeclaude 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