Guide: Sätt upp MCP i Cursor steg-för-steg

Cursor har förstklassigt stöd för Model Context Protocol och är en av de snabbaste vägarna att låta AI:n läsa din kod, dina databaser och externa API:er utan att lämna editorn. Den här guiden tar dig från tom installation till en fungerande MCP-server på under tio minuter — och förklarar varje rad i mcp.json så du vet vad du gör.

Vad du behöver

• Cursor 0.45 eller senare (senaste stable rekommenderas — MCP-UI:t har ändrats flera gånger under 2026).
• Node.js 18+ för npx-baserade servrar, alternativt Python 3.10+ med uv/uvx.
• En texteditor — du kan editera mcp.json direkt i Cursor.
• Ev. API-nycklar för de servrar du vill koppla in (t.ex. GitHub PAT, DATABASE_URL).

Hitta mcp.json i Cursor

Cursor läser två filer och slår ihop dem. Global config gäller överallt, per-projekt-config läggs i projektroten och prioriteras vid konflikt.

1. Öppna Cursor och gå till Settings (Cmd/Ctrl + ,).
2. Välj fliken MCP i vänsterspalten.
3. Klicka på Add new global MCP server. Cursor öppnar ~/.cursor/mcp.json direkt i editorn och skapar filen om den saknas.
4. För projekt-scoped config: skapa mappen .cursor/ i projektroten och en fil mcp.json inuti. Cursor plockar upp den automatiskt.

Konfig-filen steg-för-steg

mcp.json är vanlig JSON med en enda nyckel på översta nivån: mcpServers. Varje sub-nyckel är ett fritt namn du väljer och värdet beskriver hur Cursor ska starta servern.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/dittnamn/kod"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx"
      }
    },
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "${env:DATABASE_URL}"
      ]
    }
  }
}

• command — binären som körs (npx, uvx, node, python, docker).
• args — array med argument som skickas till command. Använd absoluta sökvägar, inte ~/.
• env — valfritt objekt med miljövariabler. Perfekt för API-nycklar.
• ${env:VAR} — Cursor expanderar mot din shell-miljö, så du slipper committa hemligheter.

Global vs per-projekt

Global config är bra för verktyg du alltid vill ha (GitHub, filesystem). Per-projekt-config checkas in i git och ger hela teamet samma verktygsuppsättning — utan hemligheter, som läggs i .env och referenseras via ${env:VAR}.

Verifiera att det fungerar i Composer

1. Spara mcp.json och stäng eventuella öppna Composer-sessioner.
2. Öppna Settings → MCP. Varje server ska ha en grön prick och listad tool-count.
3. Öppna Composer (Cmd/Ctrl + I) och klicka på verktygs-ikonen — du ska se dina servrar listade.
4. Testa med en prompt som tvingar användning: ”Lista alla filer i mappen jag konfigurerade och sammanfatta dem.” Composer ska be om godkännande att köra list_directory.

Felsökning

Servern visas inte i Settings → MCP

• Validera JSON — en saknad komma räcker för att Cursor tyst ska ignorera hela filen. Klistra in i jsonlint.com om du är osäker.
• Kontrollera att du redigerade rätt fil: global ligger i ~/.cursor/mcp.json, inte ~/.config/cursor/.
• Klicka på refresh-ikonen i MCP-vyn — Cursor läser om filen utan omstart.

Röd prick / ”failed to start”

• Kör kommandot manuellt i terminalen (t.ex. npx -y @modelcontextprotocol/server-filesystem /path) och verifiera att det startar utan fel.
• På macOS: Cursor ärver inte alltid PATH från din shell. Använd absolut sökväg till binären, t.ex. /opt/homebrew/bin/npx.
• På Windows: escapa backslashes i sökvägar (\\) eller använd forward slashes.
• Node-baserade servrar kräver Node 18+ — kontrollera med node --version.

Verktygen visas men Composer använder dem inte

• Composer väljer verktyg baserat på beskrivningar. Formulera prompten tydligt: ”använd Postgres-MCP för att köra SQL”.
• Slå av oanvända MCP-servrar i Settings — färre alternativ = snabbare och mer träffsäkert val.
• Lägg en Cursor Rule (.cursor/rules) som styr när ett verktyg ska användas.

Env-variabler expanderas inte

• ${env:VAR} kräver att variabeln finns i miljön som Cursor startades i. Starta Cursor från terminalen efter att du satt variabeln.
• På macOS kan du sätta variabler globalt i ~/.zshenv (inte ~/.zshrc) så att GUI-appar ser dem.
• Alternativt: lägg värdet direkt i env-blocket för snabb testning — men committa aldrig hemligheter.

FAQ