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

Por qué usarlo

Características clave

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 en vivo

Cómo se ve en la práctica

satori-skill.replay ▶ listo

0/0

Instalar

Elige tu 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
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.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 el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Satori

Work through a recurring behavioral pattern with Satori

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

Cuándo usarlo: You keep ending up in the same argument, the same burnout cycle, the same avoidance — and generic AI advice hasn't helped.

Requisitos previos

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

Flujo

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.

Errores comunes

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

Combinar con: planning-with-files

Analyze a dream journal with Jungian lens

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

Cuándo usarlo: You've been writing dreams down and want more than 'it means you're stressed'.

Flujo

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.

Combinaciones

Combínalo con otros MCPs para multiplicar por 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.✓ 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

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
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

Coste y límites

Lo que cuesta ejecutarlo

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

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: No credentials — pure prompts

Salida de datos: 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.

Resolución de problemas

Errores comunes y soluciones

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 otros

Alternativa	Cuándo usarla	Contrapartida
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

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills