Ce face /mcp (servere MCP)
/mcp deschide MCP Manager: vezi starea fiecărui server (activ, deconectat, în încărcare), reîncarci configurația și urmărești jurnalele de conexiune. Dacă uneltele MCP ocupă mult context (vezi /context), dezactivează aici serverele de care nu ai nevoie în proiectul curent.
Serverele se definesc sub cheia mcpServers în ~/.gemini/config/mcp_config.json (toate proiectele) sau în <proiect>/.agents/mcp_config.json (doar proiectul). CLI-ul acceptă procese locale stdio și servere la distanță. Serverele la distanță trebuie să folosească transportul Streamable HTTP, cu adresa în serverUrl (merge și url); vechiul transport HTTP+SSE și câmpul httpUrl nu sunt acceptate.
Față de Gemini CLI, serverele nu mai stau în ~/.gemini/settings.json, ci în fișierele mcp_config.json de mai sus. Nu există o subcomandă agy mcp în documentația oficială.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
/mcp |
Managerul interactiv de servere MCP. |
serverUrl |
Adresa unui server la distanță (Streamable HTTP). |
headers |
Antete HTTP, de exemplu pentru autentificare. |
timeoutSeconds |
Timpul maxim pentru uneltele lente ale serverului. |
Exemple practice
Exemplul 1: Server la distanță cu timeout mărit
{
"mcpServers": {
"my-remote-server": {
"serverUrl": "https://api.example.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
},
"timeoutSeconds": 600
}
}
}
Greșeli frecvente și bune practici
- Copiezi o configurație veche cu
httpUrlsau un server HTTP+SSE. Treci laserverUrlși la un server Streamable HTTP. - Pui tokenul direct în fișierul din proiect și îl publici în Git. Ține secretele în configurația globală sau în variabile de mediu.