MCP-Server in Antigravity IDE sicher einrichten

Was ein MCP-Server in Antigravity IDE macht

Das Model Context Protocol, kurz MCP, bietet einem Agenten eine standardisierte Schnittstelle zu externen Werkzeugen und Kontext. Ein Server kann Datenbankschemata, Dokumentation, Tickets, Cloud-Ressourcen, Dateiparser oder APIs bereitstellen. Antigravity startet den konfigurierten lokalen Prozess oder verbindet sich mit einem entfernten Endpunkt, liest die angebotenen Tools und stellt sie innerhalb der genehmigten Berechtigungen bereit.

Ein MCP-Server ist kein harmloses Farbthema. Ein lokaler stdio-Server führt einen Befehl auf deinem Rechner aus. Ein Remote-Server erhält Anfragen und benötigt möglicherweise OAuth oder Tokens. Prüfe deshalb Herausgeber, Datenzugriff, Schreibmöglichkeiten und den wirklich notwendigen Projektumfang.

Der Ablauf folgt der aktuellen Google-Dokumentation und trennt die IDE von Antigravity CLI. Die IDE besitzt Store und JSON-Konfiguration. Die CLI bietet /mcp, doch deren Anzeige beweist nicht automatisch, dass die Desktop-IDE dieselbe Datei oder denselben Umfang geladen hat.

Globale oder projektbezogene MCP-Konfiguration wählen

Nutze den engsten sinnvollen Umfang. Global eignet sich für ein persönliches Tool in vielen Projekten; die Projektdatei lässt sich gemeinsam prüfen und mit dem Repository entfernen.

Einen Server aus dem MCP Store installieren

Öffne ein echtes Projekt und warte, bis Anmeldung und Initialisierung abgeschlossen sind. Klicke dann oben im Agent-Bereich auf das Drei-Punkte-Menü und wähle MCP Servers. Fahre über einen unterstützten Server und wähle Install oder lies zuerst seine Details. Schließe den offiziellen Anmeldevorgang ab und kehre zur Liste zurück.

Installiere zuerst nur einen Server. Viele gleichzeitige Installationen erschweren die Fehlersuche und vergrößern die Toolauswahl des Agenten. Ein sauberer Test umfasst einen bekannten Anbieter, einen Anmeldeweg und eine konkrete Leseanfrage.

1. Schritt 1 — Agent-Bereich und Drei-Punkte-Menü öffnen.
2. Schritt 2 — MCP Servers wählen und Anbieter sowie Zugriff prüfen.
3. Schritt 3 — Einen Server installieren, offiziell anmelden und neu laden.
4. Schritt 4 — Eine reine Leseaufgabe stellen und Ergebnis sowie Rechte kontrollieren.

Eigenen Server mit mcp_config.json hinzufügen

Fehlt der Server im Store, öffne Manage MCP Servers und View raw config. Die dokumentierte globale Datei ist ~/.gemini/config/mcp_config.json; projektbezogen ist .agents/mcp_config.json möglich. An der Wurzel steht genau ein mcpServers-Objekt. Befehl, Argumente, Endpunkt und Authentifizierung müssen aus der offiziellen Serverdokumentation stammen.

Das Beispiel ist absichtlich nicht lauffähig. Bei stdio starten command und args den Prozess. Für aktuelle Remote-Verbindungen dokumentiert Google serverUrl; ältere Felder url oder httpUrl können scheitern. Paketnamen, CDN-Adressen und Zugangsdaten dürfen nicht geraten werden.

{
  "mcpServers": {
    "beispiel-server": {
      "command": "OFFIZIELLER_BEFEHL",
      "args": ["OFFIZIELLES_ARGUMENT"]
    },
    "beispiel-remote": {
      "serverUrl": "https://OFFIZIELLER_BEISPIEL_ENDPUNKT/mcp"
    }
  }
}

Dies ist nur die Struktur. Übernimm Programm, URL, Header und OAuth ausschließlich aus der Primärdokumentation des gewählten Servers.

MCP-Server neu laden und prüfen

