Infisical über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Infisical klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Infisical + Gemini

Secrets-Management mit Infisical auf Cloud US, Cloud EU oder selbst gehostet, angemeldet als Machine Identity: Projekte, Umgebungen, Ordner und Secret-Importe, Namen und Metadaten der Secrets, einzelne Secret-Werte auf Anfrage, Tags, Projektmitglieder, Identitäten und das Audit-Log. Legt Secrets, Ordner, Umgebungen und Tags an und ändert Secrets; das Löschen eines Secrets ist bei der Installation deaktiviert.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

INFISICAL_URL, INFISICAL_CLIENT_ID, INFISICAL_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten und braucht einen Admin der Infisical-Organisation. Der Connector meldet sich als Machine Identity mit Universal Auth an.

1. Öffne in Infisical Organization, Access Control, Machine Identities (ältere Versionen: Organization Settings, Identities), klicke auf Create Identity, nenne sie zum Beispiel AnythingMCP und gib ihr die Organisationsrolle Member oder eine eigene Rolle. Zum Lesen des Audit-Logs braucht die Rolle Zugriff auf das Audit-Log.
2. Füge der Identity die Anmeldemethode Universal Auth hinzu. Behalte die Laufzeit des Access Tokens (standardmäßig 30 Tage) oder verkürze sie; der Connector meldet sich selbst neu an. Lege unter Client Secrets ein Secret mit usage limit 0 (unbegrenzt) an, denn jede neue Anmeldung verbraucht es einmal. Wenn du Trusted IPs setzt, nimm die ausgehende Adresse deines AnythingMCP-Servers auf.
3. Kopiere die Client ID (eine UUID) in INFISICAL_CLIENT_ID und das Client Secret, das nur einmal angezeigt wird, in INFISICAL_CLIENT_SECRET.
4. Füge die Identity jedem Projekt hinzu, das sie erreichen soll: Öffne im Projekt Access Control, Machine Identities, Add Identity, mit der Rolle Viewer nur zum Lesen, oder Developer oder einer eigenen Rolle zum Schreiben. Beschränke die Rolle auf die Umgebungen und Pfade, die sie braucht.
5. Setze INFISICAL_URL auf https://app.infisical.com (Cloud US), https://eu.infisical.com (Cloud EU) oder die Adresse deiner eigenen Instanz, ohne /api und ohne Schrägstrich am Ende.
6. Installiere den Connector und führe infisical_list_projects aus: Es bestätigt die Anmeldung und listet die Projekte, zu denen die Identity gehört.

Der Connector meldet sich unter /api/v1/auth/universal-auth/login an, sendet das Access Token als Authorization: Bearer und erneuert es selbst.

Secret-Werte erreichen die KI: Infisical gibt einen Wert jedem im Klartext zurück, der ihn lesen darf, und jeder Wert, den dieser Connector liest oder schreibt, läuft durch die Unterhaltung und beim KI-Anbieter vorbei. Deshalb liefern infisical_list_secrets und infisical_get_secret nur Namen und Metadaten: Sie bitten Infisical, keine Werte zu senden. Das einzige Tool, das einen Wert zurückgibt, ist infisical_read_secret_value, ein Secret pro Aufruf, und die KI nutzt es nur, wenn du nach genau diesem Wert fragst. Auch die Werte, die du an infisical_create_secret und infisical_update_secret übergibst, laufen durch die Unterhaltung. Soll nie ein Wert im Chat auftauchen, schaltet ein Workspace-Admin infisical_read_secret_value ab, oder die Identity bekommt eine Rolle ohne Recht zum Lesen von Werten. Infisical protokolliert jeden gelesenen Wert im Audit-Log.

Was er liest: die Organisation der Identity (infisical_get_identity_details); Projekte mit ihren Umgebungen (Name, Slug, ID); die Ordner einer Umgebung, als Liste oder mit recursive als ganzen Baum; Secret-Importe, also andere Umgebungen oder Pfade, von denen ein Ordner Secrets erbt; Namen der Secrets mit Version, Kommentar, Tags, Metadaten und Zeitstempeln, eingegrenzt mit tag_slugs oder metadata_filter, und mit infisical_get_secret die Metadaten eines Secrets oder eine ältere version; Tags; Projektmitglieder mit ihren Rollen, Projekt-Identitäten und Organisations-Identitäten; und das Audit-Log der Organisation (infisical_list_audit_logs), gefiltert nach Projekt, Umgebung, Secret, Akteur, Ereignistyp wie get-secret, update-secret oder delete-secret und Datum, um herauszufinden, wer ein Secret gelesen oder geändert hat. infisical_read_secret_value löst Verweise wie ${DB_HOST} auf, außer expand_secret_references ist false.

