Skracacz URL Gemini: gdzie wywołania narzędzi naprawdę działają

Gemini może utworzyć działający krótki link. Tylko nie w miejscu, od którego większość osób zaczyna.

Różnica jest wyraźniejsza niż w przypadku innych asystentów i sprowadza się do jednej decyzji architektonicznej podjętej przez Google: konsumencka aplikacja Gemini nie ma mechanizmu wywoływania API, którego jesteś właścicielem. Poproś ją o skrócenie adresu URL, a dostaniesz slug o właściwym kształcie, za którym nic się nie kryje. Gemini CLI to inny produkt z inną odpowiedzią i właśnie tam znajduje się wywołanie narzędzia. Dlatego decyzja, która wygląda jak wybór między dwiema powierzchniami Google, w praktyce rozstrzyga, czy Twój zespół w ogóle może z tego korzystać.

Ten artykuł omawia trzy powierzchnie i to, co każda z nich naprawdę potrafi: CLI przez MCP, wywoływanie funkcji w Gemini API oraz wstępnie wypełniony czat. Równoległy artykuł o ChatGPT prowadzi do innego wniosku, z powodów, które warto zrozumieć przed wyborem powierzchni.

Dlaczego aplikacja Gemini nie może utworzyć krótkiego linku

Gems to funkcja niestandardowego asystenta Gemini i na pierwszy rzut oka wygląda jak odpowiednik niestandardowego GPT. W istotnym dla nas aspekcie nim nie jest. Gems nie ma odpowiednika Actions. Nie ma pola schematu OpenAPI. Nie ma konfiguracji uwierzytelniania. Nie ma sposobu wskazania własnego endpointu.

Gems może używać własnych rozszerzeń Google: Workspace, Maps i YouTube. Są one zbudowane przez Google, a nie konfigurowane przez Ciebie. Luka w możliwościach nie jest więc luką dojrzałości, którą można zamknąć ustawieniem. Nic, co wpiszesz w instrukcjach Gema, nie zapewni mu dostępu sieciowego do Twojego API.

Dlatego aplikacja robi z prośbą o krótki link to, co każdy asystent bez narzędzi. Tworzy wiarygodnie wyglądające znaki. Warto o tym wiedzieć, zanim spędzisz popołudnie na tworzeniu kolejnych promptów.

Droga pierwsza: Gemini CLI przez MCP

Gemini CLI obsługuje Model Context Protocol, co oznacza, że ten sam @elido/mcp-server, który obsługuje Claude Desktop i Cursor, działa tutaj bez kodu specyficznego dla Gemini. Skonfiguruj go raz, a create_link, list_links, query_analytics, generate_qr i list_workspaces pojawią się jako narzędzia, które można wywoływać.

Dodawanie serwera

Najszybsza droga prowadzi przez wbudowane polecenie:

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

Możesz też bezpośrednio edytować plik ustawień. Zakres użytkownika znajduje się w ~/.gemini/settings.json, zakres projektu w .gemini/settings.json, a blok należy umieścić pod 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
    }
  }
}

Szczegół rozwijania env, który potrafi ugryźć

Gemini CLI rozwija $VAR i ${VAR} wewnątrz bloku env, dlatego pokazany wyżej klucz jest odwołaniem, a nie wklejonym sekretem. Używaj tego mechanizmu. Zapisanie aktywnego klucza w objętym zakresem projektu pliku .gemini/settings.json to łatwy do popełnienia błąd, który długo może pozostać niezauważony.

Jeden z ostrych brzegów opisanych w dokumentacji serwera MCP Google jest taki: niezdefiniowana zmienna zostaje rozwinięta do pustego ciągu, a nie powoduje wyjątku. Literówka w nazwie zmiennej nie wywołuje więc wyraźnego błędu przy uruchomieniu. Błąd pojawia się później, przy pierwszym wywołaniu narzędzia, jako błąd uwierzytelniania. Straciłem dwadzieścia minut z powodu brakującego eksportu i cały ten czas spędziłem na ponownym czytaniu niewłaściwego pliku, bo błąd uwierzytelniania wskazuje na dane uwierzytelniające, a nie na nazwę zmiennej, która miała je przenosić. Jeśli serwer się łączy, ale każde wywołanie kończy się błędem braku autoryzacji, najpierw sprawdź zmienną.

Skonfiguruj klucz, a następny opis kampanii napisany w terminalu będzie mógł sam utworzyć własne linki: uruchom workspace i wygeneruj klucz o ograniczonym zakresie dla tej jednej integracji.

Droga druga: wywoływanie funkcji w Gemini API

Jeśli coś budujesz, zamiast pracować interaktywnie, wywoływanie funkcji jest odpowiednikiem tego mechanizmu na poziomie API. Deklarujesz funkcję, model zwraca ustrukturyzowane wywołanie, gdy uzna je za uzasadnione, Twój kod wykonuje żądanie, a następnie przekazujesz wynik z powrotem.

