가이드
MCP로 연결
Waity는 읽기 전용 도구 세 개를 갖춘 원격 MCP 서버입니다. HTTP로 MCP를 지원하는 모든 클라이언트에 추가하세요.
서버 URL
URL
https://api.waity.ai/mcp
키 없이도 작동합니다: 세션마다 하루 100회 호출할 수 있습니다. 키가 있으면 X-Api-Key 또는 Authorization: Bearer로 보내세요.
URL만 받는 호스팅 커넥터는 URL에 키를 담을 수 있습니다: https://api.waity.ai/mcp?key=wk_…. Waity는 쿼리 문자열을 기록하지 않지만, 이 URL은 키처럼 다루세요.
클라이언트에 추가
Claude
- 설정을 열고 커넥터로 이동하세요.
- "Add custom connector"를 선택하세요.
- 이름을 Waity로 하고 아래 URL을 붙여넣은 뒤 "Add"를 선택하세요.
https://api.waity.ai/mcp
ChatGPT
- 설정을 열고 "Apps & Connectors"로 이동하세요.
- "Advanced settings"에서 "Developer mode"를 켜세요.
- 아래 URL로 Waity라는 커넥터를 만드세요. 인증은 없음으로 하세요.
- 채팅의 도구 메뉴에서 Waity를 선택하세요.
https://api.waity.ai/mcp
Claude Code
터미널에서 실행하세요:
claude mcp add --transport http waity https://api.waity.ai/mcp
그런 다음 Claude Code에서 /mcp를 실행해 연결을 확인하세요.
Cursor
또는 ~/.cursor/mcp.json에 추가하세요:
{
"mcpServers": {
"waity": {
"url": "https://api.waity.ai/mcp"
}
}
}
VS Code
또는 "MCP: Add Server"를 실행하고 HTTP를 선택한 뒤 URL을 붙여넣으세요:
https://api.waity.ai/mcp
또는 .vscode/mcp.json에 추가하세요:
{
"servers": {
"waity": {
"type": "http",
"url": "https://api.waity.ai/mcp"
}
}
}
다른 클라이언트
URL을 추가하거나, 설정 파일을 쓰는 클라이언트라면 이 JSON을 사용하세요:
{
"mcpServers": {
"waity": {
"url": "https://api.waity.ai/mcp"
}
}
}
도구
세 도구 모두 읽기 전용이며 후속 링크를 바로 쓸 수 있는 도구 호출로 반환합니다. find_waits와 get_wait의 기본값은 최소 보기입니다.
find_waits
현재 대기 시간과 함께 장소를 찾습니다: 특정 지점 근처, 이름이나 지명, 또는 ID로.
| 이름 | 유형 | 설명 |
|---|---|---|
lat | number | Latitude in decimal degrees |
lng | number | Longitude in decimal degrees |
q | string | A place name, city, airport code or ZIP (at most 100 characters). With lat/lng, results sort by distance. |
ids | string[] | Up to 25 place ids, returned in this order. |
category | er | urgent-care | dmv | airport | border[] | Only these categories. Omit for all. 현재 지원 범위. GET /v1/categories 참고. |
open | boolean | true: only places open now. |
sort | distance | wait | total | distance (default with lat/lng), wait, or total (needs lat/lng). |
limit | integer | 1 to 25, default 10. |
view | minimal | full | minimal (default) for the essentials, full for sources, timestamps, hours and alternatives. |
get_wait
한 장소: 지금, 평소, 줄어드는 시점, 근처 대안. 그룹 ID는 그 안의 줄들을 반환합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
id필수 | string | A place id from find_waits, e.g. pl_xaed7pr1f5. |
under | number | Threshold in minutes. Defaults: er, urgent-care and border 30, dmv 20, airport 15. |
travel_min | number | Travel time in minutes, for a leave-by time. |
date | string | Local date YYYY-MM-DD, today to 7 days ahead, to plan a day. |
lat | number | The user's latitude, for distances. |
lng | number | The user's longitude, for distances. |
forecast | boolean | With view minimal, add a compact hourly forecast [{at, value}]. |
view | minimal | full | minimal (default) for the essentials, full for sources, timestamps, hours and alternatives. |
get_history
한 장소의 대기 시간 기록: 시간별, 일별 또는 모든 값. 키가 필요하며 방문을 예측하지 않습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
id필수 | string | A place id from find_waits (one place, lane or department, not a group), e.g. pl_xaed7pr1f5. |
from | string | Start, inclusive: a date YYYY-MM-DD (local to the place) or an ISO 8601 date-time with offset. Default: 7 days before to. |
to | string | End, exclusive: a date YYYY-MM-DD (local to the place) or an ISO 8601 date-time with offset. A date means the end of that day. Default: now. |
granularity | raw | hour | day | hour (default): hourly avg, median, p90, min, max. day: one row per local day. raw: every posted reading. |
tier | official | place | agent | Which kind of source. Default: the place's displayed source. |
cursor | string | page.next_cursor from the previous page; carries the range. |
limit | integer | Rows per page. Caps: raw 1000, hour 336, day 366. |
MCP와 REST
- 알 수 없는 인수는
invalid_parameter로 거부됩니다. REST는 알 수 없는 파라미터를 무시하고 diagnostics에 그 사실을 알립니다. - MCP는 위치를 추측하지 않습니다: 위치나 도시, ZIP을 보내세요.
- 도구 결과는 응답을
structuredContent에 담고, 텍스트만 읽는 클라이언트를 위해 JSON 텍스트로도 한 번 더 담습니다. - 키가 없으면 MCP 클라이언트가
Mcp-Session-Id헤더를 알아서 돌려보내므로, 세션마다 따로 집계됩니다.