Was er schreibt: infisical_create_secret, infisical_update_secret (neuer Wert, neuer Name mit new_secret_name, Kommentar oder Tags; tag_ids ersetzt die ganze Tag-Liste), infisical_create_folder, infisical_create_environment und infisical_create_tag. Infisical behält die vorherige Version eines Secrets, eine Wertänderung lässt sich also im Dashboard zurücknehmen. Apps, die das Secret lesen, bekommen den neuen Wert beim nächsten Abruf, deshalb bestätigt die KI die Umgebung mit dir, bevor sie in Produktion schreibt. Hat eine Umgebung eine Freigaberichtlinie für Änderungen, öffnet ein Anlegen oder Ändern in Infisical einen Freigabeantrag, statt das Secret sofort zu ändern.

Bei der Installation deaktiviert: infisical_delete_secret. Es lässt sich über diesen Connector nicht rückgängig machen und legt jede App und Pipeline lahm, die das Secret liest. Ein Workspace-Admin schaltet es ein, wenn das Team es braucht.

Datenformate: IDs sind UUIDs; Umgebungen werden über ihren Slug angesprochen (dev, staging, prod), Projekte über ihre ID. Pfade beginnen mit /, / allein ist die Wurzel. version zählt die Änderungen eines Secrets; secretValueHidden: true heißt, dass der Wert nicht gesendet wurde. Zeiten sind ISO 8601 in UTC.

Blättern: infisical_list_audit_logs (standardmäßig 20 Einträge), infisical_list_project_identities und infisical_list_org_identities (standardmäßig 100) blättern mit offset und limit; die KI fragt mit höherem offset nach, solange eine Seite voll zurückkommt. Die übrigen Listen liefern alles in einer Antwort.

Limits: Infisical Cloud erlaubt pro Minute und Client-IP je nach Tarif 200 bis 600 Lesezugriffe, 90 bis 300 Schreibzugriffe und 120 bis 500 Secret-Operationen, insgesamt 600 Anfragen. Ein 429 nennt die Sekunden, die zu warten sind. Wie lange das Audit-Log aufbewahrt wird, hängt vom Tarif ab. Selbst gehostetes Infisical braucht Version 0.150 oder neuer für die v4-Secrets-API, die der Connector nutzt.

Häufige Fehler: 401, oder 403 mit TokenError, heißt, die Anmeldung ist gescheitert: falsche Client ID oder falsches Client Secret, ein widerrufenes, abgelaufenes oder aufgebrauchtes Client Secret, die falsche Region in INFISICAL_URL oder eine IP außerhalb der Trusted IPs. 403 PermissionDenied heißt, die Rolle der Identity erlaubt dieses Projekt, diese Umgebung, diesen Pfad oder diese Aktion nicht. 404 heißt falsche ID, falscher Slug, Pfad oder Secret-Name; Namen unterscheiden Groß- und Kleinschreibung.

Mit den bei der Installation aktiven Tools löscht der Connector keine Secrets. Er liest höchstens einen Secret-Wert pro Aufruf, ändert keine Mitglieder, Rollen oder Machine Identities und verwaltet keine Zertifikate oder KMS-Schlüssel.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Infisical-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Secrets liegen in der prod-Umgebung unseres Backend-Projekts? Nur Namen, keine Werte.“
• „Wer hat das Secret STRIPE_SECRET_KEY in Produktion in den letzten 7 Tagen geändert?“
• „Zeig mir den Wert von DATABASE_URL in der staging-Umgebung des Projekts api.“
• „Leg in dev einen Ordner /payments an und darin ein Secret PAYMENTS_WEBHOOK_URL mit dem Wert https://example.com/hooks/payments.“
• „Welche Machine Identities und Nutzer haben Zugriff auf das Projekt web, und mit welchen Rollen?“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden