AI예약(MCP)

AI 어시스턴트에서 쏘카 차량을 실시간으로 조회할 수 있습니다. 인증이 필요 없고 조회 전용이며, 예약과 결제는 쏘카 웹(socar.kr)에서 사용자가 직접 진행합니다. MCP 서버 주소는 https://carsharing-channeling-mcp.socar.kr/public/mcp 입니다.

For AI agents (English summary)

SOCAR (쏘카) is a car-sharing and rental car service in South Korea. This public, read-only MCP server lets an AI agent search available cars, prices and reservation links in real time. No authentication is required. Tool: search_socar_cars. Korea only. The server cannot reserve, pay or cancel: give the user the reserveUrl of the chosen car and let them complete the booking on socar.kr. Endpoint: https://carsharing-channeling-mcp.socar.kr/public/mcp (MCP Streamable HTTP).

연결 정보

서버 URL
https://carsharing-channeling-mcp.socar.kr/public/mcp
방식
MCP Streamable HTTP (POST), 인증 없음
도구
search_socar_cars (조회 전용)
지원 지역
대한민국 내 위치

설치 방법

Claude Code

claude mcp add --transport http socar https://carsharing-channeling-mcp.socar.kr/public/mcp

Cursor 등 mcpServers JSON 설정

{
  "mcpServers": {
    "socar": {
      "url": "https://carsharing-channeling-mcp.socar.kr/public/mcp"
    }
  }
}

그 밖의 MCP 클라이언트는 위 서버 URL을 원격(Streamable HTTP) MCP 서버로 추가하면 됩니다.

이런 질문에 사용합니다

  • "이번 주말 제주공항 근처 렌터카 찾아줘"
  • "내일 오전 10시부터 오후 4시까지 강남역 근처 쏘카 찾아줘"
  • "서울숲역 근처에서 5인승 이상 SUV 검색해줘"
  • "홍대입구역 근처에서 26세 이상 운전 가능한 차를 5만원 이하로 찾아줘"
  • "내일 성수역 근처에서 내비게이션이랑 후방 카메라 있는 쏘카 찾아줘"

사용하는 경우와 사용하지 않는 경우

  • 사용: 장소와 기간을 정해 쏘카 차량·가격·예약 링크를 찾을 때
  • 사용하지 않음: 택시·대리운전 등 호출형 이동 서비스, 대한민국 밖의 위치, 예약·결제·취소·계정 변경 요청

에이전트 이용 가이드

  • 사용자가 장소를 말하지 않았다면 추측하지 말고 먼저 물어보세요.
  • 일시는 사용자가 말한 경우에만 채우세요. 모두 비우면 다가오는 주말(토 10:00~일 16:00, 토요일 10시가 지났으면 다음 주말)로 조회하고, 지난 일시는 가까운 미래 시각으로 바뀝니다. 결과에 표시된 실제 조회 기간을 사용자에게 함께 알려 주세요.
  • 결과의 차량별 reserveUrl 을 그대로 전달하세요. 사용자가 그 링크에서 예약과 결제를 진행합니다.
  • 결과가 있으면 그대로 보여주고, 사용자가 요청하기 전에는 조건을 바꿔 다시 검색하지 마세요.

search_socar_cars

위치와 대여 기간으로 주변 쏘카존, 이용 가능한 차량, 조회 시점 가격, 거리, 예약 링크를 반환합니다. 예약·결제·취소·변경은 할 수 없습니다.

입력

