Workbranch › Veiledninger
VeiledningSlik kobler du MCP-servere til Claude Code
MCP-servere gir Claude Code tilgang til verktøy utenfor koden din, for eksempel et saksstyringsverktøy, en database eller et designverktøy. Denne veiledningen viser kommandoene for å legge til en, hvor innstillingen lagres, hvordan du logger inn, og hvordan du ser om den fungerer.
Kort svar: for en ekstern server kjører du claude mcp add --transport http name https://server/mcp; for en lokal kjører du claude mcp add name -- command args. Legg til --scope user for å bruke den i alle prosjekter, eller --scope project for å dele den via .mcp.json. Åpne så Claude Code, skriv /mcp for å logge inn ved behov, og bekreft at serveren vises som tilkoblet.
Kommandoene nedenfor følger Anthropics dokumentasjon for Claude Code per oktober 2026. Du kjører claude mcp-kommandoene i den vanlige terminalen din, ikke inne i en Claude Code-økt.
Legg til en ekstern server (det vanligste)
En nettbasert tjeneste gir deg en nettadresse til MCP-serveren sin, som du finner i tjenestens egne oppsettinstruksjoner. Anthropic anbefaler HTTP-transporten for disse.
- I terminalen går du med
cdinn i prosjektet du skal bruke den med. - Kjør
claude mcp add --transport http notion https://mcp.notion.com/mcp, med ditt eget navn og din egen adresse. Navnet er det du ser i lister og i/mcp. - Bruker tjenesten en API-nøkkel i stedet for innlogging, sender du den som en header:
--header "Authorization: Bearer your-token".
Eldre servere tilbyr kanskje bare SSE, som er utfaset. Nyere versjoner av Claude Code prøver HTTP først og faller av seg selv tilbake til SSE; i eldre versjoner bruker du --transport sse.
Legg til en lokal server
En lokal (stdio-)server er et program som kjører på datamaskinen din, ofte startet med npx.
- Skriv Claude-valgene først, så
--, og så serverens egen kommando:claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server. - Claude Code sender alt som står etter
--rett videre til serverprogrammet. Uten skilletegnet leses flagg som er ment for serveren (som-y) som valg for Claude Code. - Når du bruker
--env, setter du et annet valg mellom den og servernavnet, som i eksempelet, ellers leses navnet som enda en variabel.
Velg omfang
| Omfang | Hvor den fungerer | Lagret i |
|---|---|---|
local (standard) | Dette prosjektet, bare for deg | ~/.claude.json, under prosjektets sti |
project | Dette prosjektet, for alle som kloner det | .mcp.json i prosjektroten (commit den) |
user | Alle prosjektene dine | ~/.claude.json |
Velg user for verktøy du vil ha overalt, som notatappen din, og project for verktøy hele teamet trenger i ett repositorium. Er én server definert flere steder, kobler Claude Code til én gang, i denne prioriteten: local, project, user, så servere fra plugins, og til slutt connectors fra claude.ai. De tre omfangene sammenlignes på navn; plugin-servere og connectors regnes som duplikater når de peker på samme adresse eller kommando. Oppføringen som vinner brukes i sin helhet; felt slås ikke sammen.
Ikke legg hemmeligheter rett inn i en delt .mcp.json. Den godtar variabler som ${API_KEY} eller ${API_BASE_URL:-https://api.example.com}, som hver person setter i sitt eget miljø.
Logg inn på en server som krever konto
- Start Claude Code med
claude. - Skriv
/mcp. Panelet viser serverne du fortsatt må logge inn på. - Velg serveren og følg innloggingen i nettleseren. Tokenet lagres på datamaskinen din og fornyes for deg.
- Alternativt kjører du
claude mcp login namefra skallet. Logg ut medclaude mcp logout name.
Noen tjenester krever at du registrerer en app hos dem først. Da legger du til serveren med --client-id, --client-secret (du blir bedt om å skrive den inn) og, hvis oppsettet deres krever en fast omdirigering, --callback-port.
Sjekk at det fungerer
claude mcp listviser alle serverne med status: Connected (tilkoblet), Needs authentication (krever innlogging), Failed to connect (tilkobling feilet), Pending approval (venter på godkjenning) eller Disabled for this project (slått av for dette prosjektet).claude mcp get nameviser detaljene for én server, inkludert HTTP-feilen når den feiler.- Inne i en økt viser
/mcpsamme status og lar deg koble til på nytt. - Til slutt ber du Claude gjøre noe bare den serveren kan, for eksempel «list my open Linear issues».
Fjern en server med claude mcp remove name.
Greit å vite
- Prosjektservere spør først: første gang en økt finner servere i et repositoriums
.mcp.json, ber Claude Code deg godkjenne dem. Angre valgene medclaude mcp reset-project-choices. Godkjenn bare servere fra repositorier du stoler på. - Tillatelser gjelder fortsatt: hvert kall til et MCP-verktøy kan be om godkjenning som alle andre verktøy; se slik styrer du tillatelser i Claude Code.
- Store resultater: Claude Code advarer når et verktøy returnerer mer enn 10 000 tokens, og begrenser utdata til 25 000 som standard. Øk grensen med miljøvariabelen
MAX_MCP_OUTPUT_TOKENS. - Plugins: noen plugins har med egne MCP-servere, så å installere en plugin kan være en enklere vei; se slik installerer du plugins i Claude Code.
Hvis det ikke fungerer
- Failed to connect: kjør
claude mcp get namefor å se feilen, sjekk URL-en, og kjør så/mcp reconnect alli en økt (nyere versjoner) for å prøve igjen. - En treg lokal server får tidsavbrudd ved oppstart: start Claude Code med en lengre grense, for eksempel
MCP_TIMEOUT=10000 claude(i millisekunder). - «has a url but no type»: en JSON-oppføring for en ekstern server mangler
"type": "http". - API-nøkkelen avvises: Claude Code advarer om mellomrom eller linjeskift i starten eller slutten av en header. Legg til serveren på nytt med et rent innlimt token.
Kilder
- Claude Code user FAQ (Claude Help Center, sjekket 30. oktober 2026)
- Connect Claude Code to tools via MCP (Claude Code Docs, sjekket 30. oktober 2026)
Vanlige spørsmål
Er dette det samme som connectors på claude.ai?
De henger sammen, men settes opp hver for seg. Connectors fra claude.ai kan også lastes i Claude Code, men de har lavest prioritet: peker en server du har lagt til med claude mcp add på samme adresse, brukes din. Se veiledningen vår om Claude-connectors for nettet og skrivebordsappene.
Logger jeg ut av tjenesten når jeg fjerner en server?
Ikke helt. claude mcp remove sletter den lagrede innloggingen på datamaskinen din, men tilbakekaller den ikke. Kjør claude mcp logout name først hvis du vil at tokenet skal tilbakekalles.
Kan jeg legge til en server fra en JSON-snutt?
Ja. claude mcp add-json name etterfulgt av JSON-konfigurasjonen fungerer. For en ekstern server tar du med "type": "http" i JSON-en, ellers behandles den som en lokal kommando og feiler.