Claude SDK Debugging Guide

When to Use This

• SDK-related errors (Claude Agent SDK, MCP servers)
• JSON serialization errors involving SDK objects
• TypedDict mismatch errors
• SDK internal processing failures
• MCP server configuration errors

Debugging Strategy

1. Get Full Error Traceback

CRITICAL: User-facing errors don't show root cause. Always check log files.

# Check error logs
tail -50 logs/errors.log