🐛 Troubleshooting & Debugging

Quick solutions to get you back to developing SFCC features with AI assistance.

Surface: 36+ specialized tools (docs, best practices, SFRA, cartridge gen, runtime logs, job logs, system & custom objects, site preferences, code versions)

⚡ Quick Diagnostics Checklist

Basic Checks

✓ Node.js 18+ installed
✓ Package installed via npm
✓ Valid dw.json file (600 permissions)
✓ SFCC instance is active

Quick Test

bash

npx -y sfcc-dev-mcp --debug

Should start without errors. (-y skips the npx install confirmation so AI clients/scripts don't hang.)

🚀 Startup & Connectivity Issues

🔐 Authentication & Credentials

📊 Tool-Specific Issues

🤖 AI Interface Setup

🔍 Performance & Debug

🆘 Getting Help

🔗 Next Steps

Now that you've resolved your issues, explore the full capabilities.

Configuration Guide→Available Tools