MCP 서버 연결

Claude, Cursor 등 MCP를 지원하는 AI 도구에서 아워데 API를 자연어로 사용할 수 있어요.

API 키 발급

로그인 후 개발자 페이지에서 키를 발급하세요. 발급 시 원문은 1회만 표시돼요: /dashboard/developer

제공 도구

문서 검색 도구와 주최자 액션 도구를 제공해요. 얼굴검색 도구는 포함하지 않아요.

• search_docs, get_page
• create_event, list_events, get_event, get_event_status, patch_event, delete_event
• upload_photo, complete_upload, get_indexing_status, get_share_link, get_plan_and_limits

설정 방법

MCP 클라이언트 설정에 아래를 추가하고 발급한 API 키를 넣으세요:

{
  "mcpServers": {
    "iwasthere": {
      "url": "https://7y62bns2zdo3xfpm6azyelalxq0gbelo.lambda-url.ap-northeast-2.on.aws/",
      "headers": { "Authorization": "Bearer iwt_YOUR_KEY" }
    }
  }
}

시나리오 예시

사용자가 자연어로 요청하면 에이전트가 도구를 연계 호출해요. 예: "7월 워크숍 이벤트 만들고 공유링크 알려줘" → create_event → get_share_link. "이 사진들 올려줘" → upload_photo(presign) → 직접 PUT → complete_upload. "방금 이벤트 준비 다 됐어?" → get_event_status(상태+인덱싱 진행률 한 번에). "이번 달 몇 개까지 더 만들 수 있어?" → get_plan_and_limits.

"7월 워크숍 만들고 공유링크 줘"
   → create_event(name:"7월 워크숍")
   → get_share_link(eventId)

"이 사진들 이벤트에 올려줘"
   → upload_photo(eventId, files:[{name,size,type}])
       ↳ 반환: uploads[].url (presigned) + contentType + photoId + s3Key
   → 호스트가 각 url에 원본을 HTTP PUT
       (Content-Type 헤더 = 반환된 contentType, 불일치 시 403)
   → complete_upload(eventId, uploaded:[{photoId,s3Key,fileSize}])
       ※ presign·complete는 MCP 도구로 제공. 실제 PUT(바이너리)만 도구 밖(HTTP)에서 수행.

"방금 이벤트 준비 다 됐어?"
   → get_event_status(eventId)   # 상태 + 인덱싱 진행률(done/total/allDone) 한 번에

"이번 달 이벤트 몇 개까지 더 만들 수 있어?"
   → get_plan_and_limits()          # plan / activeEventCount / planLimits

upload_photo 도구는 presigned URL과 파일별 contentType을 반환해요. 실제 파일 업로드(각 url에 HTTP PUT, Content-Type 헤더를 반환된 contentType과 정확히 일치 — 불일치 시 403)는 MCP 도구 밖에서 하고, 그다음 complete_upload 도구로 인덱싱을 시작해요. 진행 상황은 get_event_status로 확인해요.

얼굴검색 도구는 없어요

MCP 도구 목록에도 얼굴검색은 포함되지 않아요(영구 비공개 원칙).