Satori MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

Auto-activates after install — no special invocation phrase required
Five-question onboarding to establish context before giving advice
Specialized protocols: Dark Night Protocol, Jungian shadow work arc
Generates pattern letters, dream analysis, purpose-mapping exercises
Explicitly redirects to professional help when needs exceed conversational support

라이브 데모

실제 사용 모습

satori-skill.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "satori-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/MetcalfSolutions/Satori",
        "~/.claude/skills/Satori"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "satori-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/MetcalfSolutions/Satori",
        "~/.claude/skills/Satori"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "satori-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/MetcalfSolutions/Satori",
        "~/.claude/skills/Satori"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "satori-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/MetcalfSolutions/Satori",
        "~/.claude/skills/Satori"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "satori-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/MetcalfSolutions/Satori",
        "~/.claude/skills/Satori"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "satori-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/MetcalfSolutions/Satori",
          "~/.claude/skills/Satori"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add satori-skill -- git clone https://github.com/MetcalfSolutions/Satori ~/.claude/skills/Satori

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Satori

Work through a recurring behavioral pattern with Satori

👤 Anyone noticing a loop they can't seem to break ⏱ ~45 min beginner

언제 쓸까: You keep ending up in the same argument, the same burnout cycle, the same avoidance — and generic AI advice hasn't helped.

사전 조건

Skill installed via Claude.ai Customize > Skills or cloned to ~/.claude/skills/Satori — Upload SatoriSkill-v5.zip on claude.ai, or git clone https://github.com/MetcalfSolutions/Satori ~/.claude/skills/Satori

흐름

Complete the onboarding

I want to work on something with you. Run the Satori intake.✓ 복사됨

→ Five-question sequence exploring your patterns and history — not instant advice
Describe the loop

Here's the pattern: <describe>. I notice it every few months.✓ 복사됨

→ Reframe drawing on relevant tradition (Stoic / IFS / etc.) plus a concrete exercise
Use a pattern letter

Write me a pattern letter I can re-read in a month.✓ 복사됨

→ Warm, specific letter tied to your actual situation, not generic

결과: A reframe plus a durable artifact (letter / exercise) you can return to.

함정

Treating Satori as therapy — The skill itself will redirect for clinical needs — trust that, don't route around it

함께 쓰기: planning-with-files

Analyze a dream journal with Jungian lens

👤 Journalers curious about their dream content ⏱ ~30 min beginner

언제 쓸까: You've been writing dreams down and want more than 'it means you're stressed'.

흐름

Share three recent dreams

Using Satori — here are my three most recent dreams. Look for motifs.✓ 복사됨

→ Specific image-level analysis, not generic symbolism
Ask for a shadow-work prompt

Start the five-session shadow arc using what you saw.✓ 복사됨

→ Session 1 prompts tailored to your motifs

결과: A personalized shadow-work sequence you can run across weeks.

조합

다른 MCP와 조합해 10배 효율

satori-skill + planning-with-files

Persist Satori session notes across days so the skill remembers your patterns

Use planning-with-files to keep findings.md updated with what we learn each Satori session.✓ 복사됨

satori-skill + filesystem

Save pattern letters and dream analyses into your own journal folder

Save today's pattern letter to ~/journal/2025-patterns/<date>.md.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
intake_onboarding	free-text context	First real session — grounds later advice in your actual situation
dark_night_protocol	current distress description	High distress outside office hours — stabilize, don't optimize
shadow_work_arc	recurring pattern or motif	User wants depth work, not quick advice
pattern_letter	situation + what user wants to remember	End of a session — give the user something durable to re-read

비용 및 제한

운영 비용

API 쿼터: None
호출당 토큰: Can be large — the skill references 211k+ characters of wisdom content when activated
금액: Free — skills are local files
팁: If you hit context limits, summarize earlier sessions before starting a new arc.

보안

권한, 시크릿, 파급범위

자격 증명 저장: No credentials — pure prompts

데이터 외부 송신: None — all conversation stays in your Claude session

Satori is not therapy. If you're in crisis, call a local crisis line — the skill itself will also redirect.

문제 해결

자주 발생하는 오류와 해결

Skill not invoked — Claude gives generic motivational advice

On claude.ai, verify Satori is toggled on in Skills. Locally, confirm ~/.claude/skills/Satori/SKILL.md exists.

확인: ls ~/.claude/skills/Satori/SKILL.md

SKILL.md frontmatter wrong

Re-download the v5 zip — a partial unzip breaks the frontmatter.

확인: head ~/.claude/skills/Satori/SKILL.md

Wrong trigger keywords — onboarding doesn't start

Ask explicitly: 'Run the Satori intake' or 'Use the Satori skill to work on X'.

대안

Satori 다른 것과 비교

대안	언제 쓰나	단점/장점
Raw journaling with vanilla Claude	You don't need the wisdom tradition framing	Lighter context load, but Claude reverts to self-help clichés without the skill
Professional therapy	You're in clinical territory (trauma, active crisis, persistent distress)	A skill can't replace a trained human — Satori's own guardrails agree

Satori