Atlan

Atlan MCP Server

[!WARNING] Dieser lokale MCP-Server ist veraltet. Verwenden Sie stattdessen das gehostete Atlan MCP unter mcp.atlan.com/mcp.

Der lokale Installationspfad (Docker, uv oder pip install atlan-mcp-server) befindet sich im reinen Wartungsmodus – keine neuen Funktionen, Support nicht garantiert. Der gehostete Endpunkt ist der empfohlene Weg, um Atlan mit Claude Desktop, Cursor, Codex, Databricks UC und anderen MCP-Clients zu integrieren. Siehe die Atlan MCP-Übersicht für die Einrichtung.

Der Atlan Model Context Protocol-Server ermöglicht Ihren KI-Agenten die Interaktion mit Atlan-Diensten.

Schnellstart

1. Generieren Sie einen Atlan-API-Schlüssel, indem Sie der Dokumentation folgen.
2. Wählen Sie einen der folgenden Ansätze je nach Präferenz:
   • Installation via Docker – Verwendet Docker-Container (empfohlen)
   • Installation via uv – Verwendet den UV-Paketmanager

[!NOTE] Stellen Sie sicher, dass Sie <YOUR_API_KEY>, <YOUR_INSTANCE> und <YOUR_AGENT_ID> in der Konfigurationsdatei durch Ihren tatsächlichen Atlan-API-Schlüssel, Ihre Instanz-URL und Ihre Agent-ID (optional) ersetzen.

Installation via Docker

Voraussetzungen:

• Befolgen Sie die offizielle Docker-Installationsanleitung für Ihr Betriebssystem
• Überprüfen Sie, ob Docker läuft:

  docker --version
  

Zu Claude Desktop hinzufügen

Gehen Sie zu Claude > Settings > Developer > Edit Config > claude_desktop_config.json und fügen Sie hinzu:

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

Zu Cursor hinzufügen

Öffnen Sie Cursor > Settings > Tools & Integrations > New MCP Server, um Folgendes einzufügen:

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

Installation via uv

Voraussetzungen:

• Installieren Sie uv:

  # macOS/Linux
  curl -LsSf https://astral.sh/uv/install.sh | sh
  
  # Windows (PowerShell)
  powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  
  # Alternative: if you already have Python/pip
  pip install uv
  

• Installation überprüfen:

  uv --version
  

[!NOTE] Mit uv ruft uvx bei jeder Ausführung automatisch die neueste Version ab. Für ein vorhersagbareres Verhalten sollten Sie die Docker-Option in Betracht ziehen.

Zu Claude Desktop hinzufügen

Gehen Sie zu Claude > Settings > Developer > Edit Config > claude_desktop_config.json, um Folgendes einzufügen:

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>"
      }
    }
  }
}

Zu Cursor hinzufügen

Öffnen Sie Cursor > Settings > Tools & Integrations > New MCP Server, um Folgendes einzufügen:

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>"
      }
    }
  }
}

Verfügbare Werkzeuge

Werkzeug	Beschreibung
search_assets	Assets basierend auf Bedingungen suchen
get_assets_by_dsl	Assets mit einer DSL-Abfrage abrufen
traverse_lineage	Herkunft (Lineage) für ein Asset abrufen
update_assets	Asset-Attribute aktualisieren (Benutzerbeschreibung und Zertifikatsstatus)
create_glossaries	Glossare erstellen
create_glossary_categories	Glossar-Kategorien erstellen
create_glossary_terms	Glossar-Begriffe erstellen
create_dq_rules	Datenqualitätsregeln für Table-, View-, MaterialisedView- oder SnowflakeDynamicTable-Assets erstellen (Spaltenebene, Tabellenebene, benutzerdefiniertes SQL)
update_dq_rules	Bestehende Datenqualitätsregeln aktualisieren (Schwellenwert, Priorität, Bedingungen usw.)
schedule_dq_rules	Ausführung von Datenqualitätsregeln für Assets mit Cron-Ausdrücken planen
delete_dq_rules	Eine oder mehrere Datenqualitätsregeln anhand der GUID löschen
query_asset	SQL-Abfragen auf Tabellen-/View-Assets ausführen

Werkzeug-Zugriffskontrolle

Der Atlan MCP-Server enthält eine konfigurierbare Middleware zur Werkzeugeinschränkung, mit der Sie steuern können, welche Werkzeuge für Benutzer verfügbar sind. Dies ist nützlich für die Implementierung rollenbasierter Zugriffskontrolle oder die Einschränkung bestimmter Operationen in bestimmten Umgebungen.

Werkzeuge einschränken

Sie können den Zugriff auf bestimmte Werkzeuge mit der Umgebungsvariable RESTRICTED_TOOLS einschränken. Geben Sie eine durch Kommas getrennte Liste der zu blockierenden Werkzeugnamen an:

Docker-Konfiguration

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "-e",
        "RESTRICTED_TOOLS=get_assets_by_dsl_tool,update_assets_tool",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

uv-Konfiguration

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>",
        "RESTRICTED_TOOLS": "get_assets_by_dsl_tool,update_assets_tool"
      }
    }
  }
}

Verfügbare Werkzeugnamen für die Einschränkung

Sie können jedes der folgenden Werkzeuge einschränken:

• search_assets_tool - Asset-Suchfunktion
• get_assets_by_dsl_tool - DSL-Abfrageausführung
• traverse_lineage_tool - Herkunfts-Traversierung
• update_assets_tool - Asset-Aktualisierungen (Beschreibungen, Zertifikate)
• create_glossaries - Glossar-Erstellung
• create_glossary_categories - Kategorie-Erstellung
• create_glossary_terms - Begriffs-Erstellung
• create_dq_rules_tool - Erstellung von Datenqualitätsregeln
• update_dq_rules_tool - Aktualisierung von Datenqualitätsregeln
• schedule_dq_rules_tool - Planung von Datenqualitätsregeln
• delete_dq_rules_tool - Löschung von Datenqualitätsregeln

