Troubleshooting guide for ComfyUI MCP connection issues, model errors, workflow failures, and security warnings. Use when users encounter errors or unexpected behavior.
From comfynpx claudepluginhub hybridindie/comfyui_mcpThis skill uses the workspace's default tool permissions.
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Analyzes BMad project state from catalog CSV, configs, artifacts, and query to recommend next skills or answer questions. Useful for help requests, 'what next', or starting BMad.
Symptoms: Tools return connection errors, timeouts, or "ComfyUI not reachable" messages.
Checks:
COMFYUI_URL environment variable or comfyui.url in ~/.comfyui-mcp/config.yaml. Default is http://localhost:8188.comfyui_get_system_info to test basic connectivity.Symptoms: comfyui_generate_image or workflows fail with "model not found" errors.
Checks:
comfyui_list_models with the correct folder type (e.g., "checkpoints", "loras") to see what's available.v1-5-pruned-emaonly.safetensors).comfyui_search_models and comfyui_download_model to fetch models directly.comfyui_list_model_folders to see all valid folder types.Symptoms: comfyui_run_workflow or comfyui_generate_image fails after submission.
Checks:
comfyui_validate_workflow first to catch structural issues.comfyui_list_nodes shows what's installed. If a workflow uses nodes that aren't installed, it will fail.comfyui_get_node_info to verify.comfyui_get_queue to see if the job is stuck or if there's a queue backlog.comfyui_get_progress with the prompt_id to see which node failed.Symptoms: Jobs stay in "running" state indefinitely, or the queue doesn't process.
Checks:
comfyui_get_queue to see the current state.comfyui_interrupt to stop the currently running job.comfyui_clear_queue to remove all pending jobs.Symptoms: Tools return messages about "dangerous nodes" or security warnings.
What they mean:
What to do:
comfyui_audit_dangerous_nodes to scan all installed nodes proactively.~/.comfyui-mcp/config.yaml: security.mode: "audit" or "enforce".Symptoms: comfyui_search_custom_nodes, comfyui_install_custom_node, and related tools fail or report Manager not available.
Fix: Install ComfyUI-Manager:
ComfyUI/custom_nodes/git clone https://github.com/ltdrdata/ComfyUI-Manager.gitcomfyui_get_server_features to verify detection.Symptoms: comfyui_search_models, comfyui_download_model fail or report Model Manager not available.
Fix: Install ComfyUI-Model-Manager:
ComfyUI/custom_nodes/git clone https://github.com/hayden-fr/ComfyUI-Model-Manager.gitcomfyui_get_server_features to verify detection.