Atlan

Server MCP Atlan

[!WARNING] Server MCP lokal ini sudah tidak digunakan lagi. Gunakan Atlan MCP yang dihosting di mcp.atlan.com/mcp sebagai gantinya.

Jalur instalasi lokal (Docker, uv, atau pip install atlan-mcp-server) hanya dalam mode pemeliharaan — tidak ada fitur baru, dukungan tidak dijamin. Endpoint yang dihosting adalah cara yang direkomendasikan untuk mengintegrasikan Atlan dengan Claude Desktop, Cursor, Codex, Databricks UC, dan klien MCP lainnya. Lihat ringkasan Atlan MCP untuk penyiapan.

Server Model Context Protocol Atlan memungkinkan agen AI Anda berinteraksi dengan layanan Atlan.

Mulai Cepat

1. Buat kunci API Atlan dengan mengikuti dokumentasi.
2. Pilih salah satu pendekatan berikut berdasarkan preferensi Anda:
   • Instal melalui Docker - Menggunakan kontainer Docker (direkomendasikan)
   • Instal melalui uv - Menggunakan manajer paket UV

[!NOTE] Pastikan untuk mengganti <YOUR_API_KEY>, <YOUR_INSTANCE>, dan <YOUR_AGENT_ID> masing-masing dengan kunci API Atlan, URL instans, dan ID agen (opsional) Anda yang sebenarnya di berkas konfigurasi.

Instal melalui Docker

Prasyarat:

• Ikuti panduan instalasi Docker resmi untuk sistem operasi Anda
• Verifikasi bahwa Docker berjalan:

  docker --version
  

Tambahkan ke Claude Desktop

Buka Claude > Settings > Developer > Edit Config > claude_desktop_config.json dan tambahkan:

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

Tambahkan ke Cursor

Buka Cursor > Settings > Tools & Integrations > New MCP Server untuk menyertakan yang berikut:

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

Instal melalui uv

Prasyarat:

• Instal 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
  

• Verifikasi instalasi:

  uv --version
  

[!NOTE] Dengan uv, uvx secara otomatis mengambil versi terbaru setiap kali Anda menjalankannya. Untuk perilaku yang lebih dapat diprediksi, pertimbangkan untuk menggunakan opsi Docker.

Tambahkan ke Claude Desktop

Buka Claude > Settings > Developer > Edit Config > claude_desktop_config.json untuk menyertakan yang berikut:

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

Tambahkan ke Cursor

Buka Cursor > Settings > Tools & Integrations > New MCP Server untuk menyertakan yang berikut:

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

Alat yang Tersedia

Alat	Deskripsi
search_assets	Mencari aset berdasarkan kondisi
get_assets_by_dsl	Mengambil aset menggunakan kueri DSL
traverse_lineage	Mengambil lineage untuk suatu aset
update_assets	Memperbarui atribut aset (deskripsi pengguna dan status sertifikat)
create_glossaries	Membuat glosarium
create_glossary_categories	Membuat kategori glosarium
create_glossary_terms	Membuat istilah glosarium
create_dq_rules	Membuat aturan kualitas data pada aset Table, View, MaterialisedView, atau SnowflakeDynamicTable (tingkat kolom, tingkat tabel, SQL kustom)
update_dq_rules	Memperbarui aturan kualitas data yang ada (ambang batas, prioritas, kondisi, dll.)
schedule_dq_rules	Menjadwalkan eksekusi aturan kualitas data untuk aset menggunakan ekspresi cron
delete_dq_rules	Menghapus satu atau beberapa aturan kualitas data berdasarkan GUID
query_asset	Mengeksekusi kueri SQL pada aset tabel/view

Kontrol Akses Alat

Server MCP Atlan menyertakan middleware pembatasan alat yang dapat dikonfigurasi yang memungkinkan Anda mengontrol alat mana yang tersedia bagi pengguna. Ini berguna untuk menerapkan kontrol akses berbasis peran atau membatasi operasi tertentu di lingkungan tertentu.

Membatasi Alat

Anda dapat membatasi akses ke alat tertentu menggunakan variabel lingkungan RESTRICTED_TOOLS. Berikan daftar nama alat yang dipisahkan koma yang harus diblokir:

Konfigurasi Docker

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

Konfigurasi uv

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

Nama Alat yang Tersedia untuk Pembatasan

Anda dapat membatasi salah satu alat berikut:

• search_assets_tool - Fungsionalitas pencarian aset
• get_assets_by_dsl_tool - Eksekusi kueri DSL
• traverse_lineage_tool - Penelusuran lineage
• update_assets_tool - Pembaruan aset (deskripsi, sertifikat)
• create_glossaries - Pembuatan glosarium
• create_glossary_categories - Pembuatan kategori
• create_glossary_terms - Pembuatan istilah
• create_dq_rules_tool - Pembuatan aturan kualitas data
• update_dq_rules_tool - Pembaruan aturan kualitas data
• schedule_dq_rules_tool - Penjadwalan aturan kualitas data
• delete_dq_rules_tool - Penghapusan aturan kualitas data

