MCP 개발자 가이드
AI 에이전트에서 키츠네 타로 서비스를 호출하는 방법입니다.
엔드포인트
https://kitsune-tarot.vercel.app/mcpHTML 크롤링 대신 사이트 구조 안내: https://kitsune-tarot.vercel.app/llms.txt
연결 방법
1. Cursor 또는 MCP 지원 클라이언트 설정에서 위 URL을 등록합니다. 2. 새 리딩이 필요할 때만 kitsune_recommend_spread → kitsune_draw_tarot 순으로 호출합니다. 3. kitsune_draw_tarot 호출 시 question에 사용자 원문을 그대로 넣습니다. 4. 결과 카드 형식과 readingGuide.rules를 그대로 따릅니다. 5. 후속 질문은 도구를 재호출하지 않고, 기존 리딩을 바탕으로 이어서 답합니다.
제공 도구
kitsune_list_spreads
사용 가능한 스프레드 목록과 카드 수
kitsune_list_cards
78장 카드 목록·수트별 조회·키워드 검색 (카드 뽑기 없음)
kitsune_recommend_spread
새 리딩이 필요할 때만 — 질문에 맞는 스프레드 최대 3개 추천
kitsune_get_spread_guide
스프레드 설명·포지션 의미 (카드 뽑기 없음)
kitsune_get_card_meaning
카드 한 장의 정·역 키워드 + 상세 해석 웹 링크 (카드 뽑기 없음)
kitsune_draw_tarot
새 리딩이 필요할 때만 — 스프레드로 카드 리딩 + readingGuide 반환
kitsune_fortune_cookie
포춘쿠키 운세 메시지
kitsune_draw_lotto
타로 카드 6장을 로또 번호(1~45)로 변환 (오락용)
후속 질문 (이어서 답하기)
이미 리딩 결과가 나온 뒤 "계속 만나도 될까?", "3번 카드 설명해줘", "앞에 이어서 답해줘" 같은 질문에는 kitsune_recommend_spread나 kitsune_draw_tarot을 다시 호출하지 않습니다. 대화에 있는 기존 카드·해석을 바탕으로 답합니다. 이미 이 대화에 키츠네타로 리딩 결과가 있으면, 후속·추가 질문(예: "계속 만나도 될까?", "3번 카드 설명해줘", "앞에 이어서 답해줘")에는 kitsune 도구를 재호출하지 말고 기존 카드·해석을 바탕으로 답하세요. 새 주제·새 리딩·"다시 뽑아줘"일 때만 recommend/draw를 호출하세요.
리딩 흐름 예시
질문: "전 남친이랑 다시 만날 수 있을까?" → kitsune_recommend_spread(question) → kitsune_draw_tarot(spread: "love-reunion", question: "전 남친이랑 다시 만날 수 있을까?") 카드 의미만 필요하면 kitsune_get_card_meaning, 전체 목록은 kitsune_list_cards, 배열만 알고 싶으면 kitsune_get_spread_guide를 사용하세요.