Atlan

Atlan MCP Sunucusu

[!WARNING] Bu yerel MCP sunucusu kullanımdan kaldırılmıştır. Bunun yerine mcp.atlan.com/mcp adresindeki barındırılan Atlan MCP'yi kullanın.

Yerel kurulum yolu (Docker, uv veya pip install atlan-mcp-server) yalnızca bakım modundadır — yeni özellik yok, destek garanti edilmez. Barındırılan uç nokta, Atlan'ı Claude Desktop, Cursor, Codex, Databricks UC ve diğer MCP istemcileriyle entegre etmenin önerilen yoludur. Kurulum için Atlan MCP genel bakış sayfasına bakın.

Atlan Model Bağlam Protokolü sunucusu, yapay zeka ajanlarınızın Atlan hizmetleriyle etkileşime girmesini sağlar.

Hızlı Başlangıç

1. Belgelendirmeyi takip ederek Atlan API anahtarı oluşturun.
2. Tercihinize göre aşağıdaki yaklaşımlardan birini seçin:
   • Docker ile Kurulum - Docker konteynerlerini kullanır (önerilir)
   • uv ile Kurulum - UV paket yöneticisini kullanır

[!NOTE] Yapılandırma dosyasında <YOUR_API_KEY>, <YOUR_INSTANCE> ve <YOUR_AGENT_ID> yerine sırasıyla gerçek Atlan API anahtarınızı, örnek URL'nizi ve ajan kimliğinizi (isteğe bağlı) yazdığınızdan emin olun.

Docker ile Kurulum

Ön koşullar:

• İşletim sisteminiz için resmi Docker kurulum kılavuzunu takip edin
• Docker'ın çalıştığını doğrulayın:

  docker --version
  

Claude Desktop'a Ekleme

Claude > Settings > Developer > Edit Config > claude_desktop_config.json konumuna gidin ve şunu ekleyin:

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

Cursor'a Ekleme

Cursor > Settings > Tools & Integrations > New MCP Server dosyasını açın ve aşağıdakini ekleyin:

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

uv ile Kurulum

Ön koşullar:

• uv'yi kurun:

  # 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
  

• Kurulumu doğrulayın:

  uv --version
  

[!NOTE] uv ile uvx her çalıştırdığınızda otomatik olarak en son sürümü getirir. Daha öngörülebilir bir davranış için Docker seçeneğini kullanmayı düşünün.

Claude Desktop'a Ekleme

Claude > Settings > Developer > Edit Config > claude_desktop_config.json konumuna gidin ve aşağıdakini ekleyin:

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

Cursor'a Ekleme

Cursor > Settings > Tools & Integrations > New MCP Server dosyasını açın ve aşağıdakini ekleyin:

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

Kullanılabilir Araçlar

Araç	Açıklama
search_assets	Koşullara göre varlıkları arama
get_assets_by_dsl	DSL sorgusu kullanarak varlıkları alma
traverse_lineage	Bir varlık için soy ağacını alma
update_assets	Varlık özniteliklerini güncelleme (kullanıcı açıklaması ve sertifika durumu)
create_glossaries	Sözlükler oluşturma
create_glossary_categories	Sözlük kategorileri oluşturma
create_glossary_terms	Sözlük terimleri oluşturma
create_dq_rules	Tablo, Görünüm, MaterialisedView veya SnowflakeDynamicTable varlıklarında veri kalitesi kuralları oluşturma (sütun düzeyinde, tablo düzeyinde, özel SQL)
update_dq_rules	Mevcut veri kalitesi kurallarını güncelleme (eşik, öncelik, koşullar vb.)
schedule_dq_rules	Cron ifadeleri kullanarak varlıklar için veri kalitesi kuralı yürütmeyi zamanlama
delete_dq_rules	GUID ile bir veya birden fazla veri kalitesi kuralını silme
query_asset	Tablo/görünüm varlıkları üzerinde SQL sorguları yürütme

Araç Erişim Kontrolü

Atlan MCP Sunucusu, kullanıcıların hangi araçlara erişebileceğini kontrol etmenizi sağlayan yapılandırılabilir bir araç kısıtlama ara yazılımı içerir. Bu, rol tabanlı erişim kontrolü uygulamak veya belirli ortamlarda belirli işlemleri kısıtlamak için kullanışlıdır.

Araçları Kısıtlama

RESTRICTED_TOOLS ortam değişkenini kullanarak belirli araçlara erişimi kısıtlayabilirsiniz. Engellenmesi gereken araç adlarının virgülle ayrılmış bir listesini sağlayın:

Docker Yapılandırması

