Workbranch › Guider
GuideSå ansluter du MCP-servrar till Claude Code
MCP-servrar ger Claude Code tillgång till verktyg utanför din kod, till exempel ett ärendesystem, en databas eller ett designverktyg. Den här guiden visar kommandona för att lägga till en server, var inställningen sparas, hur du loggar in och hur du ser om den fungerar.
Snabbt svar: för en fjärrserver kör du claude mcp add --transport http name https://server/mcp; för en lokal kör du claude mcp add name -- command args. Lägg till --scope user för att använda den i alla projekt eller --scope project för att dela den via .mcp.json. Öppna sedan Claude Code, skriv /mcp för att logga in vid behov och kontrollera att servern visas som ansluten.
Kommandona nedan följer Anthropics dokumentation för Claude Code i oktober 2026. Du kör claude mcp-kommandona i din vanliga terminal, inte i en Claude Code-session.
Lägg till en fjärrserver (vanligast)
En hostad tjänst ger dig en webbadress till sin MCP-server, som du hittar i tjänstens egna installationsinstruktioner. Anthropic rekommenderar HTTP-transporten för dessa.
- I terminalen går du med
cdtill projektet där du ska använda den. - Kör
claude mcp add --transport http notion https://mcp.notion.com/mcpoch byt ut namnet och adressen mot dina egna. Namnet är det du ser i listor och i/mcp. - Om tjänsten använder en API-nyckel i stället för inloggning skickar du den som en header:
--header "Authorization: Bearer your-token".
Äldre servrar kan bara erbjuda SSE, som är utfasat. Nyare versioner av Claude Code provar HTTP först och faller tillbaka på SSE av sig själva; i äldre versioner använder du --transport sse.
Lägg till en lokal server
En lokal server (stdio) är ett program som körs på din dator, ofta startat med npx.
- Skriv Claudes alternativ först, sedan
--och sedan serverns eget kommando:claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server. - Claude Code skickar allt som följer efter
--direkt till serverprogrammet. Utan avgränsaren tolkas flaggor som är avsedda för servern (till exempel-y) som alternativ till Claude Code. - När du använder
--envsätter du ett annat alternativ mellan det och servernamnet, som i exemplet, annars tolkas namnet som ännu en variabel.
Välj omfång
| Omfång | Var den fungerar | Sparas i |
|---|---|---|
local (standard) | Det här projektet, bara för dig | ~/.claude.json, under projektets sökväg |
project | Det här projektet, för alla som klonar det | .mcp.json i projektets rot (committa den) |
user | Alla dina projekt | ~/.claude.json |
Välj user för verktyg som du vill ha överallt, till exempel din anteckningsapp, och project för verktyg som hela teamet behöver i ett repository. Om en server är definierad på flera ställen ansluter Claude Code en gång, i den här prioritetsordningen: local, project, user, sedan servrar från plugins och sist connectors från claude.ai. De tre omfången matchas på namn; plugin-servrar och connectors räknas som dubbletter när de pekar på samma adress eller kommando. Posten som vinner används i sin helhet; fält slås inte ihop.
Lägg inte hemligheter direkt i en delad .mcp.json. Filen accepterar variabler som ${API_KEY} eller ${API_BASE_URL:-https://api.example.com}, som var och en sätter i sin egen miljö.
Logga in på en server som kräver konto
- Starta Claude Code med
claude. - Skriv
/mcp. Panelen listar de servrar där du fortfarande behöver logga in. - Välj servern och följ inloggningen i webbläsaren. Token sparas på din dator och förnyas åt dig.
- Du kan också köra
claude mcp login namefrån skalet. Logga ut medclaude mcp logout name.
Vissa tjänster kräver att du först registrerar en app hos dem. Lägg i så fall till servern med --client-id, --client-secret (du blir ombedd att skriva in den) och, om deras instruktioner kräver en fast omdirigering, --callback-port.
Kontrollera att det fungerar
claude mcp listvisar varje server med dess status: Connected (ansluten), Needs authentication (kräver inloggning), Failed to connect (kunde inte ansluta), Pending approval (väntar på godkännande) eller Disabled for this project (avstängd för det här projektet).claude mcp get namevisar detaljer om en server, inklusive HTTP-felet när den misslyckas.- I en session visar
/mcpsamma status och låter dig ansluta igen. - Be till sist Claude göra något som bara den servern kan, till exempel ”list my open Linear issues” (lista mina öppna ärenden i Linear).
Ta bort en server med claude mcp remove name.
Bra att veta
- Projektservrar frågar först: första gången en session hittar servrar i ett repositorys
.mcp.jsonber Claude Code dig att godkänna dem. Ångra dina val medclaude mcp reset-project-choices. Godkänn bara servrar från repositories som du litar på. - Behörigheter gäller fortfarande: varje anrop till ett MCP-verktyg kan be om godkännande som vilket annat verktyg som helst; se så hanterar du behörigheter i Claude Code.
- Stora resultat: Claude Code varnar när ett verktyg returnerar mer än 10 000 tokens och begränsar utdata till 25 000 som standard. Höj gränsen med miljövariabeln
MAX_MCP_OUTPUT_TOKENS. - Plugins: vissa plugins har med sig egna MCP-servrar, så att installera ett plugin kan vara en enklare väg; se så installerar du plugins i Claude Code.
Om det inte fungerar
- Failed to connect: kör
claude mcp get nameför att se felet, kontrollera URL:en och kör sedan/mcp reconnect alli en session (nyare versioner) för att försöka igen. - En långsam lokal server når tidsgränsen vid start: starta Claude Code med en längre gräns, till exempel
MCP_TIMEOUT=10000 claude(i millisekunder). - ”has a url but no type”: en JSON-post för en fjärrserver saknar
"type": "http". - API-nyckeln avvisas: Claude Code varnar för mellanslag eller radbrytningar i början eller slutet av en header. Lägg till servern igen med en token som klistrats in rent.
Källor
- Claude Code user FAQ (Claude Help Center, kontrollerad 30 oktober 2026)
- Connect Claude Code to tools via MCP (Claude Code Docs, kontrollerad 30 oktober 2026)
Vanliga frågor
Är det samma sak som connectors på claude.ai?
De hänger ihop men ställs in separat. Connectors från claude.ai kan också läsas in i Claude Code, men de har lägst prioritet: om en server som du lagt till med claude mcp add pekar på samma adress används din. Se vår guide till Claude-connectors för webb- och skrivbordsapparna.
Loggas jag ut från tjänsten när jag tar bort en server?
Inte helt. claude mcp remove tar bort den sparade inloggningen på din dator men återkallar den inte. Kör först claude mcp logout name om du vill att token ska återkallas.
Kan jag lägga till en server från ett JSON-utdrag?
Ja. claude mcp add-json name följt av JSON-konfigurationen fungerar. För en fjärrserver tar du med "type": "http" i JSON-koden, annars behandlas den som ett lokalt kommando och misslyckas.