docs(user): update tutorial on mcp host configuration

- Refresh content of the tutorial to match current to-be-released version 0.7.x
- Refresh content of quicker `MCPHostConfiguration.md`
- Add the tutorials to the mkdocs configuration

Author: LittleCoinCoin

docs/articles/users/MCPHostConfiguration.md

@@ -30,7 +30,6 @@ For step-by-step guidance on MCP host configuration, see the comprehensive tutor
 - [Tutorial: Configuring Hatch Packages](tutorials/04-mcp-host-configuration/02-configuring-hatch-packages.md) - **Preferred deployment method** with automatic dependency resolution
 - [Tutorial: Configuring Arbitrary Servers](tutorials/04-mcp-host-configuration/03-configuring-arbitrary-servers.md) - Advanced method for non-Hatch servers
 - [Tutorial: Environment Synchronization](tutorials/04-mcp-host-configuration/04-environment-synchronization.md) - Cross-environment deployment workflows
-- [Tutorial: Advanced Synchronization](tutorials/04-mcp-host-configuration/05-advanced-synchronization.md) - Enterprise patterns and automation
 
 ## Basic Usage
 
@@ -40,7 +39,7 @@ Add an MCP server to a specific host:
 
 ```bash
 # Configure a local MCP server
-hatch mcp configure weather-server \
+hatch mcp configure weather_server \
   --host claude-desktop \
   --command python \
   --args weather_server.py
@@ -49,7 +48,7 @@ hatch mcp configure weather-server \
 hatch mcp configure api-service \
   --host cursor \
   --url https://api.example.com/mcp \
-  --header "Authorization: Bearer token"
+  --header "Authorization=Bearer token"
 ```
 
 ### List Configured Servers
@@ -64,7 +63,7 @@ hatch mcp list hosts
 hatch mcp list servers
 
 # List servers from specific environment
-hatch mcp list servers --env production
+hatch mcp list servers --env-var production
 ```
 
 ### Remove a Server
@@ -73,10 +72,10 @@ Remove an MCP server from a host:
 
 ```bash
 # Remove server from specific host
-hatch mcp remove server weather-server --host claude-desktop
+hatch mcp remove server weather_server --host claude-desktop
 
 # Remove server from all hosts
-hatch mcp remove server weather-server --host all
+hatch mcp remove server weather_server --host all
 
 # Remove entire host configuration
 hatch mcp remove host claude-desktop
@@ -86,7 +85,7 @@ hatch mcp remove host claude-desktop
 
 **Important**: Each server must be configured as either local (using `--command`) or remote (using `--url`), but not both. These options are mutually exclusive:
 
-- **Local servers**: Use `--command` and optionally `--args` and `--env`
+- **Local servers**: Use `--command` and optionally `--args` and `--env-var`
 - **Remote servers**: Use `--url` and optionally `--header`
 
 Attempting to use both `--command` and `--url` will result in an error.
@@ -103,12 +102,12 @@ hatch mcp configure my-server \
   --args server.py
 
 # Server with environment variables
-hatch mcp configure weather-server \
+hatch mcp configure weather_server \
   --host claude-desktop \
   --command python \
   --args weather_server.py \
-  --env API_KEY=your-key \
-  --env DEBUG=true
+  --env-var API_KEY=your-key \
+  --env-var DEBUG=true
 
 # Server with absolute path (required for some hosts)
 hatch mcp configure secure-server \
@@ -131,8 +130,8 @@ hatch mcp configure api-server \
 hatch mcp configure authenticated-api \
   --host cursor \
   --url https://secure-api.example.com/mcp \
-  --header "Authorization: Bearer your-token" \
-  --header "Content-Type: application/json"
+  --header "Authorization=Bearer your-token" \
+  --header "Content-Type=application/json"
 ```
 
 ## Multi-Host Configuration
@@ -143,14 +142,14 @@ Set up the same server on multiple host platforms:
 
 ```bash
 # Configure on multiple hosts at once
-hatch mcp configure weather-server \
+hatch mcp configure weather_server \
   --hosts claude-desktop,cursor,vscode \
   --command python \
   --args weather_server.py
 
 # Configure on all available hosts