{
  "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 Yapılandırması

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

Kısıtlama için Kullanılabilir Araç Adları

Aşağıdaki araçlardan herhangi birini kısıtlayabilirsiniz:

• search_assets_tool - Varlık arama işlevselliği
• get_assets_by_dsl_tool - DSL sorgu yürütme
• traverse_lineage_tool - Soy ağacı gezinme
• update_assets_tool - Varlık güncellemeleri (açıklamalar, sertifikalar)
• create_glossaries - Sözlük oluşturma
• create_glossary_categories - Kategori oluşturma
• create_glossary_terms - Terim oluşturma
• create_dq_rules_tool - Veri kalitesi kuralı oluşturma
• update_dq_rules_tool - Veri kalitesi kuralı güncellemeleri
• schedule_dq_rules_tool - Veri kalitesi kuralı zamanlama
• delete_dq_rules_tool - Veri kalitesi kuralı silme

Yaygın Kullanım Durumları

Salt Okunur Erişim

Tüm yazma işlemlerini kısıtlayın:

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 Sorgularını Devre Dışı Bırakma

Güvenlik veya performans nedenleriyle:

RESTRICTED_TOOLS=get_assets_by_dsl_tool

Minimum Erişim

Yalnızca temel aramaya izin verin:

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

Nasıl Çalışır

Araçlar kısıtlandığında:

1. Listelerden gizlenir: Kısıtlanan araçlar, istemciler kullanılabilir araçları talep ettiğinde görünmez
2. Yürütme engellenir: Birisi kısıtlanmış bir aracı çalıştırmaya çalışırsa, net bir hata mesajı alır
3. Günlüğe kaydedilir: Tüm erişim kararları izleme ve hata ayıklama için günlüğe kaydedilir

Kısıtlama Yok (Varsayılan)

RESTRICTED_TOOLS ortam değişkenini ayarlamazsanız, varsayılan olarak tüm araçlar kullanılabilir olacaktır.

Aktarım Modları

Atlan MCP Sunucusu, her biri farklı dağıtım senaryoları için optimize edilmiş üç aktarım modunu destekler. MCP aktarım modları hakkında daha fazla ayrıntı için resmi MCP belgelendirmesine bakın.

Aktarım Modu	Kullanım Durumu	Faydaları	Ne Zaman Kullanılmalı
stdio (Varsayılan)	Yerel geliştirme, IDE entegrasyonları	Basit, doğrudan iletişim	Claude Desktop, Cursor IDE
SSE (Sunucu Tarafından Gönderilen Olaylar)	Uzak dağıtımlar, web tarayıcıları	Gerçek zamanlı akış, web uyumlu	Bulut dağıtımları, web istemcileri
streamable-http	HTTP tabanlı uzak bağlantılar	Standart HTTP, yük dengeleyici dostu	Kubernetes, konteynerli dağıtımlar

Kapsamlı dağıtım talimatları, yapılandırma örnekleri ve üretim en iyi uygulamaları için Dağıtım Kılavuzumuza bakın.

Üretim Dağıtımı

• Atlan MCP konteyner imajını tercih ettiğiniz bulut/platformda barındırın
• Gerekli tüm ortam değişkenlerini eklediğinizden emin olun
• Dağıtım senaryonuza uygun aktarım modunu seçin. Üretim için SSE Aktarımı önerilir (-e MCP_TRANSPORT=sse)
• Ayrıntılı dağıtım senaryoları ve yapılandırmalar için Dağıtım Kılavuzuna başvurun

Uzak MCP Yapılandırması

Şu anda Atlan için genel kullanıma açık bir uzak MCP sunucumuz bulunmamaktadır.

Uzak MCP sunucunuza bağlamak için mcp-remote yerel proxy aracını kullanabilirsiniz.

Bu, gerçek dünya MCP istemcisiyle uzak MCP sunucunuzla etkileşimin nasıl olacağını test etmenizi sağlar.

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

Yerel Olarak Geliştirme

Yerel olarak geliştirmek mi istiyorsunuz? Adım adım izlenecek yol için Yerel Derleme Kılavuzumuza göz atın!

Yardıma mı İhtiyacınız Var?

• Herhangi bir soru veya geri bildirim için support@atlan.com adresine ulaşın
• Ayrıca doğrudan bir GitHub sorunu oluşturabilirsiniz, size yanıt vereceğiz

Sıkça Sorulan Sorular

Python'un yüklü olması gerekiyor mu?

Kısa cevap: Kurulum yönteminize bağlıdır.

• Docker (Önerilir): Ana makinenizde Python kurulumu gerekmez. Konteyner ihtiyaç duyulan her şeyi içerir.
• uv: Bir Python çalışma zamanı gereklidir, ancak uv zaten mevcut değilse Python 3.11+'ı sizin için otomatik olarak indirip yönetecektir.

Teknik ayrıntılar: Atlan MCP sunucusu bir Python uygulaması olarak uygulanmıştır. Model Bağlam Protokolü'nün kendisi dilden bağımsızdır, ancak mevcut uygulamamızın çalışması için Python 3.11+ gereklidir.

Sorun Giderme

1. Claude Desktop spawn uv ENOENT {"context":"connection","stack":"Error: spawn uv ENOENT\n at ChildProcess._handle.onexit benzeri bir hata gösteriyorsa, büyük olasılıkla Claude'un uv'yi bulamadığı şu sorundur. Düzeltmek için:
   • uv'nin kurulu olduğundan ve PATH'inizde mevcut olduğundan emin olun
   • Kurulum yolunu doğrulamak için which uv komutunu çalıştırın
   • whereis uv komutunu çalıştırarak Claude'un yapılandırmasını tam uv yolunu gösterecek şekilde güncelleyin ve bu yolu kullanın