Simplify MCP template (#84)

* Use correct Inspector task info

* Add in a router configuration

We should put new use cases on the latest connectors to get feedback

* Standardize on port 5000

* All mutations should require confirmation

* Simplify settings for VS Code

* remove claude desktop config

* Use port 5000

* Remove duplicative README

* feat(add-mcp): Revert MCP server port from 5000 to 5050

* feat(add-mcp): Update MCP README to reflect removal of Claude Desktop configuration

* feat(add-mcp): Update port to 5050

* feat(add-mcp): Replace mcp-claude shortlink

---------

Co-authored-by: Camille Lawrence <[email protected]>

Author: michael-watson

add-mcp/.apollo/mcp.local.yaml

@@ -4,6 +4,7 @@
 # Working local configuration:
 overrides:
   mutation_mode: all
+  require_confirmation: true    # Confirmation required for mutations
 operations:
   source: collection
   id: default                   # localhost:4000 in browser → Sandbox → Collections → Create operations for MCP tools

add-mcp/.apollo/mcp.staging.yaml

@@ -4,7 +4,7 @@
 # Working staging configuration:
 overrides:
   mutation_mode: all
-  require_confirmation: true    # Confirmation required for mutations in staging
+  require_confirmation: true    # Confirmation required for mutations
 operations:
   source: collection
   id: default                   # GraphQL endpoint in browser → Sandbox → Collections → Create operations for MCP tools

add-mcp/.vscode/settings.json

@@ -6,11 +6,11 @@
   // This file configures VS Code to provide excellent GraphQL development
   // experience when creating MCP tools. It enables syntax highlighting,
   // auto-completion, schema validation, and more for GraphQL files.
-  
+
   // ==========================================================================
   // GRAPHQL LANGUAGE SUPPORT
   // ==========================================================================
-  
+
   // Associate files with their appropriate languages
   "files.associations": {
     "*.graphql": "graphql",
@@ -31,71 +31,27 @@
     "editor.formatOnType": true,
     "editor.wordWrap": "bounded",
     "editor.wordWrapColumn": 100,
-    
+
     // Enable semantic highlighting for GraphQL
     "editor.semanticHighlighting.enabled": true,
-    
+
     // Show suggestions while typing
     "editor.quickSuggestions": {
       "other": true,
       "comments": false,
       "strings": true
     },
-    
+
     // Auto-complete brackets and quotes
     "editor.autoClosingBrackets": "always",
     "editor.autoClosingQuotes": "always",
     "editor.autoSurround": "languageDefined"
   },
 
-  // ==========================================================================
-  // GRAPHQL EXTENSION CONFIGURATION
-  // ==========================================================================
-  
-  // GraphQL Language Server configuration
-  "graphql.introspect": {
-    // Your GraphQL endpoint for schema introspection
-    "endpoint": "{{GRAPHQL_ENDPOINT}}",
-    
-    // Headers for authentication (if required)
-    "headers": {
-      // "Authorization": "Bearer {{AUTH_TOKEN}}"
-      // "X-API-Key": "{{API_KEY}}"
-    }
-  },
-
-  // GraphQL validation and linting
-  "graphql.validate": true,
-  "graphql.lint": {
-    "enable": true,
-    "rules": {
-      // Enforce operation naming
-      "operations-without-names": "error",
-      
-      // Enforce field selection
-      "fields-without-selections": "error",
-      
-      // Warn about unused variables
-      "unused-variables": "warn",
-      
-      // Warn about undefined variables
-      "undefined-variables": "error",
-      
-      // Enforce proper fragment usage
-      "unused-fragments": "warn"
-    }
-  },
-
-  // Enable auto-completion from GraphQL schema
-  "graphql.autocomplete": {
-    "enable": true,
-    "showDeprecated": true
-  },
-
   // ==========================================================================
   // FILE EXPLORER CONFIGURATION
   // ==========================================================================
-  
+
   // Group GraphQL files in explorer
   "explorer.fileNesting.enabled": true,
   "explorer.fileNesting.patterns": {
@@ -112,7 +68,7 @@
   // ==========================================================================
   // EDITOR ENHANCEMENTS FOR MCP DEVELOPMENT
   // ==========================================================================
-  
+
   // Enable breadcrumbs for navigation
   "breadcrumbs.enabled": true,
   "breadcrumbs.showFiles": true,
@@ -130,7 +86,7 @@
   // ==========================================================================
   // SEARCH AND FIND CONFIGURATION
   // ==========================================================================
-  
+
   // Include GraphQL files in search
   "search.include": {
     "**/*.graphql": true,
@@ -139,15 +95,6 @@
     ".apollo/**": true
   },
 
-  // Exclude node_modules and build artifacts
-  "search.exclude": {
-    "**/node_modules": true,
-    "**/dist": true,
-    "**/build": true,
-    "**/.git": true,
-    "**/coverage": true
-  },
-
   // ==========================================================================
   // YAML CONFIGURATION FOR APOLLO CONFIG FILES
   // ==========================================================================
@@ -187,11 +134,10 @@
     ]
   },
 
