Model Context Protocol (MCP): conectarea agenților AI la unelte și date

Model Context Protocol (MCP) este standardul deschis introdus de Anthropic și adoptat de întregul ecosistem AI (OpenAI, Google DeepMind, Cursor, Claude Code, GitHub Copilot, n8n, LangChain) pentru conectarea modelelor mari de limbaj la baze de date, fișiere locale, API-uri și unelte externe.

Supranumit „portul USB-C al aplicațiilor AI”, protocolul MCP elimină nevoia de a scrie integrări personalizate pentru fiecare combinație de model și aplicație: construiești un singur Server MCP (în Python cu FastMCP sau în TypeScript), iar acesta devine imediat utilizabil în Claude Desktop, Claude Code CLI, Cursor IDE, Windsurf sau agenți proprii.

Cum este organizat acest ghid

Am structurat cele 15 concepte, primitive și implementări MCP esențiale în 4 categorii practice:

• Arhitectură & Primitivele Protocolului: Host, Client & Server, Tools (Unelte executabile), Resources (Date & URI-uri) și Prompts & Sampling.
• Transport, Configurare & Clienți: Transport stdio vs Streamable HTTP / SSE, mcpServers JSON (Claude Desktop & Cursor), claude mcp add (Claude Code CLI) și MCP Inspector (@modelcontextprotocol/inspector).
• Dezvoltarea Serverelor MCP (Python & TypeScript): FastMCP în Python (@mcp.tool), @mcp.resource & @mcp.prompt, TypeScript MCP SDK (McpServer) și Context, Logging & Lifespan.
• Servere Oficiale, Securitate & Ecosistem: Servere MCP de Referință (Filesystem, GitHub, Postgres, Playwright), Roots & Human-in-the-Loop Approval și Autentificare OAuth 2.1 & Securitate MCP.

Apasă pe oricare componentă de mai jos pentru diagrame de protocol, configurări JSON și exemple complete de cod în Python și TypeScript.

# 1. Instalare Node.js (npx) și uv (uvx) pe macOS:
brew install node uv

# 2. Crearea unui proiect de server MCP în Python cu FastMCP:
uv init serverul-meu-mcp && cd serverul-meu-mcp
uv add "mcp[cli]" httpx

# 3. Lansarea MCP Inspector pentru testare în browser:
npx @modelcontextprotocol/inspector

# 1. Instalare Node.js și uv în Windows PowerShell:
winget install OpenJS.NodeJS.LTS
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 2. Creare proiect MCP Python:
uv init serverul-meu-mcp && cd serverul-meu-mcp
uv add "mcp[cli]"

# 3. Fișierul de configurare Claude Desktop pe Windows se află în:
# %APPDATA%\Claude\claude_desktop_config.json

# 1. Instalare uv și Node.js pe Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
sudo apt update && sudo apt install -y nodejs npm

# 2. Instalare SDK MCP pentru Python sau TypeScript:
uv add "mcp[cli]"                            # Python
npm install @modelcontextprotocol/sdk zod    # TypeScript

# Adăugarea rapidă a unui server MCP în Claude Code CLI:
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb

# Instalarea directă a unui script FastMCP în Claude Desktop:
uv run mcp install server.py