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 location and format depend on which assistant is currently active.

AssistantConfiguration Location
AIRGAP Assistant (Cline fork)%APPDATA%\AIRGAP Studio\User\globalStorage\airgap.airgap-assistant\settings\cline_mcp_settings.json (single file)
AIRGAP Lite Assistant (Continue fork)%USERPROFILE%\.continue\mcpServers\ directory (one *.json file per server)
Project-scoped settingsProject root\.vscode\mcp.json (when supported by the active assistant)

Project-scoped settings take priority over the same assistant's global settings. The two assistants do not share MCP servers, so to use the same server in both you must register it on each side separately.

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.