Speichere gültiges JSON, kehre zur Serverliste zurück und lade neu. Der Servername sowie seine Tools oder Ressourcen sollten sichtbar sein. Beginne nicht mit Schreibzugriff. Lasse Ressourcen auflisten, ein nicht vertrauliches Testdokument lesen oder nur Toolnamen anzeigen.

Bei Authentifizierung sind Konto und Umfang zu kontrollieren. Ein grüner Status beweist eine Verbindung, nicht die Eignung für vertrauliche Daten. Prüfe Toolname, Argumente und Quelle, bevor eine Berechtigung dauerhaft gespeichert wird.

• Geladen — Der erwartete Name erscheint und die Tools sind einsehbar.
• Autorisiert — Konto und Zugriffsbereich passen zum vorgesehenen Projekt.
• Nachvollziehbar — Der Lesetest liefert die erwartete Quelle statt erfundener Daten.
• Rückgängig — Du kannst Eintrag, Token und Konfiguration sicher entfernen.

MCP-Sicherheit und Berechtigungen

Behandle jeden Server als Code an einer Datengrenze. Bevorzuge den Originalanbieter oder ein prüfbares Repository, fixiere Versionen und vermeide ungeprüfte Download-und-Ausführen-Befehle. Datenbank- und Cloud-Tools erhalten ein Konto mit minimalen Rechten, nicht die Eigentümerrolle der Produktion.

Projektumfang ist kein automatischer Sandbox-Schutz. Der Prozess kann lesen, was das Betriebssystemkonto erlaubt. Geheimnisse gehören weder in Prompts noch in eingechecktes JSON. Schreib-, Lösch-, Deployment-, Zahlungs-, Nachrichten- und Kontoadministrationsaktionen bleiben unter manueller Prüfung.

MCP-Probleme in Antigravity IDE und WSL beheben

Meist sind falscher Umfang, ungültiges JSON, PATH, Authentifizierung oder gemischte Windows- und WSL-Pfade verantwortlich. Ändere immer nur eine Ursache.

Der Server erscheint nach dem Neuladen nicht

JSON validieren, mcpServers an der Wurzel prüfen und genau die in Manage MCP Servers gezeigte Datei bearbeiten. Nach einer abweichenden globalen oder lokalen Datei suchen. Erst nach erfolglosem Reload neu starten.

Der Befehl funktioniert im Terminal, nicht in der IDE

Der grafische Prozess kann anderen PATH, anderes Home oder andere Variablen haben. Wenn unterstützt, einen absoluten Programmpfad nutzen und Antigravity nach Systemänderungen neu öffnen.

MCP aus WSL startet falsch

Festlegen, welches System den Prozess besitzt. Eine Windows-IDE benötigt oft wsl.exe ausdrücklich und Linux-Pfade innerhalb dieses Befehls. Ein WSL-Prozess darf C:\ nicht als Linux-Pfad behandeln. Den exakten Startbefehl zuerst separat testen.

Remote-Verbindung ohne Tools

Offiziellen Endpunkt, Authentifizierung und Transport prüfen. Aktuelle Konfigurationen verwenden serverUrl. Eine Produkt- oder Dashboard-Seite ist kein MCP-Endpunkt.

Der Server startet ständig neu

Prozess direkt ausführen und stderr ohne Geheimnisse untersuchen. Häufig fehlen Runtime oder kompatible Version; manchmal stören Logs auf stdout oder abgelaufene Tokens.

Versions- und Downloadquellenprüfung

Da dies eine Software-Downloadseite ist, wurde die Version vor Veröffentlichung geprüft. Am 24. Juli 2026 führte das offizielle Google-Changelog Version 2.2.1 mit Datum 25. Juni 2026. Die Website nannte bereits v2.2.1, daher war keine Versionsänderung nötig. Diese Seite erfindet weder Dateigröße noch Prüfsumme, Sicherheitsprüfung oder Paket-Direktlink.

Der Downloadknopf verwendet die offizielle Seite als verifizierten Fallback. Prüfe sie bei der Installation erneut, weil Veröffentlichungen schrittweise verteilt werden können. Für aktuelle MCP-Pfade und Remote-Schema bleibt die verlinkte offizielle Dokumentation maßgeblich.