Kasus Penggunaan Umum

Akses Hanya-Baca

Batasi semua operasi tulis:

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

Nonaktifkan Kueri DSL

Untuk alasan keamanan atau kinerja:

RESTRICTED_TOOLS=get_assets_by_dsl_tool

Akses Minimal

Hanya izinkan pencarian dasar:

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

Cara Kerjanya

Saat alat dibatasi:

1. Tersembunyi dari daftar: Alat yang dibatasi tidak akan muncul saat klien meminta alat yang tersedia
2. Eksekusi diblokir: Jika seseorang mencoba mengeksekusi alat yang dibatasi, mereka akan menerima pesan kesalahan yang jelas
3. Tercatat: Semua keputusan akses dicatat untuk pemantauan dan debugging

Tanpa Pembatasan (Default)

Jika Anda tidak mengatur variabel lingkungan RESTRICTED_TOOLS, semua alat akan tersedia secara default.

Mode Transport

Server MCP Atlan mendukung tiga mode transport, masing-masing dioptimalkan untuk skenario penerapan yang berbeda. Untuk detail lebih lanjut tentang mode transport MCP, lihat dokumentasi MCP resmi.

Mode Transport	Kasus Penggunaan	Manfaat	Kapan Digunakan
stdio (Default)	Pengembangan lokal, integrasi IDE	Komunikasi langsung dan sederhana	Claude Desktop, Cursor IDE
SSE (Server-Sent Events)	Penerapan jarak jauh, peramban web	Streaming waktu nyata, kompatibel dengan web	Penerapan cloud, klien web
streamable-http	Koneksi jarak jauh berbasis HTTP	HTTP standar, ramah load balancer	Kubernetes, penerapan terkontainerisasi

Untuk instruksi penerapan yang komprehensif, contoh konfigurasi, dan praktik terbaik produksi, lihat Panduan Penerapan kami.

Penerapan Produksi

• Hosting citra kontainer Atlan MCP di cloud/platform pilihan Anda
• Pastikan Anda menambahkan semua variabel lingkungan yang diperlukan
• Pilih mode transport yang sesuai untuk skenario penerapan Anda. Transport SSE direkomendasikan untuk produksi (-e MCP_TRANSPORT=sse)
• Untuk skenario dan konfigurasi penerapan yang detail, lihat Panduan Penerapan

Konfigurasi MCP Jarak Jauh

Saat ini kami belum memiliki server MCP jarak jauh untuk Atlan yang tersedia secara umum.

Anda dapat menggunakan alat proksi lokal mcp-remote untuk menghubungkannya ke server MCP jarak jauh Anda.

Ini memungkinkan Anda untuk menguji seperti apa interaksi dengan server MCP jarak jauh Anda dengan klien MCP dunia nyata.

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

Kembangkan Secara Lokal

Ingin mengembangkan secara lokal? Lihat Panduan Build Lokal kami untuk panduan langkah demi langkah!

Butuh Bantuan?

• Hubungi support@atlan.com untuk pertanyaan atau umpan balik apa pun
• Anda juga dapat langsung membuat isu GitHub dan kami akan menjawabnya untuk Anda

Pertanyaan yang Sering Diajukan

Apakah saya perlu menginstal Python?

Jawaban singkat: Tergantung pada metode instalasi Anda.

• Docker (Direkomendasikan): Tidak diperlukan instalasi Python di mesin host Anda. Kontainer sudah mencakup semua yang dibutuhkan.
• uv: Runtime Python diperlukan, tetapi uv akan secara otomatis mengunduh dan mengelola Python 3.11+ untuk Anda jika belum tersedia.

Detail teknis: Server MCP Atlan diimplementasikan sebagai aplikasi Python. Model Context Protocol itu sendiri bersifat agnostik bahasa, tetapi implementasi kami saat ini memerlukan Python 3.11+ untuk berjalan.

Pemecahan Masalah

1. Jika Claude Desktop menampilkan kesalahan yang mirip dengan spawn uv ENOENT {"context":"connection","stack":"Error: spawn uv ENOENT\n at ChildProcess._handle.onexit, kemungkinan besar itu adalah masalah ini di mana Claude tidak dapat menemukan uv. Untuk memperbaikinya:
   • Pastikan uv terinstal dan tersedia di PATH Anda
   • Jalankan which uv untuk memverifikasi jalur instalasi
   • Perbarui konfigurasi Claude untuk menunjuk ke jalur uv yang tepat dengan menjalankan whereis uv dan gunakan jalur tersebut