Skip to main content

Visual Studio Code

VS Code MCP Integration

VS Code with GitHub Copilot supports MCP servers natively. For detailed configuration instructions, visit the official documentation.

Option 1: GitHub Copilot MCP Integration​

VS Code with GitHub Copilot supports MCP servers natively. Configure in your workspace or user settings:

Workspace Configuration (.vscode/mcp.json)​

{
  "servers": {
    "timbr": {
      "type": "http",
      "url": "https://<your-timbr-server>/timbr/api/mcp/",
      "headers": {
        "x-api-key": "${env:TIMBR_API_KEY}"
      }
    }
  }
}

With Default Agent​

{
  "servers": {
    "timbr": {
      "type": "http",
      "url": "https://<your-timbr-server>/timbr/api/mcp/",
      "headers": {
        "x-api-key": "${env:TIMBR_API_KEY}",
        "x-agent": "agent_name"
      }
    }
  }
}

With Default Ontology​

{
  "servers": {
    "timbr": {
      "type": "http",
      "url": "https://<your-timbr-server>/timbr/api/mcp/",
      "headers": {
        "x-api-key": "${env:TIMBR_API_KEY}",
        "x-ontology": "my_ontology"
      }
    }
  }
}

User Settings Configuration​

Add to your VS Code settings.json:

{
  "github.copilot.chat.mcp.servers": {
    "timbr": {
      "type": "http",
      "url": "https://<your-timbr-server>/timbr/api/mcp/",
      "headers": {
        "x-api-key": "${env:TIMBR_API_KEY}",
        "x-ontology": "my_ontology"
      }
    }
  }
}

Option 2: Generic MCP Extension​

If using a third-party MCP extension, create a configuration file as specified by the extension. Most extensions support a similar format:

With Agent​

{
  "mcpServers": {
    "timbr": {
      "transport": "http",
      "url": "https://<your-timbr-server>/timbr/api/mcp/",
      "headers": {
        "x-api-key": "tk_your_api_key_here",
        "x-agent": "agent_name"
      }
    }
  }
}

With Ontology​

{
  "mcpServers": {
    "timbr": {
      "transport": "http",
      "url": "https://<your-timbr-server>/timbr/api/mcp/",
      "headers": {
        "x-api-key": "tk_your_api_key_here",
        "x-ontology": "my_ontology"
      }
    }
  }
}

Environment Variable Setup (Windows)​

Set the API key as an environment variable:

# PowerShell (current session)
$env:TIMBR_API_KEY = "tk_your_api_key_here"

# PowerShell (permanent - user level)
[Environment]::SetEnvironmentVariable("TIMBR_API_KEY", "tk_your_api_key_here", "User")

Environment Variable Setup (macOS/Linux)​

# Current session
export TIMBR_API_KEY="tk_your_api_key_here"

# Permanent (add to ~/.bashrc or ~/.zshrc)
echo 'export TIMBR_API_KEY="tk_your_api_key_here"' >> ~/.zshrc