Podłączanie klienta MCP

Zacznij od uruchomienia serwera i sparowania. Ta strona opisuje rejestrację Lomi w zewnętrznym kliencie. Rejestracja serwera i zgoda na jego sesję są osobnymi krokami.

Automatyczna rejestracja

Otwórz Settings > Agent control > Connect an agent, wybierz CLI i kliknij Add Lomi to …. Lista pokazuje obsługiwane programy znalezione w domyślnym lokalnym środowisku powłoki; same pliki konfiguracyjne nie oznaczają zainstalowanego CLI. Po instalacji lub usunięciu klienta użyj Refresh.

Operacja rejestruje serwer lomi w konfiguracji użytkownika i uruchamia serwer MCP dla bieżącej sesji Lomi. Nie restartuje CLI. All client configurations > Set up all eligible clients konfiguruje klientów, którzy aktualnie kwalifikują się do instalacji.

Klient	Program	Domyślny plik użytkownika	Struktura
Claude Code	claude	~/.claude.json	mcpServers.lomi
Codex	codex	~/.codex/config.toml	[mcp_servers.lomi]
Gemini CLI	gemini	~/.gemini/settings.json	mcpServers.lomi
GitHub Copilot CLI	copilot	~/.copilot/mcp-config.json	mcpServers.lomi, typ local i lista narzędzi
Cursor CLI	cursor-agent	~/.cursor/mcp.json	mcpServers.lomi
OpenCode	opencode	~/.config/opencode/opencode.json lub .jsonc	v2 mcp.servers.lomi, tablica command
OpenClaw	openclaw	~/.openclaw/openclaw.json	JSON5 mcp.servers.lomi
Hermes Agent	hermes	~/.hermes/config.yaml	mcp_servers.lomi
Kilo Code CLI	kilo, kilocode	~/.config/kilo/kilo.jsonc	mcp.lomi, tablica command
Qwen Code	qwen	~/.qwen/settings.json	mcpServers.lomi
Kiro CLI	kiro-cli	~/.kiro/settings/mcp.json	mcpServers.lomi
Mistral Vibe	vibe	~/.vibe/config.toml	[[mcp_servers]], name = "lomi", stdio
Kimi Code CLI	kimi	~/.kimi-code/mcp.json	mcpServers.lomi
Grok Build	grok	~/.grok/config.toml	[mcp_servers.lomi]
Antigravity CLI	agy	~/.gemini/config/mcp_config.json	mcpServers.lomi, lokalne command/args

To 15 klientów dostępnych na liście Settings, a nie deklaracja, że każdy adapter w źródłach lub każda odmiana desktopowa jest tam oferowana. Propozycje na pasku stanu dla zweryfikowanych lokalnych procesów mają własne warunki obsługi. Źródłowa macierz CLI opisuje dodatkowe adaptery i klientów wymagających ręcznej konfiguracji.

Co zostaje zapisane

Automatyczna konfiguracja używa rzeczywistego pliku wykonywalnego Lomi i następującego wzorca argumentów:

--mcp --discovery-file <absolute-app-data>/agent-control/discovery.json --discovery-key <pinned-public-key>

Klucz publiczny weryfikuje podpisany opis zawierający endpoint działającej instancji i odcisk certyfikatu brokera. Rejestracja przetrwa restart serwera/aplikacji; zgoda na dostęp nie przetrwa. Po restarcie połącz klienta ponownie i, przy wyłączonym YOLO, sparuj sesję. Przeniesienie programu lub zastąpienie tożsamości w danych aplikacji wymaga ponownej rejestracji.

Lomi sprawdza rewizję konfiguracji, zachowuje kopię dokładnych oryginalnych bajtów i atomowo publikuje nowy plik. Zachowuje pozostałe ustawienia i odmawia nadpisania innego serwera o nazwie lomi. Edycja JSON/JSONC/JSON5 zachowuje niezwiązany tekst i komentarze. Edycja YAML formatuje dokument ponownie i usuwa komentarze; oryginał pozostaje w kopii. Nieobsługiwane aliasy, merge keys, tagi lub powtórzone klucze blokują zmianę YAML.

Własne profile

Settings korzysta ze środowiska konfiguracji bieżącego użytkownika. Instalacja z paska stanu używa środowiska i lokalizacji konfiguracji wykrytego procesu CLI. Istotne nadpisania dla listy klientów to CODEX_HOME, GEMINI_CLI_HOME, COPILOT_HOME, XDG_CONFIG_HOME, OPENCODE_CONFIG, OPENCLAW_CONFIG_PATH, OPENCLAW_STATE_DIR, HERMES_HOME, KILO_CONFIG, QWEN_HOME, KIRO_HOME, VIBE_HOME, KIMI_CODE_HOME i GROK_HOME. GEMINI_CLI_HOME wskazuje katalog nadrzędny .gemini; nadpisane ścieżki muszą prowadzić do lokalizacji absolutnych.

