AIRGAP StudioAIRGAP Studio

Configuring MCP Servers

Editing and managing MCP server configuration files

Configuration File Location

MCP server settings are managed as JSON files. The file location depends on the scope.

ScopeFile Path
Global settings%APPDATA%\AIRGAP Studio\globalStorage\mcp-settings.json
Project settingsProject root\.vscode\mcp.json

Project settings take priority over global settings.

Editing the Configuration File

Opening from the Command Palette

  1. Press Ctrl+Shift+P to open the Command Palette.
  2. Search for MCP.
  3. Select the MCP: Edit Settings command.

Manual Editing

You can open the configuration file directly and edit the JSON manually.

Configuration Format

Basic Structure

{
  "mcpServers": {
    "server-name": {
      "command": "executable command",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR": "value"
      },
      "disabled": false
    }
  }
}

Configuration Fields

FieldTypeDescriptionRequired
commandstringServer executable path or commandRequired
argsstring[]Array of arguments to pass to the commandOptional
envobjectEnvironment variables to set for the server processOptional
disabledbooleanIf true, the server will not be loadedOptional

Configuration Examples

Node.js MCP Server

{
  "mcpServers": {
    "file-tools": {
      "command": "node",
      "args": ["C:/mcp-servers/file-tools/index.js"],
      "disabled": false
    }
  }
}

Python MCP Server

{
  "mcpServers": {
    "data-analyzer": {
      "command": "python",
      "args": ["C:/mcp-servers/data-analyzer/server.py"],
      "env": {
        "PYTHONPATH": "C:/mcp-servers/data-analyzer"
      }
    }
  }
}

Multiple Servers

{
  "mcpServers": {
    "file-tools": {
      "command": "node",
      "args": ["C:/mcp-servers/file-tools/index.js"]
    },
    "db-connector": {
      "command": "node",
      "args": ["C:/mcp-servers/db-connector/index.js"],
      "env": {
        "DB_PATH": "C:/data/local.db"
      }
    },
    "unused-server": {
      "command": "node",
      "args": ["C:/mcp-servers/unused/index.js"],
      "disabled": true
    }
  }
}

Server Management

Adding a Server

  1. Add a new entry to the mcpServers object in the configuration file.
  2. Save the file.
  3. AIRGAP Assistant will automatically detect and start the new server.

Removing a Server

Delete the server entry from the configuration file, or set "disabled": true to deactivate it.

Checking Server Status

You can check the connection status of each server in the MCP section of the AIRGAP Assistant settings panel.

  • Connected: The server is running normally
  • Disconnected: The server is not connected
  • Error: An error occurred while starting the server

Air-Gapped Environment Considerations

When using MCP servers in an air-gapped environment, keep the following in mind:

  • Server executables and all dependencies must be pre-installed locally.
  • For servers that require npm install, prepare offline packages in advance.
  • Servers that call external APIs will not work in an air-gapped environment.