Come configurare un server MCP in Antigravity IDE

Che cosa fa un server MCP in Antigravity IDE

Il Model Context Protocol, abbreviato MCP, offre uno standard per presentare a un agente strumenti e contesto esterni. Un server può esporre schemi di database, documentazione, ticket, risorse cloud, parser di file o API. Antigravity avvia il processo configurato o si collega all'endpoint remoto, scopre gli strumenti e li rende disponibili entro le autorizzazioni approvate.

Installare MCP non equivale ad aggiungere un tema grafico. Un server stdio locale esegue un comando sul computer. Un server remoto riceve richieste e può richiedere OAuth o token. Prima dell'aggiunta identifica autore, dati leggibili, operazioni di scrittura e reale necessità di uscire dal repository.

La procedura segue la documentazione Google attuale e distingue IDE e CLI. L'IDE dispone di Store e configurazione JSON. La CLI offre il gestore /mcp, ma il suo stato non dimostra che l'IDE desktop abbia caricato lo stesso file o ambito.

Scegliere configurazione MCP globale o di progetto

Usa l'ambito più ristretto. La voce globale è comoda per uno strumento personale ricorrente; quella di progetto è più semplice da revisionare, condividere e rimuovere con il repository.

Installare un server dal MCP Store

Apri un progetto reale, attendi accesso e inizializzazione, poi usa il menu con tre punti in alto nel pannello dell'agente. Seleziona MCP Servers. Passa su un server supportato e scegli Install oppure consulta prima i dettagli. Completa l'autenticazione ufficiale e torna all'elenco per confermarne la presenza.

Inizia con un solo server. Più installazioni contemporanee rendono difficile capire quale processo, credenziale o definizione abbia fallito e aumentano gli strumenti tra cui l'agente deve scegliere. Una prova pulita ha un autore noto, un flusso di accesso e una richiesta precisa.

1. Passo 1 — Apri pannello agente e menu con tre punti.
2. Passo 2 — Scegli MCP Servers e controlla origine e accesso richiesto.
3. Passo 3 — Installa un server, completa l'accesso ufficiale e ricarica.
4. Passo 4 — Richiedi una lettura sicura e verifica risultato e permessi.

Aggiungere un server personalizzato con mcp_config.json

Se non è nello Store, scegli Manage MCP Servers e View raw config. Il file globale documentato è ~/.gemini/config/mcp_config.json; quello del progetto può essere .agents/mcp_config.json. Mantieni un solo oggetto mcpServers alla radice. Comando, argomenti, endpoint e autenticazione devono provenire dalla documentazione ufficiale del server.

L'esempio è volutamente inattivo. Per stdio, command e args avviano il processo. Per connessioni remote attuali Google documenta serverUrl; i vecchi campi url o httpUrl possono non essere riconosciuti. Non indovinare pacchetto, CDN o credenziali e non inserire chiavi private in Git.

{
  "mcpServers": {
    "server-esempio": {
      "command": "COMANDO_UFFICIALE",
      "args": ["ARGOMENTO_UFFICIALE"]
    },
    "remoto-esempio": {
      "serverUrl": "https://ENDPOINT_UFFICIALE_DI_ESEMPIO/mcp"
    }
  }
}

È solo una struttura. Copia programma, URL, intestazioni e OAuth esclusivamente dalla fonte primaria scelta.

Ricaricare e verificare il server MCP

Salva JSON valido, torna all'elenco e ricarica. Devono apparire il server e i suoi strumenti o risorse. Non iniziare con una scrittura: chiedi l'elenco delle risorse, la lettura di un documento di prova o solo i nomi degli strumenti.

Se serve autenticazione, controlla account e ambito. Un indicatore verde prova la connessione, non l'idoneità ai dati riservati. Esamina strumento, argomenti e fonte prima di ricordare un'autorizzazione.

• Caricato — Compare il nome previsto e l'elenco strumenti è ispezionabile.
• Autorizzato — Account e ambito corrispondono al progetto previsto.
• Fondato — La prova restituisce la fonte corretta, non dati inventati.
• Reversibile — Sai disattivare voce, revocare token e rimuovere configurazione.

Sicurezza e autorizzazioni MCP

Tratta ogni server come codice che attraversa un confine di dati. Preferisci il produttore originale o un repository verificabile, blocca le versioni quando possibile ed evita comandi scarica-ed-esegui da guide non controllate. Per database e cloud usa un account di sviluppo con privilegi minimi, non il proprietario di produzione.

L'ambito di progetto non crea automaticamente una sandbox. Il processo può leggere ciò che l'account del sistema operativo consente. Tieni segreti fuori da prompt e JSON versionato. Revisiona sempre scrittura, cancellazione, distribuzione, pagamenti, messaggi e amministrazione account finché non esiste una regola documentata.

Risolvere problemi MCP in Antigravity IDE e WSL

Le cause comuni sono ambito errato, JSON non valido, PATH, autenticazione o percorsi mescolati tra Windows e WSL. Cambia una variabile alla volta.

Il server non compare dopo il ricaricamento

Valida JSON, verifica mcpServers alla radice e modifica il file mostrato da Manage MCP Servers. Cerca un altro file globale o locale. Riavvia solo dopo il fallimento del normale ricaricamento.

Il comando funziona nel terminale ma non nell'IDE

Il processo grafico può usare PATH, home o variabili diversi. Usa un percorso assoluto se supportato e riapri Antigravity dopo modifiche di sistema.

Il server da WSL parte in modo errato

Decidi quale sistema avvia il processo. Un IDE Windows spesso richiede wsl.exe esplicito e percorsi Linux nel comando. Un processo WSL non deve ricevere C:\ come percorso Linux. Prova prima lo stesso comando fuori dall'IDE.

Il remoto si collega senza mostrare strumenti

Controlla endpoint ufficiale, autenticazione e trasporto. La configurazione attuale usa serverUrl. Una pagina prodotto o dashboard non è l'endpoint MCP.

Il server continua a riavviarsi

Eseguilo direttamente e controlla stderr senza esporre segreti. Cerca runtime assente, versione incompatibile, log su stdout o credenziali scadute.

Verifica di versione e fonte del download

Poiché questo è un sito di download software, la verifica è avvenuta prima della pubblicazione. Il 24 luglio 2026 il changelog ufficiale indicava la versione 2.2.1 del 25 giugno 2026. Il sito riportava già v2.2.1, quindi il numero non è cambiato. La pagina non inventa dimensione, checksum, scansione di sicurezza o link diretto del pacchetto.

Il pulsante usa la pagina ufficiale come alternativa verificata. Controllala di nuovo al momento dell'installazione perché il rilascio può essere graduale. Per percorsi MCP e schema remoto aggiornati, la documentazione ufficiale resta l'autorità finale.