Dodaj konektor MCP do Gemini CLI

Konektor pozwala asystentowi korzystać z innego narzędzia lub usługi. Konektory używają wspólnego standardu o nazwie MCP (Model Context Protocol). Sam konektor nazywa się serwerem MCP.

Są dwa popularne rodzaje:

• Lokalny (stdio): konektor działa na komputerze. Dodajesz go komendą, która go uruchamia.
• Zdalny (http): konektor działa w internecie. Dodajesz go za pomocą adresu internetowego (URL).

Znajdź komendę konfiguracji konektora

Otwórz oficjalną stronę konektora, który chcesz dodać. Poszukaj adresu URL albo komendy startowej, na przykład komendy zaczynającej się od npx. Dodawaj tylko konektory od osób, którym ufasz.

Dodaj konektor

Wpisujesz to w zwykłym terminalu, a nie w sesji Gemini. Wzór wygląda tak:

$ gemini mcp add [options] <name> <commandOrUrl> [args...]

Nazwę wybierasz dowolnie. Przy zdalnym konektorze dodaj --transport http. Przykład od Google, z wymyślonym adresem:

$ gemini mcp add --transport http http-server https://api.example.com/mcp/

Przy lokalnym konektorze wpisz komendę startową po nazwie. Przykład od Google, z wymyślonym serwerem:

$ gemini mcp add python-server python server.py -- --server-arg my-value

Aby przekazać ustawienie, na przykład klucz, dodaj -e KEY=value. Aby wysłać do zdalnego konektora nagłówek logowania, dodaj --header.

Wybierz, gdzie konektor działa

Domyślnie gemini mcp add zapisuje konektor dla bieżącego projektu, w pliku .gemini/settings.json w folderze projektu. Dodaj --scope user, aby zapisać go w ~/.gemini/settings.json. Wtedy działa we wszystkich projektach.

Gdy się uczysz, nie używaj opcji --trust. Pomija ona wszystkie pytania o potwierdzenie dla tego konektora.

Sprawdź, czy się udało

$ gemini mcp list

Przy każdym konektorze zobaczysz Connected albo Disconnected. Lokalny konektor pokazuje się jako połączony tylko w folderze, któremu ufasz. W sesji wpisz /mcp list, aby zobaczyć konektory i ich narzędzia. Jeśli zdalny konektor wymaga logowania, wpisz /mcp auth <name>.

Usuń konektor

$ gemini mcp remove <name>

Jeśli dodajesz konektor z opcją --scope user, dodaj ją także tutaj. Konektory, które sprawdziliśmy, znajdziesz na naszej liście konektorów.