Skoči na vsebino

Povežite Claude z digna

Ta vodič poveže Claude z digna MCP Server. Potrebujete končno točko MCP svoje namestitve digna in ključ API, kot je opisano v Pregledu agentov UI.

Primeri kot končno točko uporabljajo https://digna.example.com/mcp. Zamenjajte jo s svojo.

Izberite način povezave

Izdelek Claude Poveže se z Deluje z digna znotraj vašega omrežja
Claude Code Vaš računalnik Da
Claude Desktop z lokalnim mostom Vaš računalnik Da
Konektor po meri v claude.ai, Claude Desktop in Claude za mobilne naprave Oblak Anthropic Ne. Končna točka mora biti dosegljiva iz interneta

Za namestitev digna, ki teče znotraj omrežja vašega podjetja, uporabite Claude Code ali Claude Desktop z lokalnim mostom.


Claude Code

1. Dodajte strežnik

Ključ API shranite v spremenljivko okolja, nato dodajte strežnik:

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"

Lupina ob zagonu ukaza vstavi vrednost $DIGNA_API_KEY, zato Claude Code ključ shrani v svojo konfiguracijo.

--scope določa, kje je strežnik na voljo:

Obseg Na voljo
local (privzeto) Vam, samo v trenutnem projektu
user Vam, v vseh projektih
project Vsem, ki delajo v projektu, prek datoteke .mcp.json v projektu

2. Delite strežnik z ekipo (neobvezno)

Če želite vsem v projektu omogočiti isti strežnik, v korensko mapo projekta dodajte datoteko .mcp.json. Ključa ne zapišite v datoteko. Claude Code vrednost ${DIGNA_API_KEY} vstavi iz okolja vsake osebe:

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

Vsaka oseba nastavi DIGNA_API_KEY na svoj ključ. Ko Claude Code datoteko najde prvič, vpraša, ali naj uporabi strežnike v njej.

3. Preverite povezavo

V lupini:

claude mcp list

Strežnik digna mora prikazati ✔ Connected. Znotraj seje Claude Code zaženite /mcp, da vidite strežnik in njegova orodja.


Claude Desktop z lokalnim mostom

Konfiguracijska datoteka Claude Desktop zaganja lokalne strežnike MCP na vašem računalniku. Majhen most, odprtokodni paket mcp-remote, teče tam in vsako zahtevo z vašim ključem API posreduje končni točki digna. Ker most teče na vašem računalniku, ta način deluje tudi z digna znotraj omrežja vašega podjetja.

Paket skupnosti

mcp-remote vzdržuje njegova odprtokodna skupnost, ne Anthropic ali digna. Pred uporabo preverite, ali ga vaša organizacija dovoljuje.

1. Namestite Node.js

Most potrebuje Node.js 18 ali novejši. Claude Desktop uporablja različico Node.js, nameščeno v vašem sistemu. Preverite jo z:

node --version

2. Uredite konfiguracijsko datoteko

Odprite claude_desktop_config.json:

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

Dodajte strežnik digna. Če datoteka že ima razdelek mcpServers, vanj dodajte vnos digna:

{
  "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>"
      }
    }
  }
}

Glavo zapišite točno tako, kot je prikazano

Authorization:${AUTH_HEADER} zapišite brez presledkov, Bearer <api key> pa postavite v env. Claude Desktop v sistemu Windows presledkov v args ne ubeži, zato presledek tam pokvari glavo.

3. Znova zaženite Claude Desktop

Claude Desktop popolnoma zaprite in ga znova zaženite. V novem klepetu kliknite + in odprite Connectors: digna mora biti na seznamu in vklopljena.


Konektor po meri

Konektor po meri (custom connector) omogoči digna v claude.ai, Claude Desktop in mobilnih aplikacijah Claude brez kakršne koli lokalne nastavitve. S končno točko se poveže oblak Anthropic, zato ta način deluje le, če:

  • Je končna točka digna dosegljiva iz interneta prek HTTPS
  • Ima vaša organizacija Claude v pogovornem oknu Add custom connector možnost Request headers. Anthropic jo kot beta ponuja omejenemu številu organizacij

Ni za digna znotraj vašega omrežja

Claudovi tuneli MCP, ki dosežejo strežnike v zasebnem omrežju, zahtevajo OAuth na strežniku MCP. digna MCP Server se overja s ključi API, zato tunela ni mogoče uporabiti. Namesto tega uporabite Claude Code ali Claude Desktop z lokalnim mostom.

1. Odprite nastavitve konektorjev

  • Paketi Free, Pro, Max in Ultra: pojdite na Customize > Connectors in kliknite Add custom connector.
  • Paketa Team in Enterprise: Owner gre na Organization settings > Connectors, klikne Add, nato Custom in izbere Web, če je vprašan po vrsti.

2. Vnesite podatke konektorja

  1. MCP server URL: https://digna.example.com/mcp
  2. Authentication: No sign-in
  3. Request headers: za ime glave izberite authorization, kot vrednost vnesite Bearer <api key>, vključno z besedo Bearer in presledkom, ter jo označite kot Required.
  4. Kliknite Add.

Vsi si delijo ključ

Vsak član, ki uporablja konektor, dela z istim ključem API in torej z istim uporabnikom digna. Za konektor ustvarite namenskega uporabnika digna in mu dodelite le projekte in vloge, ki jih sme imeti vsakdo, npr. vlogo bralca.

V paketih Team in Enterprise se člani nato povežejo pod Customize > Connectors, kjer ima konektor oznako Custom.

Claude ne more spremeniti glave obstoječega konektorja. Če želite uporabiti nov ključ, konektor odstranite in ga znova dodajte.


Odpravljanje težav s Claude

claude mcp list prikaže Failed to connect

Zaženite claude mcp get digna, da vidite razlog. 401 pomeni, da je bil ključ zavrnjen; glejte 401 Unauthorized. Claude Code opozori tudi na presledke ali prelom vrstice na začetku ali koncu ključa, ki se pogosto pojavijo pri kopiranju.

digna se ne prikaže v Claude Desktop

  • Preverite, ali je nameščen Node.js 18 ali novejši: node --version.
  • Preverite, ali je claude_desktop_config.json veljaven JSON. Manjkajoča vejica prepreči nalaganje vseh strežnikov v datoteki.
  • Claude Desktop popolnoma zaprite, ne le okna, in ga znova zaženite.

Konektor po meri ne doseže strežnika

Oblak Anthropic ne doseže končne točke. Preverite, ali je dosegljiva iz interneta prek HTTPS z veljavnim potrdilom, ali pa se namesto tega povežite prek Claude Code.


Povezane vsebine

  • Pregled agentov UI: končna točka, ključ API, varnost in splošno odpravljanje težav
  • Gemini: povežite Antigravity ali Gemini CLI
  • digna Agentic: kaj lahko agenti UI počnejo z digna