VS Code + GitHub Copilot

GitHub Copilot supports MCP servers in VS Code version 1.102 and higher, enabling Copilot to use external tools.

Prerequisites

• VS Code 1.102+ - Check your version: code --version
• GitHub Copilot extension - Install from the VS Code Marketplace

Configuration

VS Code uses project-level configuration only for MCP servers.

Scope	Location	Format
Project	.vscode/mcp.json	JSON

Note: VS Code uses servers (not mcpServers) as the key.

Choose the configuration based on whether you have the Desktop App or VS Code Extension installed.

Desktop App

If you have the SF Veritas Desktop App installed:

macOS

Create .vscode/mcp.json in your project root:

{
  "servers": {
    "sailfishTelemetry": {
      "command": "node",
      "args": ["/Applications/SF Veritas.app/Contents/Resources/app.asar.unpacked/dist/mcp-server/index.js"]
    }
  }
}

Windows

{
  "servers": {
    "sailfishTelemetry": {
      "command": "node",
      "args": ["%LOCALAPPDATA%\\Programs\\SF Veritas\\resources\\app.asar.unpacked\\dist\\mcp-server\\index.js"]
    }
  }
}

Linux

{
  "servers": {
    "sailfishTelemetry": {
      "command": "node",
      "args": ["/opt/SF Veritas/resources/app.asar.unpacked/dist/mcp-server/index.js"]
    }
  }
}

VS Code Extension

If you have the SF Veritas VS Code Extension installed:

macOS / Linux

Create .vscode/mcp.json in your project root:

{
  "servers": {
    "sailfishTelemetry": {
      "command": "bash",
      "args": ["-c", "node \"$(ls -d ~/.vscode/extensions/sailfish-ai.sf-veritas-extension-* 2>/dev/null | sort -V | tail -1)/dist/mcp-server-bundled.js\""]
    }
  }
}

This command:

• Uses glob pattern to find the extension (no hardcoded version)
• Sorts by version and picks the latest if multiple exist
• Uses bash -c to handle path expansion

Windows

{
  "servers": {
    "sailfishTelemetry": {
      "command": "cmd",
      "args": ["/c", "for /d %d in (%USERPROFILE%\\.vscode\\extensions\\sailfish-ai.sf-veritas-extension-*) do @node \"%d\\dist\\mcp-server-bundled.js\""]
    }
  }
}

Starting the MCP Server

MCP servers in VS Code don't start automatically by default. To start:

Option 1: From the config file

1. Open .vscode/mcp.json
2. Click the Start button that appears above the server config

Option 2: From Command Palette

1. Open Command Palette (Cmd+Shift+P)
2. Run "MCP: List Servers"
3. Click Start next to sailfishTelemetry

Auto-start Configuration

To start MCP servers automatically, add to your VS Code settings:

{
  "chat.mcp.autostart": true
}

Or via Settings UI:

1. Open Settings (Cmd+,)
2. Search for "mcp autostart"
3. Enable "Chat: Mcp Autostart"

Verification

After configuring, verify the connection:

1. Open Command Palette (Cmd+Shift+P)
2. Run "MCP: List Servers"
3. Check that sailfishTelemetry shows status Running
4. Open Output panel (View → Output)
5. Select "MCP" from the dropdown to see server logs

Usage

Once the server is running, use Copilot Chat to query telemetry:

> List my telemetry sessions
> Show me recent errors from my application
> What are the slowest functions in the codebase?
> Analyze the network requests to /api endpoints

GitHub Copilot will use the MCP tools to answer questions about your application's behavior.

Troubleshooting

"MCP: List Servers" shows no servers

1. Ensure .vscode/mcp.json exists in your project root
2. Verify JSON syntax is valid (note: use servers not mcpServers)
3. Reload VS Code window

Server won't start

1. Check that Node.js 18+ is installed
2. Desktop App: Verify the app is installed at the expected location
3. VS Code Extension: Verify the extension exists: ls ~/.vscode/extensions | grep sf-veritas
4. Check Output → "MCP" for error messages

"No telemetry data found"

1. Ensure your application has been instrumented with SF Veritas SDK
2. Run your application to generate telemetry data
3. Check that the database exists: ls ~/.sailfish/telemetry.db

VS Code version too old

MCP support requires VS Code 1.102+. Check your version:

code --version

Update VS Code if needed from code.visualstudio.com.