A Gemini csatlakoztatása a dignához¶
Ez az útmutató a Google Gemini-eszközeit a digna MCP Serverhez csatlakoztatja. Szüksége lesz a digna telepítés MCP-végpontjára és egy API-kulcsra, az AI-ágensek áttekintése oldalon leírtak szerint.
A példák a https://digna.example.com/mcp végpontot használják. Cserélje le a sajátjára.
Az eszköz kiválasztása¶
| Eszköz | Kinek | Konfiguráció |
|---|---|---|
| Antigravity CLI, IDE és alkalmazás | A Google ágenseszközei. Az Antigravity CLI 2026 júniusában váltotta fel a Gemini CLI-t az egyéni Google-fiókoknál | mcp_config.json |
| Gemini CLI | Gemini Code Assist Standard és Enterprise licencek, valamint fizetős Gemini API-kulcsok | settings.json vagy gemini mcp add |
| Gemini Enterprise alkalmazás | — | Nem támogatott. Egyéni MCP-connectora OAuth-tal vagy Google Cloud szolgáltatásfiókkal jelentkezik be, a digna MCP Server viszont API-kulcsokkal hitelesít |
Mindegyik eszköz arról a gépről csatlakozik, amelyen fut, így a vállalati hálózaton belül futó dignával is működik, amíg az adott gép eléri a végpontot.
Antigravity¶
Az Antigravity az MCP-szervereit az mcp_config.json fájlból olvassa be, amelyen a CLI, az IDE és az alkalmazás osztozik.
1. Az mcp_config.json megnyitása¶
| Scope | Fájl |
|---|---|
| Minden projektje | ~/.gemini/config/mcp_config.json |
| Egy workspace | .agents/mcp_config.json a workspace-ben |
A használatban lévő fájl megnyitása:
- CLI: írja be a
/mcpparancsot, és nyomja meg az Enter billentyűt az MCP-kezelő megnyitásához. - IDE: az ágens oldalpaneljén nyissa meg a … menüt, válassza az MCP Servers, majd a Manage MCP Servers, végül a View raw config elemet.
- Alkalmazás: lépjen a Customizations > Installed > MCP Servers oldalra, és használja a Copy Config File Path parancsot.
2. A digna szerver hozzáadása¶
Adja hozzá a digna bejegyzést. Ha a fájlban már van mcpServers szakasz, oda vegye fel:
{
"mcpServers": {
"digna": {
"serverUrl": "https://digna.example.com/mcp",
"headers": {
"Authorization": "Bearer <api key>"
}
}
}
}
Az Antigravity a távoli szervereket csak streamable HTTP-n éri el, és a digna MCP Server ezt használja. A végpontot serverUrl kulccsal adja meg; a Gemini CLI httpUrl kulcsa nem támogatott.
3. A kapcsolat ellenőrzése¶
A CLI-ben írja be a /mcp parancsot: az MCP-kezelő megmutatja a digna szervert az állapotával és az eszközeivel, és újra tudja tölteni a konfigurációt, valamint meg tudja jeleníteni a kapcsolati naplókat. Az IDE-ben a szerver a Manage MCP Servers alatt jelenik meg.
Védje a fájlt
Az mcp_config.json egyszerű szövegként tartalmazza az API-kulcsot. A workspace .agents/mcp_config.json fájlját tartsa távol a verziókezeléstől, a globális fájlt pedig csak a saját fiókja olvashassa.
Gemini CLI¶
1. A szerver hozzáadása¶
Tegye az API-kulcsot egy környezeti változóba, majd adja hozzá a szervert:
export DIGNA_API_KEY='<api key>'
gemini mcp add --transport http --scope user --header "Authorization: Bearer $DIGNA_API_KEY" digna https://digna.example.com/mcp
A shell a parancs futtatásakor behelyettesíti a $DIGNA_API_KEY értékét, így a Gemini CLI a kulcsot a saját beállításaiban tárolja. A --scope user nélkül a szerver csak az aktuális projekthez adódik hozzá.
2. Vagy a settings.json szerkesztése¶
A fenti parancs a settings.json fájlba ír. Ha a fájlt saját maga szeretné szerkeszteni:
| Scope | Fájl |
|---|---|
| Minden projektje | ~/.gemini/settings.json |
| Egy projekt | .gemini/settings.json a projektben |
{
"mcpServers": {
"digna": {
"httpUrl": "https://digna.example.com/mcp",
"headers": {
"Authorization": "Bearer <api key>"
}
}
}
}
Használja a httpUrl kulcsot, ez a streamable HTTP kulcsa. A hasonló url kulcs a régebbi SSE transzportot választja, amelyet a digna MCP Server nem kínál. A szerver nevében ne használjon aláhúzásjelet.
Hagyja kikapcsolva a trust beállítást
A Gemini CLI minden eszközhívás előtt rákérdez, kivéve, ha a szervernél "trust": true van beállítva. A digna esetében hagyja kikapcsolva a trust beállítást, hogy minden módosítást megerősíthessen, amelyet egy ágens a konfigurációjában végez.
3. A kapcsolat ellenőrzése¶
A shellből:
A digna szervernek csatlakoztatottként kell megjelennie. Egy Gemini CLI munkameneten belül futtassa a /mcp parancsot a szerver és az eszközei megtekintéséhez.
Hibaelhárítás – Gemini¶
A szerver leválasztottként jelenik meg¶
- Ellenőrizze, hogy a végpont
/mcpvégződésű-e, és elérhető-e a gépéről. - Ellenőrizze a kulcs nevét:
serverUrlaz Antigravityben,httpUrla Gemini CLI-ben. - A
401azt jelenti, hogy a kulcsot elutasították; lásd: 401 Unauthorized.
A Gemini CLI már nem indul el a fiókommal¶
2026 júniusa óta az egyéni Google-fiókok a Gemini CLI helyett az Antigravity CLI-t használják. Helyezze át a digna bejegyzést az mcp_config.json fájlba az Antigravity részben leírtak szerint, és nevezze át a httpUrl kulcsot serverUrl névre.
Lásd még¶
- AI-ágensek áttekintése: végpont, API-kulcs, biztonság és általános hibaelhárítás
- Claude: a Claude Code, a Claude Desktop vagy egy egyéni connector csatlakoztatása
- digna Agentic: mire képesek az AI-ágensek a dignával