Povežite agente UI z digna¶

digna MCP Server agentom umetne inteligence (UI) omogoča delo z digna prek Model Context Protocol (MCP), odprtega standarda, ki ga podpirajo Claude, Gemini in številna druga orodja UI. Agent, povezan z digna, lahko odgovarja na vprašanja o vaših podatkih, raziskuje opozorila in pomaga pri konfiguraciji digna. Kaj zmorejo agenti, si oglejte v digna Agentic.

Ta stran opisuje stran digna, ki je enaka za vse odjemalce UI. Vodiči za odjemalce nato pokažejo, kam vnesete končno točko in ključ:

Claude: Claude Code, Claude Desktop in konektorji po meri
Gemini: Antigravity in Gemini CLI

Beta

digna Agentic in z njim digna MCP Server sta na voljo kot različica beta v Release 2026.11.

Preden začnete¶

Potrebujete:

digna Release 2026.11 ali novejšo različico
Licenco, ki vključuje digna Agentic. Brez nje strežnik MCP zavrne vsako zahtevo
Uporabniški račun digna. Agent v vsakem projektu deluje s pravicami tega uporabnika, glejte Pravice
Odjemalec UI, ki se z oddaljenimi strežniki MCP povezuje prek streamable HTTP in lahko pošlje glavo Authorization

1. Poiščite končno točko MCP¶

Strežnik MCP je del zaledja digna, zato ni treba ničesar dodatno namestiti ali zagnati. Njegova končna točka je naslov zaledja, ki mu sledi /mcp:

https://digna.example.com/mcp

Če zaledje teče neposredno na gostitelju in vratih, na primer po digna serve --address 0.0.0.0 --port 8082, je končna točka ta naslov z /mcp:

http://digna-host:8082/mcp

Če je pred zaledjem obratni posrednik (reverse proxy), mora ta posredovati /mcp zaledju skupaj z glavo Authorization.

V omrežju uporabljajte HTTPS

Vsaka zahteva vsebuje ključ API. HTTPS uporabljajte vedno, kadar odjemalec UI in digna nista na istem računalniku.

Od kod prihaja povezava¶

Večina odjemalcev UI se poveže z računalnika, na katerem teče: Claude Code, Claude Desktop z lokalnim mostom, Antigravity in Gemini CLI. Zanje mora biti digna dosegljiva le s tega računalnika, na primer znotraj omrežja vašega podjetja.

Claudovi konektorji po meri (custom connectors) so drugačni: s končno točko se poveže oblak Anthropic. Delujejo le, če je končna točka dosegljiva iz interneta prek HTTPS. Za namestitev digna, ki je dosegljiva le znotraj vašega omrežja, uporabite odjemalec, ki teče na vašem računalniku.

2. Ustvarite ključ API¶

Odjemalec UI se overi s ključem API uporabnika digna.

Prijavite se v digna.
Odprite svoj uporabniški profil v spodnjem levem kotu.
Kliknite API Keys, nato Add API Key.
Vnesite ime, ki pove, čemu je ključ namenjen, npr. Claude Code – Marcin, in izberite, kdaj poteče.
Kopirajte ključ. Prikazan je le enkrat.

Vsaka zahteva strežniku MCP pošlje ključ v tej glavi:

Authorization: Bearer <api key>

Beseda Bearer in presledek za njo sta del vrednosti glave.

3. Povežite svoj odjemalec UI¶

Odjemalec UI	Poveže se z	Vodič
Claude Code	Vaš računalnik	Claude
Claude Desktop z lokalnim mostom	Vaš računalnik	Claude
Konektor po meri za Claude (claude.ai, Claude Desktop, Claude za mobilne naprave)	Oblak Anthropic	Claude
Antigravity CLI, IDE in aplikacija	Vaš računalnik	Gemini
Gemini CLI	Vaš računalnik	Gemini

Delujejo tudi drugi odjemalci MCP, če podpirajo oddaljene strežnike prek streamable HTTP z glavo po meri. Večina jih bere konfiguracijo, kot je ta. Točna imena datoteke in ključev poiščite v dokumentaciji svojega odjemalca:

{
  "mcpServers": {
    "digna": {
      "type": "http",
      "url": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <api key>"
      }
    }
  }
}

4. Preizkusite¶

Agenta vprašajte nekaj, na kar lahko odgovori le digna:

»Izpiši moje projekte digna.«
»Kateri podatkovni viri v projektu X danes niso zeleni?«
»Pojasni zadnje neuspešno preverjanje podatkovnega vira Y.«

Če agent izpiše vaše projekte, povezava deluje.

Varnost¶

En ključ na osebo in odjemalec. Tako lahko posamezen ključ prekličete z Delete API Key, ne da bi to vplivalo na koga drugega.
Uporabnika izberite premišljeno. Agent lahko naredi vse, kar lahko naredi uporabnik ključa. Samo za raziskovanje podatkov uporabite uporabnika z vlogo bralca v projektih.
Ključev ne hranite v skupnih datotekah. Ne potrjujte (commit) konfiguracijske datoteke, ki vsebuje ključ. Kjer odjemalec to podpira, ključ preberite iz spremenljivke okolja.
Nastavite rok veljavnosti. Pred potekom starega ključa ustvarite novega in posodobite odjemalec.
Preglejte klice orodij. Potrjevanje klicev orodij v odjemalcu pustite vklopljeno, vsaj za klice, ki spreminjajo konfiguracijo.

Odpravljanje težav¶

401 Unauthorized¶

Odgovor pove razlog:

Sporočilo	Vzrok
`Missing or malformed Authorization header`	Glava ni bila poslana ali se vrednost ne začne z `Bearer`
`Invalid API key`	Ključ je napačen ali je bil izbrisan
`API key expired`	Ključ je potekel. Ustvarite novega

403 Forbidden: `The license does not include the agentic (MCP) feature`¶

Licenca digna nima vnosa digna Agentic ali pa je ta vnos potekel. Pri ekipi digna zaprosite za licenco, ki vključuje digna Agentic, in jo namestite, kot je opisano v namestitvenem vodiču za vaš operacijski sistem.

Vsaka zahteva ne uspe z napako neveljavne licence¶

Potekla je sama licenca digna. Strežnik MCP skupaj z nadzorno ploščo preneha odgovarjati, dokler ni nameščena nova licenca.

Agent lahko bere, ne more pa spreminjati konfiguracije¶

Uporabnik, ki mu pripada ključ API, v tem projektu nima vloge urejevalca. Uporabite ključ uporabnika z vlogo urejevalca ali prosite skrbnika projekta, da spremeni vlogo.

Odjemalec se sploh ne more povezati¶

Računalnik, ki se povezuje, ne doseže končne točke. Odprite naslov končne točke s tega računalnika ter preverite požarne zidove, posredniške strežnike in potrdilo. Pri konektorju po meri za Claude je ta računalnik v oblaku Anthropic, glejte Od kod prihaja povezava.