Conectați Claude la digna¶

Acest ghid conectează Claude la digna MCP Server. Aveți nevoie de endpoint-ul MCP al instalării dvs. digna și de o cheie API, așa cum este descris în Prezentarea agenților AI.

Exemplele folosesc https://digna.example.com/mcp ca endpoint. Înlocuiți-l cu al dvs.

Alegeți modul de conectare¶

Pentru o instalare digna care rulează în rețeaua companiei dvs., folosiți Claude Code sau Claude Desktop cu o punte locală.

Claude Code¶

1. Adăugați serverul¶

Puneți cheia API într-o variabilă de mediu, apoi adăugați serverul:

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"

Shell-ul dvs. completează $DIGNA_API_KEY atunci când rulați comanda, astfel încât Claude Code stochează cheia în propria configurație.

--scope decide unde este disponibil serverul:

2. Partajați serverul cu echipa (opțional)¶

Pentru a oferi tuturor dintr-un proiect același server, adăugați un fișier .mcp.json în rădăcina proiectului. Nu scrieți cheia în fișier. Claude Code completează ${DIGNA_API_KEY} din mediul propriu al fiecărei persoane:

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

Fiecare persoană setează DIGNA_API_KEY la propria cheie. Prima dată când Claude Code găsește fișierul, întreabă dacă să folosească serverele din el.

3. Verificați conexiunea¶

Din shell:

claude mcp list

Serverul digna trebuie să afișeze ✔ Connected. Într-o sesiune Claude Code, rulați /mcp pentru a vedea serverul și instrumentele sale.

Claude Desktop cu o punte locală¶

Fișierul de configurare al Claude Desktop pornește servere MCP locale pe mașina dvs. O punte mică, pachetul open-source mcp-remote, rulează acolo și redirecționează fiecare cerere către endpoint-ul digna cu cheia dvs. API. Deoarece puntea rulează pe mașina dvs., această metodă funcționează cu digna în rețeaua companiei dvs.

1. Instalați Node.js¶

Puntea necesită Node.js 18 sau o versiune ulterioară. Claude Desktop folosește versiunea Node.js instalată pe sistemul dvs. Verificați-o cu:

node --version

2. Editați fișierul de configurare¶

Deschideți claude_desktop_config.json:

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

Adăugați serverul digna. Dacă fișierul are deja o secțiune mcpServers, adăugați intrarea digna în ea:

{
  "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. Reporniți Claude Desktop¶

Închideți complet Claude Desktop și porniți-l din nou. Într-un chat nou, faceți clic pe + și deschideți Connectors: digna trebuie să fie listat și activat.

Conector personalizat¶

Un conector personalizat (custom connector) face digna disponibil în claude.ai, Claude Desktop și aplicațiile mobile Claude fără nicio configurare locală. Cloud-ul Anthropic se conectează la endpoint, deci această metodă funcționează doar atunci când:

• Endpoint-ul digna este accesibil din internet prin HTTPS
• Organizația dvs. Claude are opțiunea Request headers în dialogul Add custom connector. Anthropic o oferă ca beta unui număr limitat de organizații

1. Deschideți setările conectorilor¶

• Planurile Free, Pro, Max și Ultra: accesați Customize > Connectors și faceți clic pe Add custom connector.
• Planurile Team și Enterprise: un Owner accesează Organization settings > Connectors, face clic pe Add, apoi pe Custom și alege Web dacă i se cere tipul.

2. Introduceți detaliile conectorului¶

1. MCP server URL: https://digna.example.com/mcp
2. Authentication: No sign-in
3. Request headers: alegeți authorization ca nume de header, introduceți Bearer <api key> ca valoare, inclusiv cuvântul Bearer și spațiul, și marcați-l Required.
4. Faceți clic pe Add.

În planurile Team și Enterprise, membrii se conectează apoi din Customize > Connectors, unde conectorul poartă eticheta Custom.

Claude nu poate modifica header-ul unui conector existent. Pentru a folosi o cheie nouă, eliminați conectorul și adăugați-l din nou.

Depanarea Claude¶

claude mcp list afișează Failed to connect¶

Rulați claude mcp get digna pentru a vedea motivul. Un 401 înseamnă că cheia a fost respinsă; consultați 401 Unauthorized. Claude Code avertizează și despre spații sau un sfârșit de linie la începutul sau sfârșitul cheii, care apar adesea la copierea ei.

digna nu apare în Claude Desktop¶

• Verificați că este instalat Node.js 18 sau o versiune ulterioară: node --version.
• Verificați că claude_desktop_config.json este JSON valid. O virgulă lipsă împiedică încărcarea tuturor serverelor din fișier.
• Închideți complet Claude Desktop, nu doar fereastra, și porniți-l din nou.

Conectorul personalizat nu poate ajunge la server¶

Cloud-ul Anthropic nu poate ajunge la endpoint. Verificați că acesta este accesibil din internet prin HTTPS cu un certificat valid sau conectați-vă în schimb prin Claude Code.

Vezi și¶

• Prezentarea agenților AI: endpoint, cheie API, securitate și depanare generală
• Gemini: conectați Antigravity sau Gemini CLI
• digna Agentic: ce pot face agenții AI cu digna