Gestionarea MCP din Terminal (claude mcp add / list) în Model Context Protocol (MCP)

Comenzile CLI din Claude Code și agenții de terminal pentru adăugarea, testarea, partajarea în echipă (.mcp.json) și inspectarea serverelor MCP.

Specificație & cod MCP
# Adăugare server MCP local (stdio) cu variabilă de mediu:
claude mcp add github -e GITHUB_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github

# Adăugare server MCP remote (HTTP) și verificare stare:
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
claude mcp list

Descriere & Utilizare

În agenții de terminal precum Claude Code, nu este nevoie să editezi manual fișiere JSON: subcomanda claude mcp îți permite să instalezi și să gestionezi servere MCP direct din linia de comandă.

Poți controla vizibilitatea serverului prin flag-ul --scope (sau -s): local (implicit, doar pentru tine în proiectul curent), user (disponibil global în toate proiectele tale) sau project (care generează fișierul .mcp.json în rădăcina depozitului Git pentru ca toți colegii din echipă să folosească aceleași unelte).

În timpul unei sesiuni interactive, comanda slash /mcp îți arată în timp real ce servere sunt conectate, ce unelte au expus și îți permite să te autentifici prin OAuth2 la serverele cloud.

Cum să o reții ușor

💡 Ca un manager de pachete (apt sau brew) dedicat abilităților agentului tău: cu o singură linie în consolă îi instalezi accesul la baza de date, la Sentry sau la browser.

Opțiuni și parametri tehnici

  • claude mcp add <nume> -- <comanda>: separatorul -- delimitează opțiunile lui Claude de comanda efectivă și argumentele serverului MCP.
  • -e CHEIE=VALOARE: setează variabilele de mediu necesare serverului (chei API, stringuri de conexiune).
  • -s / --scope (local | user | project): alege unde se salvează configurația (project scrie în .mcp.json).
  • --transport (stdio | http | sse): specifică tipul conexiunii pentru serverele locale sau la distanță.

Exemple practice și cazuri de utilizare

  • Conectarea agentului la baza PostgreSQL locală: claude mcp add db -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost/app_dev
  • Adăugarea Playwright MCP pentru testare automată în browser: claude mcp add playwright -- npx -y @playwright/mcp@latest
  • Importarea automată a serverelor deja configurate în Claude Desktop: claude mcp add-from-claude-desktop

Sfaturi de configurare & capcane

Pune întotdeauna separatorul dublu-minus (--) înaintea comenzii npx sau uvx — fără el, flag-uri precum -y vor fi interpretate greșit ca opțiuni ale comenzii claude mcp add.

Comenzi și ghiduri înrudite