CONFIGURATION.md

Configuration (Entry)

This root file is now a short entry point.

Canonical configuration docs live in MDX:

• Full MCP + CLI flags and connection contracts: docs/core/mcp_configuration.mdx

• Error envelope + recovery: docs/ai_agents/troubleshooting.mdx

• CLI vs MCP decision guide: docs/start_here/cli_vs_mcp.mdx

• CLI command recipes (CI + local): docs/start_here/cli_quick_recipes.mdx

• AI-agent setup flow: docs/ai_agents/execution_playbook.mdx

Migration

• Migrating from v2.x: docs/start_here/migration_v2_to_v3.mdx

Why this changed

Configuration content was moved to audience-first docs to avoid duplication and keep one source of truth.

For v3 automation safety:

• Run flutter-mcp-toolkit doctor --json before VM-dependent workflows.
• Use safe write flags on snapshot/bundle commands: --check, --diff, --backup, --no-overwrite.