-hatch mcp configure weather-server \
-  --all-hosts \
+hatch mcp configure weather_server \
+  --hosts all \
   --command python \
   --args weather_server.py
 ```
@@ -175,38 +174,6 @@ hatch mcp sync --from-env dev --to-host all --pattern ".*api.*"
 hatch mcp sync --from-env prod --to-host all --dry-run
 ```
 
-## Host-Specific Considerations
-
-### Claude Family (Claude Desktop, Claude Code)
-
-Claude hosts require absolute paths for local servers:
-
-```bash
-# Correct - absolute path
-hatch mcp configure my-server \
-  --host claude-desktop \
-  --command /usr/local/bin/python \
-  --args /path/to/server.py
-
-# Incorrect - relative path (will be rejected)
-hatch mcp configure my-server \
-  --host claude-desktop \
-  --command python \
-  --args ./server.py
-```
-
-### VS Code
-
-VS Code uses a nested configuration structure. Hatch handles this automatically, but be aware that manual edits to VS Code settings may affect MCP server configurations.
-
-### Cursor and LM Studio
-
-These hosts are more flexible with path requirements and generally accept both absolute and relative paths.
-
-### Gemini
-
-Gemini uses the official configuration path at `~/.gemini/settings.json`. Ensure you have Gemini properly installed and configured.
-
 ## Backup and Recovery
 
 ### Automatic Backups
@@ -224,14 +191,11 @@ hatch mcp configure my-server --host claude-desktop --command python --args serv
 ### Manual Backup Management
 
 ```bash
-# Create manual backup of host configuration
-hatch mcp backup --host claude-desktop
-
 # List available backups
-hatch mcp backup list --host claude-desktop
+hatch mcp backup list claude-desktop
 
-# Restore from backup
-hatch mcp restore --host claude-desktop --backup 2025-09-21-10-30-00
+# Restore from backup file
+hatch mcp backup restore claude-desktop --backup-file <backup_file_name>
 ```
 
 ### Backup Locations
@@ -469,7 +433,7 @@ Complete host configuration removal and management:
 hatch mcp remove host <host-name>
 
 # Remove with environment specification
-hatch mcp remove server <server_name> --host <host> --env <environment>
+hatch mcp remove server <server_name> --host <host> --env-var <environment>
 ```
 
 ### Safety and Backup Features

docs/articles/users/tutorials/04-mcp-host-configuration/01-host-platform-overview.md

@@ -221,16 +221,16 @@ hatch package add my_package --host claude-desktop --dry-run
 hatch mcp configure my_package --host cursor --dry-run
 
 # Test in testing environment first
-hatch env use package-testing
+hatch env use package_testing
 hatch package add . --host claude-desktop # from within the package directory
 ```
 
 ### Environment Isolation
 
 ```bash
 # Different environments maintain separate package versions
-hatch env create package-testing-v2
-hatch env create team-standard-2024q4
+hatch env create package_testing_v2
+hatch env create team_standard_2024q4
 
 # Each environment can have different MCP package versions
 ```

docs/articles/users/tutorials/04-mcp-host-configuration/02-configuring-hatch-packages.md

@@ -69,23 +69,10 @@ hatch package add . --host claude-desktop
 
 **Expected Output**:
 ```
-Analyzing package dependencies...
-✓ Python dependencies: requests, numpy
-✓ System dependencies: curl
-✓ Hatch dependencies: none
-✓ Docker dependencies: none
-
-Installing dependencies...
-✓ Python environment created
-✓ Python packages installed
-✓ System packages installed
-
-Configuring MCP server...
-✓ Server configured: my-new-package
-✓ Host platform: claude-desktop
-✓ Configuration file updated
-
-Package deployment completed successfully!
+Successfully added package: my_new_package
+Configuring MCP server for package 'my_new_package' on 1 host(s)...
+✓ Configured my_new_package (my_new_package) on claude-desktop
+MCP configuration completed: 1/1 hosts configured
 ```
 
 ### Verify Deployment
@@ -145,8 +132,9 @@ hatch package sync weather-server,news-api --host all
 
 ```bash
 # Sync all packages in current environment to hosts
-hatch package sync --all --host claude-desktop,cursor
+hatch package sync --host claude-desktop,cursor
 ```
+The `hatch package sync` command syncs all packages that are already installed in the current environment.
 
 ## Step 4: Validate Dependency Resolution
 
