Ühenda Claude dignaga¶

See juhend ühendab Claude'i digna MCP Serveriga. Sul on vaja oma digna paigalduse MCP lõpp-punkti ja API võtit, nagu on kirjeldatud AI-agentide ülevaates.

Näidetes on lõpp-punktiks https://digna.example.com/mcp. Asenda see enda omaga.

Vali ühendamise viis¶

Kui digna paigaldus töötab sinu ettevõtte võrgu sees, kasuta Claude Code'i või Claude Desktopi kohaliku sillaga.

Claude Code¶

1. Lisa server¶

Pane API võti keskkonnamuutujasse ja lisa seejärel server:

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"

Sinu shell asendab käsu käivitamisel $DIGNA_API_KEY väärtusega, seega salvestab Claude Code võtme oma konfiguratsiooni.

--scope määrab, kus server on saadaval:

2. Jaga serverit oma meeskonnaga (valikuline)¶

Et anda kõigile projektis sama server, lisa projekti juurkausta .mcp.json fail. Ära kirjuta võtit faili. Claude Code täidab ${DIGNA_API_KEY} iga inimese enda keskkonnast:

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

Iga inimene määrab DIGNA_API_KEY väärtuseks oma võtme. Kui Claude Code faili esimest korda leiab, küsib see, kas selles olevaid servereid kasutada.

3. Kontrolli ühendust¶

Oma shellist:

claude mcp list

Server digna peab näitama ✔ Connected. Claude Code'i seansis käivita /mcp, et näha serverit ja selle tööriistu.

Claude Desktop kohaliku sillaga¶

Claude Desktopi konfiguratsioonifail käivitab sinu masinas kohalikke MCP-servereid. Väike sild, avatud lähtekoodiga pakett mcp-remote, töötab seal ja edastab iga päringu koos sinu API võtmega digna lõpp-punkti. Kuna sild töötab sinu masinas, toimib see dignaga sinu ettevõtte võrgu sees.

1. Paigalda Node.js¶

Sild vajab Node.js versiooni 18 või uuemat. Claude Desktop kasutab sinu süsteemi paigaldatud Node.js versiooni. Kontrolli seda käsuga:

node --version

2. Muuda konfiguratsioonifaili¶

Ava claude_desktop_config.json:

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

Lisa server digna. Kui failis on juba jaotis mcpServers, lisa kirje digna sinna:

{
  "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. Taaskäivita Claude Desktop¶

Sulge Claude Desktop täielikult ja käivita see uuesti. Klõpsa uues vestluses + ja ava Connectors: digna peab olema loendis ja sisse lülitatud.

Custom connector¶

Custom connector teeb digna kättesaadavaks claude.ai-s, Claude Desktopis ja Claude'i mobiilirakendustes ilma kohaliku seadistuseta. Lõpp-punktiga ühendub Anthropicu pilv, seega töötab see ainult siis, kui:

• digna lõpp-punkt on internetist HTTPS-i kaudu kättesaadav
• Sinu Claude'i organisatsioonil on dialoogis Add custom connector valik Request headers. Anthropic pakub seda beetana piiratud hulgale organisatsioonidele

1. Ava connectori seaded¶

• Free, Pro, Max ja Ultra paketid: mine Customize > Connectors ja klõpsa Add custom connector.
• Team ja Enterprise paketid: Owner läheb Organization settings > Connectors, klõpsab Add, seejärel Custom ja valib Web, kui tüüpi küsitakse.

2. Sisesta connectori andmed¶

1. MCP server URL: https://digna.example.com/mcp
2. Authentication: No sign-in
3. Request headers: vali päise nimeks authorization, sisesta väärtuseks Bearer <api key> koos sõnaga Bearer ja tühikuga ning märgi see Required.
4. Klõpsa Add.

Team ja Enterprise pakettide puhul ühenduvad liikmed seejärel jaotises Customize > Connectors, kus connectoril on silt Custom.

Claude ei saa olemasoleva connectori päist muuta. Uue võtme kasutamiseks eemalda connector ja lisa see uuesti.

Claude'i tõrkeotsing¶

claude mcp list näitab Failed to connect¶

Käivita claude mcp get digna, et näha põhjust. 401 tähendab, et võti lükati tagasi; vaata 401 Unauthorized. Claude Code hoiatab ka tühikute või reavahetuse eest võtme alguses või lõpus, mis tulevad sageli kopeerimisel kaasa.

digna ei ilmu Claude Desktopis¶

• Kontrolli, et Node.js 18 või uuem on paigaldatud: node --version.
• Kontrolli, et claude_desktop_config.json on kehtiv JSON. Puuduv koma takistab kõigi faili serverite laadimist.
• Sulge Claude Desktop täielikult, mitte ainult aken, ja käivita see uuesti.

Custom connector ei jõua serverini¶

Anthropicu pilv ei jõua lõpp-punktini. Kontrolli, et see on internetist HTTPS-i kaudu kehtiva sertifikaadiga kättesaadav, või ühenda selle asemel Claude Code'i kaudu.

Vaata ka¶

• AI-agentide ülevaade: lõpp-punkt, API võti, turvalisus ja üldine tõrkeotsing
• Gemini: ühenda Antigravity või Gemini CLI
• digna Agentic: mida AI-agendid saavad dignaga teha