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