feat(all): add user configuration support in installation process

Author: Lasim

services/backend/api-spec.json

@@ -20952,13 +20952,27 @@
                     },
                     "description": "Team-level shared URL query parameters"
                   },
+                  "user_args": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "string"
+                    },
+                    "description": "User-level argument mappings (placeholder -> actual value)"
+                  },
                   "user_environment_variables": {
                     "type": "object",
                     "additionalProperties": {
                       "type": "string"
                     },
                     "description": "User-level environment variables"
                   },
+                  "user_headers": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "string"
+                    },
+                    "description": "User-level HTTP headers (optional)"
+                  },
                   "user_url_query_params": {
                     "type": "object",
                     "additionalProperties": {

services/backend/api-spec.yaml

@@ -14769,11 +14769,21 @@ paths:
                   additionalProperties:
                     type: string
                   description: Team-level shared URL query parameters
+                user_args:
+                  type: object
+                  additionalProperties:
+                    type: string
+                  description: User-level argument mappings (placeholder -> actual value)
                 user_environment_variables:
                   type: object
                   additionalProperties:
                     type: string
                   description: User-level environment variables
+                user_headers:
+                  type: object
+                  additionalProperties:
+                    type: string
+                  description: User-level HTTP headers (optional)
                 user_url_query_params:
                   type: object
                   additionalProperties:

services/backend/src/routes/mcp/installations/create.ts

@@ -2,6 +2,7 @@ import { type FastifyInstance } from 'fastify';
 import { requireAuthenticationAny, requireOAuthScope } from '../../../middleware/oauthMiddleware';
 import { requireTeamPermission } from '../../../middleware/roleMiddleware';
 import { McpInstallationService } from '../../../services/mcpInstallationService';
+import { McpUserConfigurationService } from '../../../services/mcpUserConfigurationService';
 import { SatelliteCommandService } from '../../../services/satelliteCommandService';
 import { getDb } from '../../../db';
 import {
@@ -102,6 +103,42 @@ export default async function createInstallationRoute(server: FastifyInstance) {
         serverId: installationData.server_id
       }, 'MCP server installation created successfully');
 
+      // Check if user config data was provided and create user configuration
+      const hasUserConfig =
+        (installationData.user_args && Object.keys(installationData.user_args).length > 0) ||
+        (installationData.user_environment_variables && Object.keys(installationData.user_environment_variables).length > 0) ||
+        (installationData.user_headers && Object.keys(installationData.user_headers).length > 0) ||
+        (installationData.user_url_query_params && Object.keys(installationData.user_url_query_params).length > 0);
+
+      if (hasUserConfig) {
+        try {
+          const userConfigService = new McpUserConfigurationService(db, request.log);
+          await userConfigService.createUserConfiguration(
+            installation.id,
+            userId,
+            teamId,
+            {
+              user_args: installationData.user_args,
+              user_env: installationData.user_environment_variables,
+              user_headers: installationData.user_headers,
+              user_url_query_params: installationData.user_url_query_params
+            }
+          );
+          request.log.info({
+            operation: 'create_mcp_installation',
+            installationId: installation.id,
+            userId
+          }, 'User configuration created during installation');
+        } catch (userConfigError) {
+          // Log but don't fail - team installation succeeded
+          request.log.warn({
+            operation: 'create_mcp_installation',
+            installationId: installation.id,
+            error: userConfigError instanceof Error ? userConfigError.message : 'Unknown error'
+          }, 'Failed to create user configuration during installation');
+        }
+      }
+
       // Create satellite commands for immediate notification (3-second response goal)
       try {
         const satelliteCommandService = new SatelliteCommandService(db, request.log);

services/backend/src/routes/mcp/installations/schemas.ts

@@ -119,11 +119,21 @@ export const CREATE_INSTALLATION_REQUEST_SCHEMA = {
       additionalProperties: { type: 'string' },
       description: 'Team-level shared URL query parameters'
     },
+    user_args: {
+      type: 'object',
+      additionalProperties: { type: 'string' },
+      description: 'User-level argument mappings (placeholder -> actual value)'
+    },
     user_environment_variables: {
       type: 'object',
       additionalProperties: { type: 'string' },
       description: 'User-level environment variables'
     },
+    user_headers: {
+      type: 'object',
+      additionalProperties: { type: 'string' },
+      description: 'User-level HTTP headers (optional)'
+    },
     user_url_query_params: {
       type: 'object',
       additionalProperties: { type: 'string' },
@@ -610,7 +620,9 @@ export interface CreateInstallationRequest {
   team_env?: Record<string, string>;
   team_headers?: Record<string, string>;
   team_url_query_params?: Record<string, string>;
+  user_args?: Record<string, string>;
   user_environment_variables?: Record<string, string>;
+  user_headers?: Record<string, string>;
   user_url_query_params?: Record<string, string>;
 }