-
   // ==========================================================================
   // DOCKERFILE CONFIGURATION
   // ==========================================================================
-  
+
   // Configure Docker file settings
   "[dockerfile]": {
     "editor.quickSuggestions": {
@@ -200,11 +146,10 @@
     "editor.formatOnSave": true
   },
 
-
   // ==========================================================================
   // JSON CONFIGURATION FOR CONFIG FILES
   // ==========================================================================
-  
+
   // Configure JSON files (like Claude Desktop config)
   "[json]": {
     "editor.tabSize": 2,
@@ -224,130 +169,41 @@
   // ==========================================================================
   // INTEGRATED TERMINAL CONFIGURATION
   // ==========================================================================
-  
-  // Configure terminal for MCP development workflow
+
+  // Configure terminal for Apollo Key and Graph Ref
   "terminal.integrated.cwd": "${workspaceFolder}",
-  "terminal.integrated.env.osx": {},
-  "terminal.integrated.env.linux": {},
-  "terminal.integrated.env.windows": {},
-
-  // Add common MCP development tasks to terminal profiles
-  "terminal.integrated.profiles.osx": {
-    "MCP Development": {
-      "path": "/bin/bash",
-      "args": [
-        "-c",
-        "echo 'MCP Development Environment'; echo 'Available commands:'; echo '  docker build -f mcp.Dockerfile -t mcp-server .'; echo '  docker run -p 5050:5050 --env-file .env mcp-server'; echo '  npx @mcp/inspector --port 5050'; echo ''; exec bash"
-      ]
-    },
-    "graphos": {
-      "path": "zsh",
-      "args": ["-l"],
-      "env": {
-        "APOLLO_KEY": "{{APOLLO_KEY}}",
-        "APOLLO_GRAPH_REF": "{{APOLLO_GRAPH_REF}}",
-      }
-    }
+  "terminal.integrated.env.osx": {
+    "APOLLO_KEY": "{{APOLLO_KEY}}",
+    "APOLLO_GRAPH_REF": "{{APOLLO_GRAPH_REF}}"
+  },
+  "terminal.integrated.env.linux": {
+    "APOLLO_KEY": "{{APOLLO_KEY}}",
+    "APOLLO_GRAPH_REF": "{{APOLLO_GRAPH_REF}}"
+  },
+  "terminal.integrated.env.windows": {
+    "APOLLO_KEY": "{{APOLLO_KEY}}",
+    "APOLLO_GRAPH_REF": "{{APOLLO_GRAPH_REF}}"
   },
-  "terminal.integrated.defaultProfile.osx": "graphos",
 
   // ==========================================================================
   // TASKS AND DEBUGGING CONFIGURATION
   // ==========================================================================
-  
+
   // Enable problem matcher for GraphQL validation
   "problems.decorations.enabled": true,
   "problems.showCurrentInStatus": true,
 
   // Configure git integration for GraphQL files
   "git.decorations.enabled": true,
   "scm.diffDecorations": "all",
-  
-  // ==========================================================================
-  // WORKSPACE-SPECIFIC SETTINGS
-  // ==========================================================================
-  
-  // Workspace trust settings
-  "security.workspace.trust.untrustedFiles": "open",
-  
-  // Auto-save settings for development
-  "files.autoSave": "onWindowChange",
-  "files.autoSaveDelay": 1000,
-
-  // Enable hot reload feedback
-  "files.watcherExclude": {
-    "**/node_modules/**": true,
-    "**/dist/**": true,
-    "**/coverage/**": true
-  },
-
-  // ==========================================================================
-  // DEVELOPMENT WORKFLOW ENHANCEMENTS
-  // ==========================================================================
-  
-  // Enable emmet for GraphQL (useful for quick field selection)
-  "emmet.includeLanguages": {
-    "graphql": "css"
-  },
-
-  // Configure auto-rename for consistency
-  "editor.linkedEditing": true,
-
-  // Enable parameter hints for GraphQL variables
-  "editor.parameterHints.enabled": true,
-  "editor.parameterHints.cycle": true,
-
-  // ==========================================================================
-  // CUSTOM SNIPPETS SUPPORT
-  // ==========================================================================
-  
-  // These settings enable custom GraphQL snippets
-  "editor.snippetSuggestions": "top",
-  "editor.suggest.snippetsPreventQuickSuggestions": false,
-
-  // ==========================================================================
-  // ERROR AND WARNING DISPLAY
-  // ==========================================================================
-  
-  // Configure how GraphQL errors are displayed
-  "problems.sortOrder": "severity",
-  "editor.gotoLocation.multipleDefinitions": "goto",
-  "editor.gotoLocation.multipleReferences": "goto",
-
-  // ==========================================================================
-  // FORMATTING AND LINTING
-  // ==========================================================================
-  
-  // Enable format on paste for GraphQL
-  "editor.formatOnPaste": true,
-  
-  // Configure rulers for GraphQL query readability
-  "editor.rulers": [80, 120],
-
-  // ==========================================================================
-  // MINIMAP CONFIGURATION
-  // ==========================================================================
-  
-  // Configure minimap for better navigation of large GraphQL files
-  "editor.minimap.enabled": true,
-  "editor.minimap.maxColumn": 120,
-  "editor.minimap.renderCharacters": false,
-
-  // ==========================================================================
-  // INTELLISENSE CONFIGURATION
-  // ==========================================================================
-  
-  // Enhanced IntelliSense for GraphQL development
-  "editor.suggestSelection": "first",
-  "vsintellicode.modify.editor.suggestSelection": "automaticallyOverrodeDefaultValue",
 
   // ==========================================================================
   // COMMENTS AND DOCUMENTATION
   // ==========================================================================
-  
+
   // Better comment highlighting in GraphQL files
   "editor.comments.insertSpace": true,
   "files.trimTrailingWhitespace": true,
   "files.trimFinalNewlines": true,
   "files.insertFinalNewline": true
-}
+}

add-mcp/.vscode/tasks.json

@@ -10,6 +10,8 @@
         "dev",
         "--supergraph-config",
         "supergraph.yaml",
+        "--router-config",
+        "router.yaml",
         "--mcp",
         ".apollo/mcp.local.yaml"
       ],
@@ -28,7 +30,7 @@
       // Opens MCP inspector UI in browser to test your AI tools
       "label": "Test MCP Tools",
       "command": "npx",
-      "args": ["@mcp/inspector", "--port", "5050"],
+      "args": ["@modelcontextprotocol/inspector", "--transport", "http", "--server-url", "http://localhost:5050/mcp"],
       "type": "shell"
     }
   ]