Как подключить Infisical к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Infisical, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Infisical + Gemini

Управление секретами в Infisical на Cloud US, Cloud EU или на своём сервере, вход как machine identity: проекты, окружения, папки и импорты секретов, имена и метаданные секретов, отдельные значения по запросу, теги, участники проектов, идентичности и журнал аудита. Создаёт и обновляет секреты, создаёт папки, окружения и теги; удаление секрета при установке отключено.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

INFISICAL_URL, INFISICAL_CLIENT_ID, INFISICAL_CLIENT_SECRET

Шаг 1 — Получите учётные данные

Настройка занимает около 5 минут, нужен администратор организации Infisical. Коннектор входит как machine identity через Universal Auth.

1. В Infisical откройте Organization, Access Control, Machine Identities (в старых версиях Organization Settings, Identities), нажмите Create Identity, назовите её, например, AnythingMCP и дайте ей роль организации Member или свою роль. Для чтения журнала аудита роли нужен доступ к нему.
2. Добавьте identity метод входа Universal Auth. Срок жизни access token (по умолчанию 30 дней) можно оставить или сократить: коннектор сам входит заново. В Client Secrets создайте секрет с usage limit 0 (без ограничений), потому что каждый новый вход расходует его один раз. Если задаёте Trusted IPs, включите исходящий адрес вашего сервера AnythingMCP.
3. Скопируйте Client ID (UUID) в INFISICAL_CLIENT_ID, а Client Secret, который показывается один раз, в INFISICAL_CLIENT_SECRET.
4. Добавьте identity в каждый проект, к которому нужен доступ: в проекте откройте Access Control, Machine Identities, Add Identity, роль Viewer только для чтения, Developer или своя роль для записи. Ограничьте роль нужными окружениями и путями.
5. Укажите в INFISICAL_URL https://app.infisical.com (Cloud US), https://eu.infisical.com (Cloud EU) или адрес своего экземпляра, без /api и без косой черты в конце.
6. Установите коннектор и запустите infisical_list_projects: он подтвердит вход и покажет проекты, в которых состоит identity.

Коннектор входит через /api/v1/auth/universal-auth/login, передаёт access token как Authorization: Bearer и сам его обновляет.

Значения секретов попадают к ИИ: Infisical возвращает значение открытым текстом любому, кому разрешено его читать, и каждое значение, которое этот коннектор читает или записывает, проходит через диалог и через провайдера ИИ. Поэтому infisical_list_secrets и infisical_get_secret возвращают только имена и метаданные: они просят Infisical не присылать значения. Единственный инструмент, возвращающий значение, это infisical_read_secret_value, по одному секрету за вызов, и ИИ использует его, только когда вы просите именно это значение. Значения, которые вы передаёте в infisical_create_secret и infisical_update_secret, тоже проходят через диалог. Если значения вообще не должны появляться в чате, администратор рабочего пространства отключает infisical_read_secret_value или identity получает роль без права читать значения. Infisical записывает каждое чтение значения в журнал аудита.

Что читает: организацию identity (infisical_get_identity_details); проекты с их окружениями (имя, slug, id); папки окружения списком или, с recursive, всем деревом; импорты секретов, то есть другие окружения или пути, от которых папка наследует секреты; имена секретов с версией, комментарием, тегами, метаданными и отметками времени, с фильтрами tag_slugs или metadata_filter, а через infisical_get_secret метаданные одного секрета или более старую version; теги; участников проектов с их ролями, identity проектов и организации; и журнал аудита организации (infisical_list_audit_logs) с фильтрами по проекту, окружению, секрету, автору, типу события, например get-secret, update-secret или delete-secret, и датам, чтобы узнать, кто прочитал или изменил секрет. infisical_read_secret_value раскрывает ссылки вида ${DB_HOST}, если expand_secret_references не равен false.

Что записывает: infisical_create_secret, infisical_update_secret (новое значение, новое имя через new_secret_name, комментарий или теги; tag_ids заменяет весь список тегов), infisical_create_folder, infisical_create_environment и infisical_create_tag. Infisical хранит предыдущую версию секрета, поэтому изменение значения можно откатить в панели. Приложения, читающие секрет, получат новое значение при следующем запросе, поэтому ИИ уточняет у вас окружение, прежде чем писать в продакшен. Если у окружения есть политика согласования изменений, создание или обновление открывает запрос на согласование в Infisical вместо немедленного изменения секрета.

Отключены при установке: infisical_delete_secret. Его нельзя отменить из этого коннектора, и он ломает каждое приложение и пайплайн, читающие секрет, поэтому администратор рабочего пространства включает его, когда это нужно команде.

Форматы данных: id это UUID; окружения указываются по slug (dev, staging, prod), проекты по id. Пути начинаются с /, а / сам по себе это корень. version считает изменения секрета; secretValueHidden: true означает, что значение не передавалось. Время в ISO 8601, UTC.

Постраничный вывод: infisical_list_audit_logs (по умолчанию 20 записей), infisical_list_project_identities и infisical_list_org_identities (по умолчанию 100) листаются через offset и limit; ИИ запрашивает снова с большим offset, пока страница приходит полной. Остальные списки возвращают всё одним ответом.

Ограничения: Infisical Cloud допускает в минуту на IP клиента, в зависимости от тарифа, от 200 до 600 чтений, от 90 до 300 записей и от 120 до 500 операций с секретами, всего 600 запросов. Ответ 429 сообщает, сколько секунд ждать. Срок хранения журнала аудита зависит от тарифа. Для Infisical на своём сервере нужна версия 0.150 или новее ради API секретов v4, которое использует коннектор.

Частые ошибки: 401 или 403 с TokenError означает, что вход не удался: неверный Client ID или Client Secret, отозванный, просроченный или исчерпанный client secret, не тот регион в INFISICAL_URL или IP вне Trusted IPs. 403 PermissionDenied означает, что роль identity не разрешает этот проект, окружение, путь или действие. 404 означает неверный id, slug, путь или имя секрета; имена чувствительны к регистру.

С инструментами, включёнными при установке, коннектор не удаляет секреты. Он читает не больше одного значения за вызов, не меняет участников, роли и machine identity и не управляет сертификатами и ключами KMS.

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

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

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Infisical.

Доступные инструменты

Примеры запросов

• «Какие секреты есть в окружении prod нашего проекта backend? Только имена, без значений.»
• «Кто менял секрет STRIPE_SECRET_KEY в продакшене за последние 7 дней?»
• «Покажи значение DATABASE_URL в окружении staging проекта api.»
• «Создай в dev папку /payments и добавь секрет PAYMENTS_WEBHOOK_URL со значением https://example.com/hooks/payments.»
• «Какие machine identity и пользователи имеют доступ к проекту web и с какими ролями?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot