Claude mit digna verbinden¶

Diese Anleitung verbindet Claude mit dem digna MCP Server. Sie benötigen den MCP-Endpunkt Ihrer digna-Installation und einen API-Schlüssel, wie in der Übersicht KI-Agenten beschrieben.

Die Beispiele verwenden https://digna.example.com/mcp als Endpunkt. Ersetzen Sie ihn durch Ihren.

Verbindungsart wählen¶

Für eine digna-Installation in Ihrem Firmennetzwerk verwenden Sie Claude Code oder Claude Desktop mit einer lokalen Bridge.

Claude Code¶

1. Den Server hinzufügen¶

Legen Sie den API-Schlüssel in einer Umgebungsvariablen ab und fügen Sie dann den Server hinzu:

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"

Ihre Shell setzt $DIGNA_API_KEY beim Ausführen des Befehls ein, sodass Claude Code den Schlüssel in seiner eigenen Konfiguration speichert.

--scope legt fest, wo der Server verfügbar ist:

2. Den Server mit Ihrem Team teilen (optional)¶

Damit alle in einem Projekt denselben Server erhalten, legen Sie eine .mcp.json-Datei im Projektstammverzeichnis an. Schreiben Sie den Schlüssel nicht in die Datei. Claude Code setzt ${DIGNA_API_KEY} aus der Umgebung der jeweiligen Person ein:

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

Jede Person setzt DIGNA_API_KEY auf ihren eigenen Schlüssel. Wenn Claude Code die Datei zum ersten Mal findet, fragt es, ob die darin enthaltenen Server verwendet werden sollen.

3. Die Verbindung prüfen¶

In Ihrer Shell:

claude mcp list

Der Server digna muss ✔ Connected anzeigen. Innerhalb einer Claude-Code-Sitzung führen Sie /mcp aus, um den Server und seine Tools zu sehen.

Claude Desktop mit einer lokalen Bridge¶

Die Konfigurationsdatei von Claude Desktop startet lokale MCP-Server auf Ihrem Rechner. Eine kleine Bridge, das Open-Source-Paket mcp-remote, läuft dort und leitet jede Anfrage mit Ihrem API-Schlüssel an den digna-Endpunkt weiter. Da die Bridge auf Ihrem Rechner läuft, funktioniert das auch mit digna in Ihrem Firmennetzwerk.

1. Node.js installieren¶

Die Bridge benötigt Node.js 18 oder neuer. Claude Desktop verwendet die auf Ihrem System installierte Node.js-Version. Prüfen Sie sie mit:

node --version

2. Die Konfigurationsdatei bearbeiten¶

Öffnen Sie claude_desktop_config.json:

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

Fügen Sie den Server digna hinzu. Enthält die Datei bereits einen Abschnitt mcpServers, ergänzen Sie dort den Eintrag 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>"
      }
    }
  }
}

3. Claude Desktop neu starten¶

Beenden Sie Claude Desktop vollständig und starten Sie es erneut. Klicken Sie in einem neuen Chat auf + und öffnen Sie Connectors: digna muss dort aufgeführt und eingeschaltet sein.

Benutzerdefinierter Konnektor¶

Ein benutzerdefinierter Konnektor macht digna in claude.ai, Claude Desktop und den mobilen Claude-Apps ohne lokale Einrichtung verfügbar. Die Cloud von Anthropic verbindet sich mit dem Endpunkt, daher funktioniert das nur, wenn:

• Der digna-Endpunkt über HTTPS aus dem Internet erreichbar ist
• Ihre Claude-Organisation die Option Request headers im Dialog Add custom connector hat. Anthropic bietet sie als Beta für eine begrenzte Zahl von Organisationen an

1. Die Konnektor-Einstellungen öffnen¶

• Free-, Pro-, Max- und Ultra-Pläne: Gehen Sie zu Customize > Connectors und klicken Sie auf Add custom connector.
• Team- und Enterprise-Pläne: Ein Owner geht zu Organization settings > Connectors, klickt auf Add, dann auf Custom, und wählt Web, wenn nach dem Typ gefragt wird.

2. Die Konnektor-Details eingeben¶

1. MCP server URL: https://digna.example.com/mcp
2. Authentication: No sign-in
3. Request headers: Wählen Sie authorization als Header-Namen, geben Sie Bearer <api key> als Wert ein, einschließlich des Worts Bearer und des Leerzeichens, und markieren Sie ihn als Required.
4. Klicken Sie auf Add.

In Team- und Enterprise-Plänen verbinden sich die Mitglieder anschließend unter Customize > Connectors, wo der Konnektor das Label Custom trägt.

Claude kann den Header eines bestehenden Konnektors nicht ändern. Um einen neuen Schlüssel zu verwenden, entfernen Sie den Konnektor und fügen Sie ihn erneut hinzu.

Fehlerbehebung für Claude¶

claude mcp list zeigt Failed to connect¶

Führen Sie claude mcp get digna aus, um den Grund zu sehen. Ein 401 bedeutet, dass der Schlüssel abgelehnt wurde; siehe 401 Unauthorized. Claude Code warnt außerdem vor Leerzeichen oder einem Zeilenumbruch am Anfang oder Ende des Schlüssels, die oft beim Kopieren mitkommen.

digna erscheint nicht in Claude Desktop¶

• Prüfen Sie, ob Node.js 18 oder neuer installiert ist: node --version.
• Prüfen Sie, ob claude_desktop_config.json gültiges JSON ist. Ein fehlendes Komma verhindert, dass irgendein Server aus der Datei geladen wird.
• Beenden Sie Claude Desktop vollständig, nicht nur das Fenster, und starten Sie es erneut.

Der benutzerdefinierte Konnektor erreicht den Server nicht¶

Die Cloud von Anthropic erreicht den Endpunkt nicht. Prüfen Sie, ob er über HTTPS mit einem gültigen Zertifikat aus dem Internet erreichbar ist, oder verbinden Sie sich stattdessen über Claude Code.

Siehe auch¶

• Übersicht KI-Agenten: Endpunkt, API-Schlüssel, Sicherheit und allgemeine Fehlerbehebung
• Gemini: Antigravity oder Gemini CLI verbinden
• digna Agentic: was KI-Agenten mit digna tun können