Häufige Anwendungsfälle

Nur-Lese-Zugriff

Alle Schreiboperationen einschränken:

RESTRICTED_TOOLS=update_assets_tool,create_glossaries,create_glossary_categories,create_glossary_terms,create_dq_rules_tool,update_dq_rules_tool,schedule_dq_rules_tool,delete_dq_rules_tool

DSL-Abfragen deaktivieren

Aus Sicherheits- oder Leistungsgründen:

RESTRICTED_TOOLS=get_assets_by_dsl_tool

Minimaler Zugriff

Nur grundlegende Suche erlauben:

RESTRICTED_TOOLS=get_assets_by_dsl_tool,update_assets_tool,traverse_lineage_tool,create_glossaries,create_glossary_categories,create_glossary_terms,create_dq_rules_tool,update_dq_rules_tool,schedule_dq_rules_tool,delete_dq_rules_tool

Funktionsweise

Wenn Werkzeuge eingeschränkt sind:

1. In Auflistungen ausgeblendet: Eingeschränkte Werkzeuge erscheinen nicht, wenn Clients verfügbare Werkzeuge anfordern
2. Ausführung blockiert: Wenn jemand versucht, ein eingeschränktes Werkzeug auszuführen, erhält er eine klare Fehlermeldung
3. Protokolliert: Alle Zugriffsentscheidungen werden zur Überwachung und Fehlerbehebung protokolliert

Keine Einschränkungen (Standard)

Wenn Sie die Umgebungsvariable RESTRICTED_TOOLS nicht setzen, sind standardmäßig alle Werkzeuge verfügbar.

Transportmodi

Der Atlan MCP-Server unterstützt drei Transportmodi, die jeweils für unterschiedliche Bereitstellungsszenarien optimiert sind. Weitere Details zu MCP-Transportmodi finden Sie in der offiziellen MCP-Dokumentation.

Transportmodus	Anwendungsfall	Vorteile	Wann zu verwenden
stdio (Standard)	Lokale Entwicklung, IDE-Integrationen	Einfache, direkte Kommunikation	Claude Desktop, Cursor IDE
SSE (Server-Sent Events)	Remote-Bereitstellungen, Webbrowser	Echtzeit-Streaming, webkompatibel	Cloud-Bereitstellungen, Web-Clients
streamable-http	HTTP-basierte Remote-Verbindungen	Standard-HTTP, Load-Balancer-freundlich	Kubernetes, containerisierte Bereitstellungen

Umfassende Bereitstellungsanweisungen, Konfigurationsbeispiele und Best Practices für die Produktion finden Sie in unserem Bereitstellungsleitfaden.

Produktionsbereitstellung

• Hosten Sie das Atlan MCP-Container-Image in der Cloud/Plattform Ihrer Wahl
• Stellen Sie sicher, dass Sie alle erforderlichen Umgebungsvariablen hinzufügen
• Wählen Sie den passenden Transportmodus für Ihr Bereitstellungsszenario. SSE-Transport wird für die Produktion empfohlen (-e MCP_TRANSPORT=sse)
• Detaillierte Bereitstellungsszenarien und Konfigurationen finden Sie im Bereitstellungsleitfaden

Remote-MCP-Konfiguration

Wir haben derzeit keinen allgemein verfügbaren Remote-MCP-Server für Atlan.

Sie können das lokale Proxy-Tool mcp-remote verwenden, um es mit Ihrem Remote-MCP-Server zu verbinden.

So können Sie testen, wie eine Interaktion mit Ihrem Remote-MCP-Server mit einem realen MCP-Client aussehen wird.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": ["mcp-remote", "https://hosted-domain"]
    }
  }
}

Lokal entwickeln

Möchten Sie lokal entwickeln? Sehen Sie sich unseren Local Build-Leitfaden für eine Schritt-für-Schritt-Anleitung an!

Benötigen Sie Hilfe?

• Wenden Sie sich bei Fragen oder Feedback an support@atlan.com
• Sie können auch direkt ein GitHub-Issue erstellen, und wir werden es für Sie beantworten

Häufig gestellte Fragen

Benötige ich eine Python-Installation?

Kurze Antwort: Es hängt von Ihrer Installationsmethode ab.

• Docker (empfohlen): Keine Python-Installation auf Ihrem Host-Rechner erforderlich. Der Container enthält alles Notwendige.
• uv: Eine Python-Laufzeitumgebung wird benötigt, aber uv lädt und verwaltet Python 3.11+ automatisch für Sie, falls es noch nicht verfügbar ist.

Technische Details: Der Atlan MCP-Server ist als Python-Anwendung implementiert. Das Model Context Protocol selbst ist sprachunabhängig, aber unsere aktuelle Implementierung benötigt Python 3.11+ zur Ausführung.

Fehlerbehebung

1. Wenn Claude Desktop einen Fehler ähnlich wie spawn uv ENOENT {"context":"connection","stack":"Error: spawn uv ENOENT\n at ChildProcess._handle.onexit anzeigt, handelt es sich höchstwahrscheinlich um dieses Problem, bei dem Claude uv nicht finden kann. So beheben Sie es:
   • Stellen Sie sicher, dass uv installiert und in Ihrem PATH verfügbar ist
   • Führen Sie which uv aus, um den Installationspfad zu überprüfen
   • Aktualisieren Sie die Konfiguration von Claude, um auf den genauen uv-Pfad zu verweisen, indem Sie whereis uv ausführen und diesen Pfad verwenden