Pāriet uz saturu

Claude savienošana ar digna

Šajā rokasgrāmatā Claude tiek savienots ar digna MCP Server. Jums nepieciešams jūsu digna instalācijas MCP galapunkts un API atslēga, kā aprakstīts AI aģentu pārskatā.

Piemēros kā galapunkts izmantots https://digna.example.com/mcp. Aizstājiet to ar savu.

Savienojuma veida izvēle

Claude produkts Savienojas no Darbojas ar digna jūsu tīklā
Claude Code Jūsu datora Jā
Claude Desktop ar lokālu tiltu Jūsu datora Jā
Pielāgotais savienotājs claude.ai, Claude Desktop un Claude mobile Anthropic mākoņa Nē. Galapunktam jābūt sasniedzamam no interneta

digna instalācijai, kas darbojas jūsu uzņēmuma tīklā, izmantojiet Claude Code vai Claude Desktop ar lokālu tiltu.


Claude Code

1. Servera pievienošana

Ievietojiet API atslēgu vides mainīgajā un pēc tam pievienojiet serveri:

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"

Jūsu čaula (shell) aizpilda $DIGNA_API_KEY, kad izpildāt komandu, tāpēc Claude Code saglabā atslēgu savā konfigurācijā.

--scope nosaka, kur serveris ir pieejams:

Scope Pieejams
local (noklusējums) Jums, tikai pašreizējā projektā
user Jums, katrā projektā
project Ikvienam, kas strādā projektā, izmantojot .mcp.json failu projektā

2. Servera kopīgošana ar komandu (neobligāti)

Lai visiem projekta dalībniekiem būtu tas pats serveris, pievienojiet .mcp.json failu projekta saknes direktorijā. Neierakstiet atslēgu failā. Claude Code aizpilda ${DIGNA_API_KEY} no katras personas paša vides:

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

Katra persona iestata DIGNA_API_KEY uz savu atslēgu. Pirmo reizi atrodot failu, Claude Code jautā, vai izmantot tajā norādītos serverus.

3. Savienojuma pārbaude

No čaulas:

claude mcp list

Serverim digna jārāda ✔ Connected. Claude Code sesijā izpildiet /mcp, lai redzētu serveri un tā rīkus.


Claude Desktop ar lokālu tiltu

Claude Desktop konfigurācijas fails palaiž lokālus MCP serverus jūsu datorā. Neliels tilts — atvērtā koda pakotne mcp-remote — darbojas tur un pārsūta katru pieprasījumu uz digna galapunktu ar jūsu API atslēgu. Tā kā tilts darbojas jūsu datorā, šis risinājums darbojas ar digna jūsu uzņēmuma tīklā.

Kopienas pakotne

mcp-remote uztur tās atvērtā koda kopiena, nevis Anthropic vai digna. Pirms to izmantojat, pārbaudiet, vai jūsu organizācija to atļauj.

1. Node.js instalēšana

Tiltam nepieciešams Node.js 18 vai jaunāka versija. Claude Desktop izmanto jūsu sistēmā instalēto Node.js versiju. Pārbaudiet to ar:

node --version

2. Konfigurācijas faila rediģēšana

Atveriet claude_desktop_config.json:

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

Pievienojiet serveri digna. Ja failā jau ir sadaļa mcpServers, pievienojiet ierakstu digna tajā:

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

Saglabājiet galveni tieši tādu, kā parādīts

Rakstiet Authorization:${AUTH_HEADER} bez atstarpēm un ievietojiet Bearer <api key> sadaļā env. Claude Desktop operētājsistēmā Windows neaizsargā (escape) atstarpes args iekšienē, tāpēc atstarpe tur sabojā galveni.

3. Claude Desktop restartēšana

Pilnībā aizveriet Claude Desktop un palaidiet to vēlreiz. Jaunā tērzēšanā noklikšķiniet uz + un atveriet Connectors: digna jābūt sarakstā un ieslēgtam.


Pielāgotais savienotājs

Pielāgotais savienotājs padara digna pieejamu claude.ai, Claude Desktop un Claude mobilajās lietotnēs bez jebkādas lokālas iestatīšanas. Ar galapunktu savienojas Anthropic mākonis, tāpēc tas darbojas tikai tad, ja:

  • digna galapunkts ir sasniedzams no interneta, izmantojot HTTPS
  • Jūsu Claude organizācijai dialoglodziņā Add custom connector ir opcija Request headers. Anthropic to piedāvā kā beta versiju ierobežotam organizāciju lokam

Nav paredzēts digna jūsu tīklā

Claude MCP tuneļiem, kas sasniedz serverus privātā tīklā, MCP serverī nepieciešams OAuth. digna MCP Server autentificē ar API atslēgām, tāpēc tuneli izmantot nevar. Tā vietā izmantojiet Claude Code vai Claude Desktop ar lokālu tiltu.

1. Savienotāju iestatījumu atvēršana

  • Free, Pro, Max un Ultra plāni: dodieties uz Customize > Connectors un noklikšķiniet Add custom connector.
  • Team un Enterprise plāni: Owner dodas uz Organization settings > Connectors, noklikšķina Add, pēc tam Custom un, ja tiek jautāts par tipu, izvēlas Web.

2. Savienotāja datu ievadīšana

  1. MCP server URL: https://digna.example.com/mcp
  2. Authentication: No sign-in
  3. Request headers: kā galvenes nosaukumu izvēlieties authorization, kā vērtību ievadiet Bearer <api key>, ieskaitot vārdu Bearer un atstarpi, un atzīmējiet to kā Required.
  4. Noklikšķiniet Add.

Visi koplieto atslēgu

Katrs dalībnieks, kas izmanto savienotāju, strādā ar to pašu API atslēgu un līdz ar to ar to pašu digna lietotāju. Izveidojiet savienotājam atsevišķu digna lietotāju un piešķiriet tam tikai tos projektus un lomas, kas drīkst būt ikvienam, piem., reader lomu.

Team un Enterprise plānos dalībnieki pēc tam pievienojas sadaļā Customize > Connectors, kur savienotājam ir etiķete Custom.

Claude nevar mainīt esoša savienotāja galveni. Lai izmantotu jaunu atslēgu, noņemiet savienotāju un pievienojiet to vēlreiz.


Claude problēmu novēršana

claude mcp list rāda Failed to connect

Izpildiet claude mcp get digna, lai redzētu iemeslu. 401 nozīmē, ka atslēga tika noraidīta; skatiet 401 Unauthorized. Claude Code arī brīdina par atstarpēm vai rindas pārnesumu atslēgas sākumā vai beigās, kas bieži rodas, to kopējot.

digna neparādās Claude Desktop

  • Pārbaudiet, vai ir instalēts Node.js 18 vai jaunāka versija: node --version.
  • Pārbaudiet, vai claude_desktop_config.json ir derīgs JSON. Trūkstošs komats neļauj ielādēt nevienu failā norādīto serveri.
  • Pilnībā aizveriet Claude Desktop, ne tikai logu, un palaidiet to vēlreiz.

Pielāgotais savienotājs nevar sasniegt serveri

Anthropic mākonis nevar sasniegt galapunktu. Pārbaudiet, vai tas ir sasniedzams no interneta, izmantojot HTTPS ar derīgu sertifikātu, vai tā vietā savienojieties, izmantojot Claude Code.


Skatīt arī