Guide: Installera och konfigurera MCP i VS Code

VS Code fick förstklassigt MCP-stöd via GitHub Copilot Chat under 2025 och har sedan dess blivit ett av de mest använda sätten att köra Model Context Protocol i vardagen. Den här guiden tar dig från noll till en fungerande MCP-server i VS Code på under tio minuter — inklusive workspace-config för teamet, konkreta JSON-exempel och verifiering i Agent Mode.

Vad du behöver

• VS Code 1.99+ (rekommenderat: senaste stable — MCP-UI:t har vuxit snabbt).
• GitHub Copilot-tillägget installerat och inloggat — MCP-verktyg exponeras via Copilot Chat Agent Mode.
• Node.js 18+ för npx-baserade servrar, alternativt Python 3.10+ med uv/uvx.
• Ev. API-nycklar för de servrar du vill koppla in (t.ex. GitHub PAT, DATABASE_URL).

Hitta mcp.json i VS Code

VS Code stöder två scope: workspace (checkas in i git och delas med teamet) och user (personlig, gäller alla dina projekt). Configen ligger i mcp.json i båda fallen.

1. Öppna Command Palette (Cmd/Ctrl + Shift + P).
2. Kör MCP: Open Workspace Configuration — VS Code skapar .vscode/mcp.json i projektroten om den saknas.
3. För personlig config: kör MCP: Open User Configuration istället — VS Code öppnar din globala mcp.json.
4. Alternativt: kör MCP: Add Server och välj typ (npx, uvx, docker, HTTP) — VS Code skriver in ett giltigt block åt dig.

Konfig-filen steg-för-steg

VS Codes format skiljer sig något från Cursor/Claude: nyckeln heter servers (inte mcpServers) och du kan deklarera inputs som VS Code frågar efter vid första start — perfekt för API-nycklar som inte ska ligga i git.

{
  "inputs": [
    {
      "id": "github-pat",
      "type": "promptString",
      "description": "GitHub personal access token",
      "password": true
    }
  ],
  "servers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "${workspaceFolder}"
      ]
    },
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github-pat}"
      }
    },
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "${env:DATABASE_URL}"
      ]
    },
    "linear-remote": {
      "type": "http",
      "url": "https://mcp.linear.app/mcp"
    }
  }
}

• type — stdio för lokala kommandon, http eller sse för fjärrservrar.
• command + args — hur den lokala servern startas. Använd absoluta sökvägar, inte ~/.
• env — miljövariabler som skickas till processen.
• ${workspaceFolder} — expanderas till projektroten. ${env:VAR} läser från shell-miljön. ${input:id} frågar användaren vid första start och cachas säkert.

Workspace vs user

Workspace-config (.vscode/mcp.json) checkas in i git och ger teamet identisk verktygsuppsättning. Hemligheter läggs aldrig direkt i filen — använd inputs eller ${env:VAR}. User-config är personlig och passar för verktyg du alltid vill ha (GitHub, filesystem). Vid konflikt vinner workspace-configen.

Verifiera anslutningen

1. Spara mcp.json. VS Code startar servrarna automatiskt och visar en Start/Restart-knapp ovanför varje server-block.
2. Öppna Copilot Chat (Cmd/Ctrl + Alt + I) och växla läge till Agent längst upp.
3. Klicka på verktygs-ikonen (tools) i chattens verktygsrad — dina MCP-servrar ska listas med tool-count.
4. Kör MCP: List Servers i Command Palette för att se status, logg och senaste fel per server.
5. Testa med en prompt som tvingar användning: ”Lista filerna i workspace och sammanfatta README.” Agent Mode ska be om godkännande att köra list_directory.

Felsökning

Servern startar inte / röd status i MCP: List Servers

• Validera JSON — en saknad komma räcker för att VS Code ska hoppa över hela filen. VS Code visar syntaxfel i editorn; åtgärda dem först.
• Kör kommandot manuellt i integrerad terminal (t.ex. npx -y @modelcontextprotocol/server-filesystem .) och verifiera att det startar utan fel.
• Klicka Show Output i MCP: List Servers-vyn — stderr från servern skrivs där.
• På macOS: VS Code ärver inte alltid full PATH. Ange absolut sökväg till binären (t.ex. /opt/homebrew/bin/npx) eller starta VS Code från terminalen med code .

Servern körs men verktygen syns inte

• Kontrollera att du är i Agent Mode — Ask/Edit exponerar inte MCP-tools.
• Klicka Refresh i tools-panelen — VS Code cachar tool-listan tills servern startas om.
• Vissa servrar exponerar tools först efter att en resurs valts (t.ex. GitHub kräver repo-kontext). Läs serverns README.

Inputs frågas inte / gamla värden fastnar

• Kör MCP: Reset Cached Inputs i Command Palette för att tvinga fram ny prompt.
• Inputs lagras i OS-nyckelringen (Keychain/Credential Manager) — rensa där om värdet inte kan uppdateras.
• Använd promptString med password: true för hemligheter så att de maskas i UI:t.

HTTP-server ansluter inte

• Kontrollera URL:en — spec kräver Streamable HTTP-endpoint (POST + SSE på samma URL).
• Om servern kräver OAuth: VS Code öppnar auth-flödet automatiskt i webbläsaren. Godkänn och gå tillbaka.
• Bakom företagsproxy: sätt http.proxy i VS Code settings, annars blockeras utgående anrop.

FAQ