Kihagyás

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 /mcp parancsot, é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:

gemini mcp list

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 /mcp végződésű-e, és elérhető-e a gépéről.
  • Ellenőrizze a kulcs nevét: serverUrl az Antigravityben, httpUrl a Gemini CLI-ben.
  • A 401 azt 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