Satori MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

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

Démo en direct

Aperçu en pratique

satori-skill.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/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
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Satori

Work through a recurring behavioral pattern with Satori

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

Quand l'utiliser : You keep ending up in the same argument, the same burnout cycle, the same avoidance — and generic AI advice hasn't helped.

Prérequis

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

Déroulement

Complete the onboarding

I want to work on something with you. Run the Satori intake.✓ Copié

→ 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.✓ Copié

→ 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.✓ Copié

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

Résultat : A reframe plus a durable artifact (letter / exercise) you can return to.

Pièges

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

Combiner avec : planning-with-files

Analyze a dream journal with Jungian lens

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

Quand l'utiliser : You've been writing dreams down and want more than 'it means you're stressed'.

Déroulement

Share three recent dreams

Using Satori — here are my three most recent dreams. Look for motifs.✓ Copié

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

Start the five-session shadow arc using what you saw.✓ Copié

→ Session 1 prompts tailored to your motifs

Résultat : A personalized shadow-work sequence you can run across weeks.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

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.✓ Copié

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.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler
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

Coût et limites

Coût d'exécution

Quota d'API: None
Tokens par appel: Can be large — the skill references 211k+ characters of wisdom content when activated
Monétaire: Free — skills are local files
Astuce: If you hit context limits, summarize earlier sessions before starting a new arc.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : No credentials — pure prompts

Sortie de données : 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.

Dépannage

Erreurs courantes et correctifs

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.

Vérifier : ls ~/.claude/skills/Satori/SKILL.md

SKILL.md frontmatter wrong

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

Vérifier : 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'.

Alternatives

Satori vs autres

Alternative	Quand l'utiliser	Compromis
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

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills