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/mcpCursor 등 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, NAVIGATIONsafetyOptions: 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는 아래 주소를 열면 실시간 조회 결과를 텍스트로 받습니다.
- 전체 목록: https://carsharing-channeling-mcp.socar.kr/public/cars
- 장소별 예: https://carsharing-channeling-mcp.socar.kr/public/cars/gangnam-station/tomorrow
- 장소·일시 직접 지정:
https://carsharing-channeling-mcp.socar.kr/public/cars?location=장소&startDate=YYYY-MM-DD&startTime=HH:mm&endDate=YYYY-MM-DD&endTime=HH:mm
함께 보면 좋은 문서
최종 업데이트: · 문의: hello@socar.kr