Użyj konfiguracji samego klienta, jeśli Lomi zgłosi niejednoznaczne lub dodatkowe źródło ustawień:

• OpenCode z jednoczesnym JSON i JSONC, konfiguracją inline lub dodatkowym katalogiem; starsze mapy OpenCode wymagają migracji do v2.
• Kilo z konfiguracją inline lub dodatkowym katalogiem.
• OpenClaw z własnym profilem/home.
• Claude z własnym rejestrem MCP w CLAUDE_CONFIG_DIR.
• Vibe z VIBE_CLI=rust; automatyczny adapter stdio Lomi obsługuje CLI w Pythonie.

Antigravity obsługuje też projektowy .agents/mcp_config.json; Lomi rejestruje plik globalny. W przejrzanym drzewie roboczym pusty plik Antigravity lub plik zawierający wyłącznie białe znaki JSON jest inicjalizowany dopiero po kliknięciu instalacji, z dokładną kopią. Inny niepoprawny JSON pozostaje nienaruszony. Zdalny wpis serverUrl nie jest lokalną rejestracją Lomi. Audyt źródeł wskazuje te lokalne zmiany adaptera.

Konfiguracja ręczna

Użyj Preferences > Manual configuration > MCP JSON configuration for this running instance. Najpierw uruchom serwer, a potem wybierz Copy configuration.

Ta ścieżka wymaga opcjonalnego osobnego programu lomi-mcp obok pliku wykonywalnego aplikacji. W projekcie źródłowym zbudujesz go tak:

cargo build --manifest-path src-tauri/Cargo.toml --locked -p lomi-mcp

Skopiowany JSON ma poniższą strukturę. Zastąp wszystkie placeholdery wartościami z działającej instancji; przykłady nie zawierają działających endpointów:

{
  "mcpServers": {
    "lomi": {
      "command": "/absolute/path/to/lomi-mcp",
      "args": [
        "--endpoint", "/private/current-instance/control.sock",
        "--instance", "CURRENT_INSTANCE_ID",
        "--broker-sha256", "CURRENT_BROKER_CERTIFICATE_SHA256"
      ]
    }
  }
}

Dostosuj klucz główny i format lokalnego serwera do klienta. Dla klienta TOML z mcp_servers odpowiadające wartości połączenia wyglądają tak:

[mcp_servers.lomi]
command = "/absolute/path/to/lomi-mcp"
args = ["--endpoint", "/private/current-instance/control.sock", "--instance", "CURRENT_INSTANCE_ID", "--broker-sha256", "CURRENT_BROKER_CERTIFICATE_SHA256"]

Kopiuj tę konfigurację ponownie po każdym restarcie serwera. Bezpośredni endpoint, ID instancji i odcisk certyfikatu należą do konkretnego uruchomienia. Automatyczne podpisane wykrywanie jest trwałą alternatywą.

Klient obsługujący stdio może użyć skopiowanych wartości we własnym formacie. Klient obsługujący wyłącznie zdalne serwery HTTP nie połączy się bezpośrednio z endpointem stdio Lomi. Pi wymaga rozszerzenia MCP; Aider i oficjalny SWE-agent nie uzyskają natywnej obsługi MCP przez dodanie wymyślonego wpisu konfiguracji. Lista Settings nie rejestruje automatycznie Claude Desktop ani innych niewymienionych aplikacji desktopowych.

Zgody po stronie klienta

Host MCP może wymagać własnej zgody na narzędzie. Sparowanie i zatwierdzenia operacji w Lomi nie omijają tej polityki. Jeśli modyfikujące wywołanie nie dociera do Lomi, sprawdź politykę narzędzi i interaktywną zgodę klienta. Z kolei zatwierdzenie narzędzia w kliencie nie przyznaje brakującego uprawnienia Lomi.

Aplikacja nie ma ogólnej strony ustawień do dodawania dowolnych zewnętrznych serwerów MCP do Chat AI. Natywna integracja Chat udostępnia wspólny katalog Lomi opisany w architekturze.

Kod źródłowy: katalog CLI, adaptery konfiguracji, podpisane wykrywanie. Audyt zapisuje różnice adapterów nieobecne w commicie.