URL-шортенер Gemini: где на самом деле работают вызовы инструментов

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

Разница с другими ассистентами заметнее, и всё упирается в одно архитектурное решение Google: потребительское приложение Gemini не имеет механизма для вызова API, которым владеете вы. Попросите его сократить URL и получите слаг правильного вида, за которым ничего нет. Gemini CLI - другой продукт с другим ответом, и именно там живёт вызов инструмента. Поэтому решение, похожее на выбор между двумя интерфейсами Google, на деле определяет, сможет ли ваша команда вообще этим пользоваться.

В этой статье рассматриваются три поверхности и то, что каждая из них действительно умеет: CLI по MCP, вызов функций в Gemini API и чат с готовым запросом. Параллельный материал о ChatGPT приводит к другому выводу - причины стоит понять до выбора поверхности.

Почему приложение Gemini не может создать короткую ссылку

Gems - это функция Gemini для создания пользовательских ассистентов, и на первый взгляд они похожи на аналог пользовательского GPT. Но в важном для нас отношении это не так. В Gems нет аналога Actions. Нет поля для схемы OpenAPI. Нет настройки аутентификации. Нет способа указать собственный endpoint.

Gems могут использовать собственные расширения Google: Workspace, Maps, YouTube. Их создала Google, а не вы их настроили. Поэтому разрыв в возможностях связан не с недостаточной зрелостью, которую можно исправить настройкой. Ничто, что вы напишете в инструкциях Gem, не даст ему доступ к сети и вашему API.

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

Маршрут один: Gemini CLI по MCP

Gemini CLI поддерживает протокол контекста модели, поэтому тот же @elido/mcp-server, который обслуживает Claude Desktop и Cursor, работает здесь без кода, специфичного для Gemini. Настройте его один раз, и create_link, list_links, query_analytics, generate_qr и list_workspaces появятся как вызываемые инструменты.

Добавление сервера

Быстрее всего воспользоваться встроенной командой:

gemini mcp add -s user -e ELIDO_API_KEY=$ELIDO_API_KEY elido npx -y @elido/mcp-server

Или отредактируйте файл настроек напрямую. Пользовательская область находится в ~/.gemini/settings.json, область проекта - в .gemini/settings.json, а блок размещается внутри mcpServers:

{
  "mcpServers": {
    "elido": {
      "command": "npx",
      "args": ["-y", "@elido/mcp-server"],
      "env": {
        "ELIDO_API_KEY": "$ELIDO_API_KEY",
        "ELIDO_WORKSPACE_ID": "$ELIDO_WORKSPACE_ID"
      },
      "timeout": 30000
    }
  }
}

Деталь раскрытия env, которая легко приводит к ошибке

Gemini CLI раскрывает $VAR и ${VAR} внутри блока env, поэтому ключ выше является ссылкой, а не вставленным секретом. Используйте именно такой подход. Зафиксировать в репозитории файл .gemini/settings.json с действующим ключом легко, а заметить эту ошибку удается нескоро.

В документации Google по серверу MCP есть одна важная особенность: неопределенная переменная превращается в пустую строку, а не вызывает исключение. Поэтому опечатка в имени переменной не приводит к явной ошибке при запуске. Ошибка появляется позже, при первом вызове инструмента, как ошибка аутентификации. Однажды я потратил двадцать минут на отсутствующую экспортированную переменную и всё это время перечитывал не тот файл: ошибка аутентификации указывает на учетные данные, а не на имя переменной, которая должна была их передать. Если сервер подключается, но каждый вызов возвращает ошибку авторизации, сначала проверьте переменную.

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

Маршрут два: вызов функций в Gemini API

Если вы создаете что-то, а не работаете интерактивно, вызов функций - эквивалентный механизм на уровне API. Вы объявляете функцию, модель возвращает структурированный вызов, когда считает его необходимым, ваш код выполняет запрос, а затем вы передаете результат обратно.

