Как использовать Gemini API в Gemini CLI через MCP

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

Gemini API + Gemini CLI

Дайте ИИ работать с Google Gemini через ваш собственный API-ключ: задавать вопросы моделям Gemini, анализировать изображения и PDF по ссылке, считать токены, создавать эмбеддинги, а также создавать и редактировать изображения с помощью Nano Banana, которые появляются прямо в чате.

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

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

GEMINI_API_KEY

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

1. Откройте Google AI Studio по адресу https://aistudio.google.com/apikey и войдите со своей учётной записью Google.
2. Нажмите Create API key, выберите или создайте проект Google Cloud и скопируйте ключ. Обычно он начинается с AIza.
3. Вставьте его в GEMINI_API_KEY и установите коннектор. Ключ отправляется только в Google.
4. Чтобы создавать изображения или получить более высокие лимиты, включите оплату для проекта ключа в AI Studio (Get API key, затем Set up billing). У моделей изображений нет бесплатного уровня.
5. Запустите gemini_list_models, чтобы увидеть, какие модели доступны вашему ключу. Это бесплатно.

Оплата: Gemini API работает с вашим собственным ключом. Каждый вызов, кроме списка моделей, Files API и подсчёта токенов, оплачивается проектом ключа или засчитывается в его бесплатный уровень. На бесплатном уровне текстовые модели и модели эмбеддингов бесплатны в пределах поминутных и суточных лимитов, а Google может использовать промпты с бесплатного уровня для улучшения своих продуктов. ИИ использует дешёвые и быстрые модели по умолчанию (gemini-3.1-flash-lite для текста, gemini-embedding-001 для эмбеддингов), пока вы не попросите более мощную, а gemini_count_tokens бесплатно оценивает длинный промпт до отправки.

Изображения платные: gemini_generate_image и gemini_edit_image создают или изменяют изображения с помощью Nano Banana и показывают их прямо в чате. Модель изображений по умолчанию стоит около 0,034 $ за изображение, самая мощная около 0,13 $, поэтому ИИ подтверждает у вас каждое изображение. Изображения больше 4 МБ не возвращаются: попросите меньший размер.

Файлы по ссылке: gemini_analyze_file_url отвечает на вопросы об изображении, PDF, текстовом или CSV-файле или коротком видео по публичной HTTPS-ссылке размером до 15 МБ. Gemini сам открывает ссылку, поэтому она должна работать без входа в систему. Инструменты Files API показывают и читают сохранённые файлы проекта, которые удаляются через 48 часов. gemini_delete_file при установке отключён.

Частые ошибки: 400 с недействительным ключом: ключ неверный или удалён, создайте новый в AI Studio. 403: ключ ограничен другими API (в Google Cloud console в разделе Credentials, API restrictions разрешите Generative Language API), API отключён в его проекте или ссылка на файл не публичная. 404: такого кода модели нет, проверьте через gemini_list_models. 429: достигнут лимит бесплатного или платного уровня либо модель изображений вызвана без включённой оплаты; подождите или включите оплату. Ошибка 400 о том, что бесплатный уровень недоступен, означает, что в вашем регионе он не предлагается: включите оплату. Запрос, заблокированный фильтрами безопасности Google, возвращается как ошибка и не повторяется.

Коннектор не загружает файлы, не передаёт аудио и видео в потоке (Live API), не создаёт речь и видео (Veo) и не работает с кэшированием контекста, пакетными заданиями, дообученными моделями и хранилищами для поиска по файлам.

Шаг 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 теперь может вызывать инструменты Gemini API.

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

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

• «Прочитайте PDF с прайс-листом поставщика по ссылке, которую я вставлю ниже, и перечислите все товары с ценами.»
• «Попросите Gemini переписать это описание товара для нашего интернет-магазина короче и дружелюбнее.»
• «Сколько токенов это коммерческое предложение для Gemini и сколько будет стоить его краткое изложение на модели по умолчанию?»
• «Создайте с помощью Nano Banana фото нашей синей керамической кружки на деревянном столе, но сначала назовите стоимость и дождитесь моего согласия.»

FAQ

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

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

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT