Gestionarea MCP din terminal (claude mcp add / list / get / remove) în Model Context Protocol (MCP)

claude mcp add [opțiuni] <nume> -- <comandă> [argumente]
claude mcp add --transport http <nume> <url>

Ce face Gestionarea MCP din terminal (claude mcp add / list / get / remove)

În Claude Code, subcomanda claude mcp adaugă și gestionează servere MCP fără editarea manuală a fișierelor JSON. Pentru servere remote, documentația recomandă transportul HTTP: claude mcp add --transport http <nume> <url>, cu --header pentru antete de autentificare. Transportul SSE este depreciat; de la v2.1.265, Claude Code încearcă întâi HTTP și trece singur la SSE dacă serverul nu acceptă HTTP. Pentru servere locale stdio, comanda serverului vine după separatorul --.

-- separă opțiunile lui Claude Code (--transport, --env, --scope) de comanda și argumentele serverului; tot ce urmează după el ajunge neschimbat la server. -e/--env primește perechi CHEIE=valoare; dacă numele serverului vine imediat după --env, CLI-ul îl citește ca pe o altă pereche și îl respinge, așa că pune o altă opțiune între ele. Numele serverelor pot conține doar litere, cifre, cratime și underscore.

-s/--scope alege unde se salvează configurarea: local (implicit, doar pentru tine în proiectul curent, în ~/.claude.json), project (în .mcp.json din rădăcina proiectului, partajat prin Git; fiecare utilizator aprobă serverele la prima rulare) sau user (în toate proiectele tale, tot în ~/.claude.json). În sesiune, /mcp arată starea serverelor, permite dezactivarea lor și autentificarea OAuth la serverele remote. claude mcp add-from-claude-desktop importă serverele configurate în Claude Desktop, iar claude mcp add-json adaugă un server dintr-un obiect JSON.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
--transport (-t) http | sse | stdio	Tipul conexiunii. SSE este depreciat; WebSocket se configurează doar prin JSON.
--env (-e) CHEIE=valoare	Variabile de mediu pentru server; acceptă mai multe perechi.
--header (-H) "Nume: valoare"	Antet HTTP pentru serverele remote.
--scope (-s) local | project | user	Unde se salvează configurarea; implicit local.
claude mcp list / get <nume> / remove <nume>	Listează serverele, arată detaliile unuia, îl elimină (inclusiv tokenurile OAuth salvate).
claude mcp add-json <nume> '<json>'	Adaugă un server din obiectul de configurare (fără învelișul mcpServers).
claude mcp add-from-claude-desktop	Import interactiv din configurarea Claude Desktop.
/mcp	În sesiune: starea serverelor, reconectare, dezactivare, autentificare OAuth.

Exemple practice

Exemplul 1: Server remote prin HTTP

claude mcp add --transport http notion https://mcp.notion.com/mcp

Exemplul 2: Server remote cu token Bearer

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Exemplul 3: Server local stdio cu variabilă de mediu

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Exemplul 4: Verificarea serverelor

claude mcp list
claude mcp get notion

Greșeli frecvente și bune practici

• Omiți -- înaintea comenzii serverului. Flag-uri ca -y sau --port sunt citite atunci ca opțiuni ale lui claude mcp add.
• Pui chei API în .mcp.json partajat în Git. Folosește scope-ul local sau expansiunea variabilelor de mediu (${VAR}) în fișier.
• Folosești pachetele @modelcontextprotocol/server-postgres sau server-github din tutoriale vechi. Au fost arhivate în repository-ul servers-archived.

Comenzi înrudite

• mcp-servers-json-config
• mcp-inspector-debug
• mcp-oauth-security
• mcp-reference-servers