Схема такая же, как у любой интеграции инструментов. Опишите create_link, самостоятельно выполните HTTP-запрос и верните ответ. Преимущество перед MCP - контроль. Вы точно решаете, какие параметры может задавать модель, и можете отклонить всё, что не соответствует вашим правилам именования, ещё до того, как запрос покинет ваш процесс. Недостаток - переносимость. Это подключение придётся поддерживать вам, и оно никуда за вами не последует.

Для большинства команд этот маршрут имеет смысл только тогда, когда сокращение является одним шагом в более крупном автоматизированном процессе. Если вам просто нужны ссылки во время работы, CLI требует меньше кода и меньше постоянного обслуживания.

Маршрут три: чат с готовым запросом

Вариант без настройки - ссылка, которая открывает Gemini уже с написанным запросом:

https://gemini.google.com/app?q=<url-encoded%20prompt>

Именно этот механизм используется кнопками на странице интеграций LLM, что было подтверждено на работающей поверхности в апреле 2026 года. Поведение параметров запроса в любом продукте на основе ИИ меняется, поэтому проверьте его заново, если кнопка перестала работать как раньше.

Трезво оцените, что это дает, учитывая первый раздел. У ассистента нет инструментов, поэтому он готовит черновик, а вы выполняете действие. Это всё равно полезно. Запуск, для которого нужны восемь вариантов UTM-меток по единой схеме именования, утомительно собирать вручную, а модели легко с этим справиться. Просто в результате не появляется ссылка.

Какой маршрут выбрать

Сопоставьте эту таблицу с таблицей для ChatGPT, и асимметрия станет очевидной. В ChatGPT именно доступная для общего использования поверхность может содержать подключенное действие, поэтому маркетинговой команде можно передать работающий пользовательский GPT. Подключенная поверхность Gemini - терминал. Если ваши пользователи - маркетологи, это различие определяет выбор платформы ещё до сравнения функций.

Ограничение области действия ключа

Сервер MCP хранит учетные данные, а модель их никогда не видит, и это правильная схема. Но вам всё равно нужно решить, что именно могут делать эти учетные данные.

Выпускайте отдельный ключ для каждой интеграции, а не используйте один ключ в нескольких инструментах. Ключу для интерактивного создания ссылок нужны права на создание ссылок и чтение аналитики; удалять ссылки или обращаться к пользовательским доменам ему не нужно. Когда в журнале аудита появляется что-то неожиданное, отдельный ключ для интеграции позволяет понять, какая поверхность это создала, а его отзыв ничего больше не нарушает.

Об области проекта стоит подумать отдельно. Зафиксированный в общем репозитории .gemini/settings.json удобен, но этот файл унаследует каждый участник. Храните секрет в окружении, а файл настроек оставляйте без всего, что вы не стали бы вставлять в запрос на слияние.

Честные ограничения

Здесь стоит заранее обозначить три вещи.

Набор инструментов намеренно небольшой. @elido/mcp-server находится на версии 0.1.x и включает пять инструментов, а администрирование рабочего пространства в него сознательно не входит. Приглашение людей, настройка доменов и смена тарифов остаются в панели управления, где их выполняет вошедший в систему человек.

Массовую работу лучше выполнять в другом месте. Запрос на сорок ссылок в одном разговоре приводит к ошибкам ограничения частоты и к тому, что модель перестает понимать, какой слаг относится к какому адресу назначения. Если ссылок больше нескольких, используйте API или импорт CSV.

Что же касается отсутствия возможностей у приложения, насколько было объявлено, это не временная проблема. Планируйте работу с учетом этого, а не ждите изменений. Если нетехнической команде уже сегодня нужно создавать ссылки из интерфейса чата, честный ответ - другой ассистент или панель управления, а не Gem.

Прочитайте опорную статью → Подключите Elido к Claude и Cursor по MCP

По теме в блоге

• URL-шортенер ChatGPT: что работает, а что только делает вид - тот же вопрос, но другой ответ.
• Подключите Elido к Claude и Cursor по MCP - полный справочник по MCP, на котором основан этот материал.
• Быстрый старт с API URL-шортенера - REST-поверхность, лежащая под всеми описанными здесь маршрутами.
• Короткие ссылки как Terraform - когда ссылкам место в коде, а не в чате.