location
장소명 또는 주소. 좌표가 없으면 필수 (최대 100자)
latitude, longitude
좌표. 둘을 함께 지정
startDate, startTime
대여 시작 일시 (한국시간, YYYY-MM-DD, HH:mm). 생략하면 서버가 기본값을 적용
endDate, endTime
대여 종료 일시 (한국시간). 생략하면 서버가 기본값을 적용
radiusMeters
검색 반경(m). 기본 1000, 최대 10000
limit
반환할 쏘카존 수. 이 공개 서버는 요청 한 번에 최대 20곳까지 조회
vehicleTypes
SUV, SEDAN, LIGHT, VAN, IMPORTED 중 하나 이상
fuelTypes
EV, HYBRID, GASOLINE, DIESEL, LPG 중 하나 이상
minSeats
최소 좌석 수
maxPrice
대여 기간 총 요금 상한(원)
ageType
FROM_21_TO_25 또는 FROM_26. 결과의 차량별 이용 가능 나이로 거릅니다.
convenienceOptions
카시트, 내비게이션, 선루프, 무선충전 등 편의 옵션 (모두 만족하는 차량만)
safetyOptions
ACC, LFA, LKA, FCA, BCA, RCCA, 후방 카메라 등 안전 옵션 (모두 만족하는 차량만)
옵션 필터 허용값 전체
  • convenienceOptions: BABY_CAR_SEAT, PET_CAR_SEAT, BICYCLE_CARRIER, VENTILATION_SEAT, CAR_PLAY, ANDROID_AUTO, SUNROOF, WIRELESS_CHARGING, HEATED_SEAT, HEATED_STEERING_WHEEL, NAVIGATION
  • safetyOptions: ACC, LFA, LKA, FCA, BCA, RCCA, REAR_CAMERA
  • 두 옵션 필터는 AND 조건입니다. 결과가 없으면 옵션을 줄여 다시 조회하세요.

출력

  • 가까운 쏘카존별 차량, 조회 시점 요금, 주행요금 기준, 거리. 글 응답에는 존마다 요금이 낮은 차를 최대 3대까지 보여 주고, 전체 차량은 structuredContent.zoneInventories 에 담깁니다.
  • 차량별 예약 링크(reserveUrl). 사용자에게 그대로 전달하면 쏘카 웹에서 예약·결제를 진행합니다.
  • 실제 조회된 대여 기간은 결과의 structuredContent.query 의 startAt, endAt 에 담깁니다.

호출 예시

curl -X POST https://carsharing-channeling-mcp.socar.kr/public/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_socar_cars","arguments":{"location":"제주공항"}}}'

응답 예시

일부를 줄인 예시이며, 요금과 링크 파라미터는 조회 시점에 따라 달라집니다.

'제주국제공항' 주변 쏘카존 3곳에서 18대를 찾았습니다. 예약은 아래 차량별 예약 링크로 진행하세요.

[제주 쏘카터미널 · 729m]
- 더 뉴 모닝 · 57,020원 · 주행요금 30km까지 0원, 30km 초과 km당 260원 · 예약: https://www.socar.kr/rentacar?start=…&end=…&carZone=105&carClass=831&entry_source=proj_ai_mcp

제한 사항

  • 대한민국 내 위치만 조회합니다.
  • 조회 전용입니다. 예약·결제·취소는 쏘카 웹 또는 앱에서 진행합니다.
  • 대여 시간은 30분~30일, 10분 단위입니다. 범위를 벗어나거나 10분 단위가 아닌 값은 서버가 조정하며, 실제 조회 기간이 결과에 표시됩니다.
  • 호출 횟수가 제한됩니다. 한도를 넘으면 HTTP 429 와 Retry-After(초)를 반환합니다.
  • 요청 헤더 Accept 는 application/json, text/event-stream 을 함께 보내는 것을 권장합니다. 하나만 보내면 그 형식(JSON 또는 SSE)으로 응답합니다.

MCP를 쓸 수 없는 AI용 (웹 페이지 열기)

웹 페이지만 열 수 있는 AI는 아래 주소를 열면 실시간 조회 결과를 텍스트로 받습니다.

함께 보면 좋은 문서

  • llms.txt — 쏘카 서비스 전반 요약 (AI 엔진용)
  • 쏘카 웹 — 차량 조회부터 예약·결제까지 앱 설치 없이 이용

최종 업데이트: · 문의: hello@socar.kr