@@ -249,15 +237,18 @@ hatch mcp remove server my-new-package --host claude-desktop
 # (Backups are created automatically)
 ```
 
-**Clean Environment Reset**:
+**Clean Environment Reset**
+
 ```bash
 # Remove all MCP configurations for host
 hatch mcp remove host claude-desktop
 
-# Redeploy packages
-hatch package sync --all --host claude-desktop
+# Redeploy packages from the a hatch environment
+hatch mcp sync --from-env env_name --to-host claude-desktop
 ```
 
+**Note**: The `hatch mcp sync` command only syncs packages from one environment (or one host) at a time. If you want to re-sync other packages, you must run the command several times.
+
 ## Best Practices
 
 ### Package Development Workflow

docs/articles/users/tutorials/04-mcp-host-configuration/03-configuring-arbitrary-servers.md

@@ -76,15 +76,14 @@ hatch mcp configure news-api \
 
 **Expected Output**:
 ```
-Configuring MCP server: weather-api
-✓ Host platform: claude-desktop
-✓ Command: python
-✓ Arguments: /path/to/weather_server.py
-✓ Environment variables: API_KEY, DEBUG
-✓ Configuration file updated
-✓ Backup created: ~/.hatch/mcp_backups/claude-desktop_20231201_143022.json
-
-MCP server configured successfully!
+Server 'weather-api' created for host 'claude-desktop':
+  name: UPDATED None --> 'weather-api'
+  command: UPDATED None --> 'python'
+  args: UPDATED None --> ['/path/to/weather_server.py']
+  env: UPDATED None --> {'API_KEY': 'your_api_key', 'DEBUG': 'true'}
+
+Configuring MCP server 'weather-api' on host 'claude-desktop'? [y/N]: y
+[SUCCESS] Successfully configured MCP server 'weather-api' on host 'claude-desktop'
 ```
 
 ### Verify Local Configuration
@@ -122,34 +121,33 @@ Configure an MCP server hosted on a remote URL:
 ```bash
 # Configure remote MCP server
 hatch mcp configure remote-api \
-  --host claude-desktop \
+  --host gemini \
   --url https://api.example.com/mcp \
-  --headers Authorization=Bearer_your_token \
-  --headers Content-Type=application/json
+  --header "Authorization=Bearer_your_token" \
+  --header "Content-Type=application/json"
 ```
 
 ### Remote Server with Authentication
 
 ```bash
 # Configure with multiple headers for authentication
 hatch mcp configure secure-api \
-  --host cursor \
+  --host gemini \
   --url https://secure-api.example.com/mcp \
-  --headers Authorization=Bearer_token \
-  --headers X-API-Key=your_api_key \
-  --headers User-Agent=HatchMCP/1.0
+  --header "Authorization=Bearer_token" \
+  --header "X-API-Key=your_api_key" \
+  --header "User-Agent=HatchMCP/1.0"
 ```
 
 **Expected Output**:
 ```
-Configuring MCP server: secure-api
-✓ Host platform: cursor
-✓ Server URL: https://secure-api.example.com/mcp
-✓ Headers: Authorization, X-API-Key, User-Agent
-✓ Configuration file updated
-✓ Backup created: ~/.hatch/mcp_backups/cursor_20231201_143045.json
-
-Remote MCP server configured successfully!
+Server 'secure-api' created for host 'gemini':
+  name: UPDATED None --> 'secure-api'
+  url: UPDATED None --> 'https://secure-api.example.com/mcp'
+  headers: UPDATED None --> {'Authorization': 'Bearer_token', 'X-API-Key': 'your_api_key', 'User-Agent': 'HatchMCP/1.0'}
+
+Configuring MCP server 'secure-api' on host 'gemini'? [y/N]: y
+[SUCCESS] Successfully configured MCP server 'secure-api' on host 'gemini'
 ```
 
 ### Verify Remote Configuration
@@ -220,7 +218,7 @@ hatch mcp configure data-processor \
 
 ```bash
 # Testing configuration
-hatch env use package-testing
+hatch env use package_testing
 hatch mcp configure test-server \
   --host claude-desktop \
   --command python \
@@ -229,7 +227,7 @@ hatch mcp configure test-server \
   --env LOG_LEVEL=debug
 
 # Team standard configuration
-hatch env use team-standard-2024q4
+hatch env use team_standard_2024q4
 hatch mcp configure team-server \
   --host claude-desktop \
   --command python \