A Claude csatlakoztatása a dignához¶

Ez az útmutató a Claude-ot 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.

A csatlakozás módjának kiválasztása¶

Ha a digna a vállalati hálózaton belül fut, használja a Claude Code-ot vagy a Claude Desktopot helyi híddal.

Claude Code¶

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>'
claude mcp add --transport http --scope user digna https://digna.example.com/mcp --header "Authorization: Bearer $DIGNA_API_KEY"

A shell a parancs futtatásakor behelyettesíti a $DIGNA_API_KEY értékét, így a Claude Code a kulcsot a saját konfigurációjában tárolja.

A --scope határozza meg, hol érhető el a szerver:

2. A szerver megosztása a csapattal (opcionális)¶

Ha egy projektben mindenkinek ugyanazt a szervert szeretné biztosítani, helyezzen egy .mcp.json fájlt a projekt gyökérkönyvtárába. A kulcsot ne írja bele a fájlba. A Claude Code a ${DIGNA_API_KEY} értékét mindenkinek a saját környezetéből tölti ki:

{
  "mcpServers": {
    "digna": {
      "type": "http",
      "url": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGNA_API_KEY}"
      }
    }
  }
}

Mindenki a saját kulcsára állítja a DIGNA_API_KEY változót. Amikor a Claude Code először megtalálja a fájlt, megkérdezi, hogy használja-e a benne lévő szervereket.

3. A kapcsolat ellenőrzése¶

A shellből:

claude mcp list

A digna szervernél ✔ Connected állapotnak kell megjelennie. Egy Claude Code munkameneten belül futtassa a /mcp parancsot a szerver és az eszközei megtekintéséhez.

Claude Desktop helyi híddal¶

A Claude Desktop konfigurációs fájlja helyi MCP-szervereket indít az Ön gépén. Egy kis híd, a nyílt forráskódú mcp-remote csomag fut ott, és minden kérést az Ön API-kulcsával továbbít a digna végpontjára. Mivel a híd az Ön gépén fut, ez a módszer a vállalati hálózaton belül futó dignával is működik.

1. A Node.js telepítése¶

A hídhoz Node.js 18 vagy újabb szükséges. A Claude Desktop a rendszerére telepített Node.js verziót használja. Ellenőrizze ezzel:

node --version

2. A konfigurációs fájl szerkesztése¶

Nyissa meg a claude_desktop_config.json fájlt:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Adja hozzá a digna szervert. Ha a fájlban már van mcpServers szakasz, abba vegye fel a digna bejegyzést:

{
  "mcpServers": {
    "digna": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://digna.example.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <api key>"
      }
    }
  }
}

3. A Claude Desktop újraindítása¶

Lépjen ki teljesen a Claude Desktopból, és indítsa el újra. Egy új csevegésben kattintson a + gombra, és nyissa meg a Connectors menüt: a digna elemnek szerepelnie kell a listában, bekapcsolva.

Egyéni connector¶

Az egyéni connector helyi beállítás nélkül teszi elérhetővé a dignát a claude.ai-ban, a Claude Desktopban és a Claude mobilalkalmazásokban. A végponthoz az Anthropic felhője csatlakozik, ezért ez csak akkor működik, ha:

• A digna végpontja HTTPS-en elérhető az internetről
• A Claude-szervezetében az Add custom connector párbeszédablakban elérhető a Request headers beállítás. Az Anthropic ezt bétaként a szervezetek szűk körének kínálja

1. A connector-beállítások megnyitása¶

• Free, Pro, Max és Ultra előfizetés: lépjen a Customize > Connectors oldalra, és kattintson az Add custom connector gombra.
• Team és Enterprise előfizetés: egy Owner a Organization settings > Connectors oldalon a Add, majd a Custom gombra kattint, és ha a rendszer rákérdez a típusra, a Web lehetőséget választja.

2. A connector adatainak megadása¶

1. MCP server URL: https://digna.example.com/mcp
2. Authentication: No sign-in
3. Request headers: fejlécnévként válassza az authorization értéket, értékként adja meg a Bearer <api key> szöveget, a Bearer szóval és a szóközzel együtt, és jelölje meg Required beállítással.
4. Kattintson az Add gombra.

Team és Enterprise előfizetésnél a tagok ezután a Customize > Connectors oldalon csatlakoznak, ahol a connector a Custom címkét viseli.

A Claude nem tudja módosítani egy meglévő connector fejlécét. Új kulcs használatához távolítsa el a connectort, és adja hozzá újra.

Hibaelhárítás – Claude¶

A claude mcp list Failed to connect üzenetet mutat¶

Az ok megtekintéséhez futtassa a claude mcp get digna parancsot. A 401 azt jelenti, hogy a kulcsot elutasították; lásd: 401 Unauthorized. A Claude Code figyelmeztet a kulcs elején vagy végén lévő szóközökre és sortörésekre is, amelyek gyakran a másoláskor kerülnek bele.

A digna nem jelenik meg a Claude Desktopban¶

• Ellenőrizze, hogy telepítve van-e a Node.js 18 vagy újabb verziója: node --version.
• Ellenőrizze, hogy a claude_desktop_config.json érvényes JSON-e. Egy hiányzó vessző miatt a fájl egyik szervere sem töltődik be.
• Lépjen ki teljesen a Claude Desktopból, ne csak az ablakot zárja be, és indítsa el újra.

Az egyéni connector nem éri el a szervert¶

Az Anthropic felhője nem éri el a végpontot. Ellenőrizze, hogy a végpont érvényes tanúsítvánnyal, HTTPS-en elérhető-e az internetről, vagy csatlakozzon inkább a Claude Code segítségével.

Lásd még¶

• AI-ágensek áttekintése: végpont, API-kulcs, biztonság és általános hibaelhárítás
• Gemini: az Antigravity vagy a Gemini CLI csatlakoztatása
• digna Agentic: mire képesek az AI-ágensek a dignával