Schemat jest taki sam jak w każdej integracji z narzędziem. Opisz create_link, samodzielnie wykonaj żądanie HTTP i zwróć odpowiedź. W porównaniu z MCP zyskujesz kontrolę. Dokładnie decydujesz, które parametry może ustawiać model, i możesz odrzucić wszystko, co wykracza poza Twoją konwencję nazewnictwa, zanim żądanie opuści Twój proces. Tracisz za to przenośność. To połączenie musisz utrzymywać sam i nigdzie za Tobą nie podąża.

Dla większości zespołów ta droga ma sens tylko wtedy, gdy skracanie jest jednym krokiem większego zautomatyzowanego przepływu. Jeśli po prostu chcesz tworzyć linki podczas pracy, CLI wymaga mniej kodu i mniej elementów do utrzymywania.

Droga trzecia: wstępnie wypełniony czat

Opcja bez konfiguracji to link, który otwiera Gemini z gotowym promptem:

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

To mechanizm stojący za przyciskami na stronie integracji LLM, potwierdzony na działającej powierzchni w kwietniu 2026 roku. Zachowanie parametrów zapytania w każdym produkcie AI może się zmieniać, więc przetestuj je ponownie, jeśli przycisk przestanie działać jak wcześniej.

Miej jasność co do tego, co otrzymujesz, pamiętając o pierwszej sekcji. Asystent nie ma narzędzi, więc przygotowuje treść, a Ty wykonujesz działanie. To nadal jest przydatne. Premiera wymagająca ośmiu wariantów UTM według spójnego schematu nazewnictwa jest żmudna do przygotowania ręcznie, a model z łatwością może zrobić to dobrze. Po prostu nie kończy się linkiem.

Która droga pasuje do Twojego przypadku

Przeczytaj tę tabelę obok tabeli ChatGPT - na tym polega asymetria. Udostępniana powierzchnia ChatGPT może przechowywać połączoną akcję, więc zespołowi marketingowemu można przekazać działający niestandardowy GPT. Połączoną powierzchnią Gemini jest terminal. Jeśli Twoimi użytkownikami są marketerzy, ta różnica rozstrzyga o wyborze platformy, zanim w ogóle porównasz funkcje.

Ograniczanie zakresu klucza

Serwer MCP przechowuje dane uwierzytelniające, a model nigdy ich nie widzi, co jest właściwym rozwiązaniem. Nadal musisz jednak zdecydować, co te dane uwierzytelniające mogą robić.

Wystawiaj osobny klucz dla każdej integracji zamiast używać jednego w wielu narzędziach. Klucz do interaktywnego tworzenia linków musi umożliwiać tworzenie linków i odczyt analityki; nie musi pozwalać na usuwanie linków ani dotykanie domen własnych. Gdy w dzienniku audytu pojawi się coś nieoczekiwanego, klucz przypisany do integracji powie Ci, która powierzchnia to utworzyła, a jego unieważnienie niczego innego nie zepsuje.

Zakres projektu zasługuje na dodatkową uwagę. Plik .gemini/settings.json zapisany we współdzielonym repozytorium jest wygodny, ale dziedziczy go także każdy współtwórca. Przechowuj sekret w środowisku, a w pliku ustawień nie umieszczaj niczego, czego nie wkleiłbyś do pull requesta.

Uczciwe granice

Warto ustawić oczekiwania w trzech kwestiach.

Powierzchnia narzędzi jest celowo niewielka. @elido/mcp-server jest w wersji 0.1.x i ma pięć narzędzi, a administracja workspace'em celowo nie jest jednym z nich. Zapraszanie osób, konfigurowanie domen i zmiana planów pozostają w dashboardzie, gdzie wykonuje je zalogowany człowiek.

Praca zbiorcza należy do innego miejsca. Prośba o czterdzieści linków w jednej rozmowie prowadzi do błędów limitu częstotliwości, a model traci orientację, który slug odpowiada któremu miejscu docelowemu. Powyżej kilku linków użyj API albo importu CSV.

Nikt nie zapowiedział, że ta luka w aplikacji zniknie, więc nie traktuj jej jako tymczasowej. Planuj z jej uwzględnieniem, zamiast czekać, aż zniknie. Jeśli nietechniczny zespół musi dziś tworzyć linki z poziomu czatu, uczciwą odpowiedzią jest inny asystent albo dashboard, a nie Gem.

Przeczytaj artykuł filarowy → Połącz Elido z Claude i Cursorem przez MCP

Powiązane na blogu

• Skracacz URL ChatGPT: co działa, a co tylko udaje - to samo pytanie, inna odpowiedź.
• Połącz Elido z Claude i Cursorem przez MCP - pełna dokumentacja MCP, na której opiera się ten artykuł.
• Szybki start API skracacza URL - warstwa REST znajdująca się pod każdą z opisanych dróg.
• Krótkie linki jako Terraform - gdy linki powinny należeć do kodu, a nie do czatu.