Google Search Console MCP Server

# ✅ Deployment Complete - GSC MCP Cloud Server ## 🚀 Your Server is Live! **Production URL:** https://gsc-mcp-cloud.principal-e85.workers.dev **Version ID:** aef62a34-61ec-4014-836a-4c3eacaab448 --- ## 📡 Verified Endpoints All endpoints are working correctly: ### Main Page 🌐 https://gsc-mcp-cloud.principal-e85.workers.dev/ ### Health Check ✅ https://gsc-mcp-cloud.principal-e85.workers.dev/health **Response:** ```json { "status": "healthy", "service": "gsc-mcp-cloud", "version": "1.0.0", "timestamp": "2025-10-08T17:21:03.075Z" } ``` ### MCP Endpoints - **Main MCP:** https://gsc-mcp-cloud.principal-e85.workers.dev/mcp-sse - **Direct:** https://gsc-mcp-cloud.principal-e85.workers.dev/mcp-direct - **SSE (for ChatGPT):** https://gsc-mcp-cloud.principal-e85.workers.dev/sse/ --- ## 🔧 Available Tools ### 1. `search` Tool Search for GSC documents and reports. **Test Command:** ```bash curl -X POST https://gsc-mcp-cloud.principal-e85.workers.dev/mcp-sse \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "search", "arguments": { "query": "performance" } } }' ``` **Response:** ```json { "results": [ { "id": "performance-overview", "title": "Performance Overview - Last 28 Days", "url": "https://search.google.com/search-console/performance" } ] } ``` ### 2. `fetch` Tool Retrieve complete document content. **Test Command:** ```bash curl -X POST https://gsc-mcp-cloud.principal-e85.workers.dev/mcp-sse \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "fetch", "arguments": { "id": "performance-overview" } } }' ``` **Returns:** Full document with title, text content, URL, and metadata. --- ## 🤖 Connect to ChatGPT ### Step 1: Copy Your SSE URL ``` https://gsc-mcp-cloud.principal-e85.workers.dev/sse/ ``` ⚠️ **Important:** The URL must end with `/sse/` ### Step 2: Add to ChatGPT 1. Open [ChatGPT Settings](https://chatgpt.com/#settings) 2. Go to **Connectors** tab 3. Click **Add Connector** or **Import MCP Server** 4. Paste your URL: `https://gsc-mcp-cloud.principal-e85.workers.dev/sse/` 5. Save ### Step 3: Test in ChatGPT Try these prompts: - "Search for GSC performance data" - "Fetch the performance-overview document" - "Show me indexing status information" --- ## 🔗 Using with OpenAI API ### Deep Research Example ```bash curl https://api.openai.com/v1/responses \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -d '{ "model": "o4-mini-deep-research", "input": [ { "role": "user", "content": [ { "type": "input_text", "text": "Analyze my website performance trends from GSC" } ] } ], "tools": [ { "type": "mcp", "server_label": "gsc-data", "server_url": "https://gsc-mcp-cloud.principal-e85.workers.dev/sse/", "allowed_tools": ["search", "fetch"], "require_approval": "never" } ] }' ``` --- ## 📊 Available Mock Data The server currently returns demonstration data for: 1. **performance-overview** - Performance metrics and trends 2. **top-queries** - Search query performance data 3. **indexing-status** - Page indexing information 4. **sitemap-status** - Sitemap submission status --- ## 🔄 Update & Redeploy To make changes and redeploy: ```bash # Make your code changes in src/ # Test locally first npm run dev # Deploy updates npx wrangler deploy ``` --- ## 📈 Monitor Your Server ### View Real-Time Logs ```bash npx wrangler tail ``` ### Cloudflare Dashboard https://dash.cloudflare.com/ Go to: **Workers & Pages** → **gsc-mcp-cloud** → **Logs** --- ## 🎯 Next Steps ### For Production Use: 1. **Add Real GSC API Integration** - Implement Google Search Console API calls - Replace mock data with live GSC data 2. **Add Authentication** - Implement OAuth 2.0 flow - Add token management and auto-refresh - Store credentials in Workers KV 3. **Expand Tools** - Add URL inspection tools - Add sitemap management tools - Add search analytics tools - Add indexing status tools 4. **Improve Error Handling** - Better error messages - Retry logic for API failures - Graceful degradation 5. **Add Caching** - Cache GSC API responses - Use Workers KV for caching - Reduce API call frequency 6. **Monitor & Optimize** - Set up alerts for errors - Monitor API usage - Optimize response times --- ## 🛠️ Troubleshooting ### Server Not Responding ```bash # Check server status curl https://gsc-mcp-cloud.principal-e85.workers.dev/health # View logs npx wrangler tail ``` ### ChatGPT Connection Issues 1. Verify URL ends with `/sse/` 2. Test endpoint directly with curl 3. Check Cloudflare Workers status ### Update Not Showing ```bash # Clear browser cache # Wait 2-3 minutes for global propagation # Check version ID after deploy ``` --- ## 📚 Resources - **Your Server:** https://gsc-mcp-cloud.principal-e85.workers.dev/ - **OpenAI MCP Docs:** https://platform.openai.com/docs/mcp - **Cloudflare Dashboard:** https://dash.cloudflare.com/ - **MCP Protocol:** https://modelcontextprotocol.io/ --- ## ✨ Status: DEPLOYED & VERIFIED - ✅ Server deployed to Cloudflare Workers - ✅ Health endpoint responding - ✅ Tools list endpoint working - ✅ Search tool tested and working - ✅ Fetch tool tested and working - ✅ SSE streaming functional - ✅ CORS headers configured - ✅ Ready for ChatGPT integration - ✅ Ready for OpenAI API usage **Deployment Date:** October 8, 2025 **Account:** principal@berelvant.com **Region:** Global (Cloudflare Edge Network) --- **🎉 Your MCP Server is live and ready to use!**