feat: Claude.ai Web App Integration (v4.6.0 Release) (#35)

* feat: Implement HTTP server with HTTPS and OAuth functionality

This commit introduces a new HTTP server with comprehensive features for enhanced MCP client integration, including:
- **HTTPS Support**: Enables secure communication with clients like Claude.ai web app.
- **OAuth Authentication**: Integrates GitHub OAuth for streamlined and secure user authentication.
- **Documentation Consolidation**: Updates and consolidates documentation related to authentication, HTTP server setup, and cross-references for improved clarity and user experience.
- **Cross-reference Updates**: Ensures all relevant documentation links and references are accurate and up-to-date.
- **New Files**: Adds necessary files for HTTP server, OAuth providers, and SSL certificate generation.
- **Configuration Updates**: Modifies existing configurations to support new HTTP server and OAuth settings.

* fix: resolve syntax error in Qdrant unit tests

- Convert embeddings-service.test.ts from executable script to proper test format
- Fix import path to use src/ instead of build/ directory
- Remove shebang and convert to standard Mocha test structure
- All 12 tests now pass successfully

Resolves CI failure: SyntaxError: Unexpected strict mode reserved word

* docs: remove monitoring guide link from Claude.ai integration documentation

---------

Co-authored-by: GitHub Action <action@github.com>
Co-authored-by: Seth Rivers <srivers@groupon.com>

Author: 3 people

.gitignore

@@ -22,6 +22,9 @@ state/dataproc-state.json
 config/server.json
 config/default-params.json
 
+# SSL certificates (development only)
+certs/
+
 # Test files and results
 test-formatted-output.js
 old-tests/
@@ -132,3 +135,7 @@ enhanced-prompt-demo.js
 test-spark-job.py
 verification-report.json
 state/dataproc-state.json
+config/*.json
+release-checklist.md
+test-oauth-endpoints.sh
+test-oauth-protocol-fix.js

.vscode/settings.json

@@ -1,5 +1,3 @@
 {
-    "files.associations": {
-        "*.yaml": "home-assistant"
-    }
+
 }

.vscode/tasks.json

@@ -1,31 +1,2 @@
 {
-  "version": "2.0.0",
-  "tasks": [
-    {
-      "label": "Start Dataproc MCP Server",
-      "type": "shell",
-      "command": "node",
-      "args": [
-        "${workspaceFolder}/build/index.js"
-      ],
-      "isBackground": true,
-      "problemMatcher": [],
-      "runOptions": {
-        "runOn": "folderOpen"
-      }
-    },
-    {
-      "label": "Build Dataproc MCP Server",
-      "type": "shell",
-      "command": "npm",
-      "args": [
-        "run",
-        "build"
-      ],
-      "group": {
-        "kind": "build",
-        "isDefault": true
-      }
-    }
-  ]
 }

README.md

@@ -84,6 +84,44 @@ npx @dipseth/dataproc-mcp-server@latest
    dataproc-mcp
    ```
 
+### 🌐 **Claude.ai Web App Compatibility**
+
+**✅ PRODUCTION-READY: Full Claude.ai Integration with HTTPS Tunneling & OAuth**
+
+The Dataproc MCP Server now provides **complete Claude.ai web app compatibility** with a working solution that includes all 22 MCP tools!
+
+#### 🚀 Working Solution (Tested & Verified)
+
+**Terminal 1 - Start MCP Server:**
+```bash
+DATAPROC_CONFIG_PATH=config/github-oauth-server.json npm start -- --http --oauth --port 8080
+```
+
+**Terminal 2 - Start Cloudflare Tunnel:**
+```bash
+cloudflared tunnel --url https://localhost:8443 --origin-server-name localhost --no-tls-verify
+```
+
+**Result**: Claude.ai can see and use all tools successfully! 🎉
+
+#### Key Features:
+- ✅ **Complete Tool Access** - All 22 MCP tools available in Claude.ai
+- ✅ **HTTPS Tunneling** - Cloudflare tunnel for secure external access
+- ✅ **OAuth Authentication** - GitHub OAuth for secure authentication
+- ✅ **Trusted Certificates** - No browser warnings or connection issues
+- ✅ **WebSocket Support** - Full WebSocket compatibility with Claude.ai
+- ✅ **Production Ready** - Tested and verified working solution
+
+#### Quick Setup:
+1. **Setup GitHub OAuth** (5 minutes)
+2. **Generate SSL certificates**: `npm run ssl:generate`
+3. **Start services** (2 terminals as shown above)
+4. **Connect Claude.ai** to your tunnel URL
+
+> **📖 Complete Guide:** See [`docs/claude-ai-integration.md`](docs/claude-ai-integration.md) for detailed setup instructions, troubleshooting, and advanced features.
+
+> **📖 Certificate Setup:** See [`docs/trusted-certificates.md`](docs/trusted-certificates.md) for SSL certificate configuration.
+
 ## ✨ Features
 
 ### 🎯 **Core Capabilities**

docs/API_REFERENCE.md

@@ -19,6 +19,8 @@ The Dataproc MCP Server provides 17 comprehensive tools organized into four cate
 
 ## Authentication
 
+For detailed authentication setup and best practices, refer to the [Authentication Implementation Guide](AUTHENTICATION_IMPLEMENTATION_GUIDE.md).
+
 All tools support intelligent default parameters. When `projectId` and `region` are not provided, the server automatically uses configured defaults from `config/default-params.json`.
 
 ## Cluster Management Tools