fix(mcp): add Claude Desktop transport validation

Prevent Claude Desktop from accepting remote server configurations (--url)
that will fail at runtime. Add CLI-level validation to reject --url for
Claude Desktop and Claude Code hosts.

Fixes: Issue 2 - Claude Desktop accepts --url but fails at runtime

Author: LittleCoinCoin

hatch/cli_hatch.py

@@ -637,6 +637,12 @@ def handle_mcp_configure(host: str, server_name: str, command: str, args: list,
             print(f"Error: Invalid host '{host}'. Supported hosts: {[h.value for h in MCPHostType]}")
             return 1
 
+        # Validate Claude Desktop/Code transport restrictions (Issue 2)
+        if host_type in (MCPHostType.CLAUDE_DESKTOP, MCPHostType.CLAUDE_CODE):
+            if url is not None:
+                print(f"Error: {host} does not support remote servers (--url). Only local servers with --command are supported.")
+                return 1
+
         # Validate argument dependencies
         if command and headers:
             print("Error: --headers can only be used with --url (remote servers), not with --command (local servers)")

tests/test_mcp_cli_host_config_integration.py

@@ -626,6 +626,56 @@ def test_reporting_functions_available(self):
         self.assertIsNotNone(report)
         self.assertEqual(report.operation, 'create')
 
+    @regression_test
+    def test_claude_desktop_rejects_url_configuration(self):
+        """Test Claude Desktop rejects remote server (--url) configurations (Issue 2)."""
+        with patch('hatch.cli_hatch.print') as mock_print:
+            result = handle_mcp_configure(
+                host='claude-desktop',
+                server_name='remote-server',
+                command=None,
+                args=None,
+                env=None,
+                url='http://localhost:8080',  # Should be rejected
+                headers=None,
+                no_backup=True,
+                dry_run=False,
+                auto_approve=True
+            )
+
+            # Validate: Should return error code 1
+            self.assertEqual(result, 1)
+
+            # Validate: Error message displayed
+            error_calls = [call for call in mock_print.call_args_list
+                         if 'Error' in str(call) or 'error' in str(call)]
+            self.assertTrue(len(error_calls) > 0, "Expected error message to be printed")
+
+    @regression_test
+    def test_claude_code_rejects_url_configuration(self):
+        """Test Claude Code (same family) also rejects remote servers (Issue 2)."""
+        with patch('hatch.cli_hatch.print') as mock_print:
+            result = handle_mcp_configure(
+                host='claude-code',
+                server_name='remote-server',
+                command=None,
+                args=None,
+                env=None,
+                url='http://localhost:8080',
+                headers=None,
+                no_backup=True,
+                dry_run=False,
+                auto_approve=True
+            )
+
+            # Validate: Should return error code 1
+            self.assertEqual(result, 1)
+
+            # Validate: Error message displayed
+            error_calls = [call for call in mock_print.call_args_list
+                         if 'Error' in str(call) or 'error' in str(call)]
+            self.assertTrue(len(error_calls) > 0, "Expected error message to be printed")
+
     @regression_test
     def test_cli_handler_signature_compatible(self):
         """Test that handle_mcp_configure signature is compatible with integration."""