Satori MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

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

Demo ao vivo

Como fica na prática

satori-skill.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

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

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

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

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Satori

Work through a recurring behavioral pattern with Satori

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

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

Pré-requisitos

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

Fluxo

Complete the onboarding

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

→ 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.✓ Copiado

→ 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.✓ Copiado

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

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

Armadilhas

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

Combine com: planning-with-files

Analyze a dream journal with Jungian lens

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

Quando usar: You've been writing dreams down and want more than 'it means you're stressed'.

Fluxo

Share three recent dreams

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

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

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

→ Session 1 prompts tailored to your motifs

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

Combinações

Combine com outros MCPs para 10× de alavancagem

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.✓ Copiado

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.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
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

Custo e limites

O que custa rodar

Cota de API: None
Tokens por chamada: Can be large — the skill references 211k+ characters of wisdom content when activated
Monetário: Free — skills are local files
Dica: If you hit context limits, summarize earlier sessions before starting a new arc.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: No credentials — pure prompts

Saída de dados: 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.

Solução de problemas

Erros comuns e correções

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.

Verificar: ls ~/.claude/skills/Satori/SKILL.md

SKILL.md frontmatter wrong

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

Verificar: 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'.

Alternativas

Satori vs. outros

Alternativa	Quando usar	Troca
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

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills