Keboola

Keboola MCP Server

Hubungkan agen AI Anda, klien MCP (Cursor, Claude, Windsurf, VS Code ...) dan asisten AI lainnya ke Keboola. Ekspos data, transformasi, kueri SQL, dan pemicu pekerjaan—tanpa perlu kode perekat. Kirim data yang tepat ke agen saat dan di mana mereka membutuhkannya.

Ringkasan

Keboola MCP Server adalah jembatan sumber terbuka antara proyek Keboola Anda dan alat AI modern. Ini mengubah fitur Keboola—seperti akses penyimpanan, transformasi SQL, dan pemicu pekerjaan—menjadi alat yang dapat dipanggil untuk Claude, Cursor, CrewAI, LangChain, Amazon Q, dan lainnya.

• Memulai Cepat
• Pengaturan Lokal

Fitur

Dengan AI Agent dan MCP Server, Anda dapat:

• Penyimpanan: Kueri tabel secara langsung dan kelola deskripsi tabel atau bucket
• Komponen: Buat, daftarkan, dan periksa ekstraktor, penulis, aplikasi data, dan konfigurasi transformasi
• SQL: Buat transformasi SQL dengan bahasa alami
• Pekerjaan: Jalankan komponen dan transformasi, serta ambil detail eksekusi pekerjaan
• Alur: Bangun dan kelola pipeline alur kerja menggunakan Conditional Flows dan Orchestrator Flows.
• Aplikasi Data: Buat, terapkan, dan kelola Keboola Streamlit Data Apps yang menampilkan kueri Anda atas data penyimpanan.
• Metadata: Cari, baca, dan perbarui dokumentasi proyek dan metadata objek menggunakan bahasa alami
• Cabang Pengembangan: Bekerja dengan aman di cabang pengembangan di luar produksi, di mana semua operasi dibatasi pada cabang yang dipilih.

---

🚀 Memulai Cepat: Remote MCP Server (Cara Termudah)

Cara termudah untuk menggunakan Keboola MCP Server adalah melalui Remote MCP Server kami. Solusi yang dihosting ini menghilangkan kebutuhan pengaturan lokal, konfigurasi, atau instalasi.

Apa itu Remote MCP Server?

Server jarak jauh kami dihosting di setiap tumpukan Keboola multi-tenant dan mendukung autentikasi OAuth. Anda dapat terhubung ke sana dari asisten AI mana pun yang mendukung koneksi Streamable HTTP jarak jauh dan autentikasi OAuth.

Cara Terhubung

1. Dapatkan URL server jarak jauh Anda: Navigasikan ke Pengaturan Proyek Keboola Anda → tab MCP Server
2. Salin URL server: Ini akan terlihat seperti https://mcp.<YOUR_REGION>.keboola.com/mcp
3. Konfigurasikan asisten AI Anda: Tempel URL ke pengaturan MCP asisten AI Anda
4. Autentikasi: Anda akan diminta untuk masuk dengan akun Keboola Anda. Proyek mana yang akan dikerjakan dipilih setelahnya, dalam percakapan (misalnya "daftarkan proyek Keboola saya" / "gunakan proyek X")

Klien yang Didukung

• Cursor: Gunakan tombol "Install In Cursor" di pengaturan MCP Server proyek Anda atau klik tombol ini
• Claude Desktop: Tambahkan integrasi melalui Settings → Integrations
• Claude Code: Instal menggunakan claude mcp add --transport http keboola <URL> (lihat di bawah untuk detailnya)
• Windsurf: Konfigurasikan dengan URL server jarak jauh
• Make: Konfigurasikan dengan URL server jarak jauh
• Klien MCP lainnya: Konfigurasikan dengan URL server jarak jauh

Pengaturan Claude Code

Claude Code adalah alat antarmuka baris perintah yang memungkinkan Anda berinteraksi dengan Claude menggunakan terminal Anda. Anda dapat menginstal integrasi Keboola MCP Server menggunakan perintah sederhana.

Instalasi:

Jalankan perintah berikut di terminal Anda, ganti <YOUR_REGION> dengan wilayah Keboola Anda:

claude mcp add --transport http keboola https://mcp.<YOUR_REGION>.keboola.com/mcp

Perintah khusus wilayah:

Wilayah	Perintah Instalasi
US Virginia AWS	claude mcp add --transport http keboola https://mcp.keboola.com/mcp
US Virginia GCP	claude mcp add --transport http keboola https://mcp.us-east4.gcp.keboola.com/mcp
EU Frankfurt AWS	claude mcp add --transport http keboola https://mcp.eu-central-1.keboola.com/mcp
EU Ireland Azure	claude mcp add --transport http keboola https://mcp.north-europe.azure.keboola.com/mcp
EU Frankfurt GCP	claude mcp add --transport http keboola https://mcp.europe-west3.gcp.keboola.com/mcp

Penggunaan:

Setelah terinstal, Anda dapat menggunakan Keboola MCP Server di Claude Code dengan mengetik /mcp dalam percakapan Anda dan memilih alat Keboola yang ingin Anda gunakan.

Autentikasi:

Saat pertama kali menggunakan Keboola MCP Server di Claude Code, jendela browser akan terbuka yang meminta Anda untuk:

1. Masuk dengan akun Keboola Anda
2. Otorisasi koneksi

Setelah autentikasi, Anda dapat mulai menggunakan alat Keboola langsung dari Claude Code. Pemilihan proyek terjadi setelahnya, dalam percakapan—cukup tanyakan kepada Claude proyek Keboola mana yang akan digunakan.

Untuk petunjuk pengaturan terperinci dan URL khusus wilayah, lihat dokumentasi Pengaturan Server Jarak Jauh.

Menggunakan Cabang Pengembangan

Anda dapat bekerja dengan aman di cabang pengembangan Keboola tanpa memengaruhi data produksi Anda. Server MCP yang dihosting jarak jauh menghormati parameter KBC_BRANCH_ID dan akan membatasi semua operasi ke cabang yang ditentukan. Anda dapat menemukan ID cabang pengembangan di URL saat menavigasi ke cabang pengembangan di UI, misalnya: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard. ID cabang harus disertakan dalam setiap permintaan menggunakan header X-Branch-Id: <branchId>, jika tidak, Server MCP menggunakan cabang produksi sebagai default. Ini harus dikelola oleh klien AI atau lingkungan yang menangani koneksi server.

Otorisasi Alat dan Kontrol Akses

Saat menggunakan transport berbasis HTTP (Streamable HTTP), Anda dapat mengontrol alat mana yang tersedia untuk klien menggunakan header HTTP. Ini berguna untuk membatasi kemampuan agen AI atau menegakkan kebijakan kepatuhan.

Header Otorisasi

Header	Deskripsi	Contoh
X-Allowed-Tools	Daftar alat yang diizinkan dipisahkan koma	get_configs,get_buckets,query_data
X-Disallowed-Tools	Daftar alat yang dikecualikan dipisahkan koma	create_config,run_job
X-Read-Only-Mode	Batasi hanya ke alat baca-saja	true, 1, atau yes

Perilaku Filter

Filter berlaku secara berurutan: diizinkan → irisan baca-saja → pengecualian yang tidak diizinkan. Header kosong = tanpa pembatasan.

Alat Baca-Saja

Alat baca-saja adalah alat yang dianotasi dengan readOnlyHint=True. Alat-alat ini hanya mengambil informasi tanpa membuat perubahan apa pun pada proyek Keboola Anda. Untuk daftar alat baca-saja saat ini, lihat file TOOLS.md yang merupakan snapshot yang dibuat otomatis dari kumpulan alat yang sebenarnya.

Contoh: Akses Baca-Saja

X-Read-Only-Mode: true

Untuk dokumentasi terperinci, lihat developers.keboola.com/integrate/mcp/#tool-authorization-and-access-control.

---

Pengaturan MCP Server Lokal (Cara Kustom atau Pengembangan)

Jalankan server MCP di mesin Anda sendiri untuk kontrol penuh dan pengembangan yang mudah. Pilih ini saat Anda ingin menyesuaikan alat, men-debug secara lokal, atau melakukan iterasi dengan cepat. Anda akan menginstal server, melakukan autentikasi (login browser satu kali—tanpa token yang perlu ditempel), dan memulainya. Pendekatan ini menawarkan fleksibilitas maksimum (alat kustom, pencatatan lokal, iterasi offline) tetapi memerlukan pengaturan manual dan Anda mengelola pembaruan serta rahasia sendiri.

Server mendukung beberapa opsi transport, yang dapat dipilih dengan memberikan argumen --transport <transport> saat memulai server:

• stdio - Default saat --transport tidak ditentukan. Input/output standar, biasanya digunakan untuk penerapan lokal dengan satu klien.
• streamable-http - Menjalankan server jarak jauh melalui HTTP dengan saluran streaming dua arah, memungkinkan klien dan server untuk terus bertukar pesan. Hubungkan melalui /mcp (misalnya, http://localhost:8000/mcp).
• http-compat - Alias untuk streamable-http, dipertahankan untuk kompatibilitas mundur.

Untuk bekerja dengan proyek Keboola Anda, server memerlukan dua hal: Wilayah Keboola Anda (KBC_STORAGE_API_URL) dan cara untuk melakukan autentikasi. Cara yang disarankan adalah login browser satu kali—Anda tidak pernah membuat, menyalin, atau menempel token. Secara opsional atur KBC_BRANCH_ID untuk bekerja di dalam cabang pengembangan.

Beberapa variabel tidak diambil dari header permintaan:

• KBC_STORAGE_API_URL: server yang dimulai dengan Storage API URL sendiri (parameter --api-url atau variabel lingkungan KBC_STORAGE_API_URL) hanya melayani satu tumpukan Keboola tersebut. Header X-Storage-Api-Url yang meminta host berbeda diabaikan (peringatan dicatat)—server mempertahankan URL-nya sendiri untuk permintaan tersebut. Mulai server tanpa Storage API URL sendiri jika Anda ingin setiap permintaan memilih tumpukannya sendiri.
• KBC_KUBERNETES_TOKEN_PATH (hanya server yang diterapkan, lihat docs/kubernetes-sa-auth.md): dibaca hanya dari lingkungan, tidak pernah dari header.
• KBC_WORKSPACE_ID / KBC_WORKSPACE_SCHEMA: ide yang sama dengan Storage API URL di atas—server yang dimulai dengan pin workspace sendiri (melalui salah satu variabel, atau --workspace-id) mempertahankan pin tersebut untuk setiap permintaan; header X-Workspace-Id atau X-Workspace-Schema yang meminta workspace berbeda diabaikan (peringatan dicatat). Server tanpa pin sendiri (kasus multi-pengguna bersama) terus mengambil pin dari permintaan, per-permintaan, seperti dijelaskan di bawah.

Masuk

Masuk sekali dengan browser Anda; server menyimpan sesi dan menyegarkannya secara otomatis, sehingga tidak ada token yang perlu dikelola:

uvx keboola_mcp_server login --api-url https://connection.YOUR_REGION.keboola.com

Ini membuka browser Anda untuk masuk ke Keboola, lalu menyimpan sesi tingkat tumpukan ke ~/.keboola/mcp/credentials.json (hanya dapat dibaca oleh Anda, satu entri per tumpukan). Setelahnya, mulai server hanya dengan KBC_STORAGE_API_URL yang diatur—tanpa token yang diperlukan. Proyek mana yang akan dikerjakan dipilih setelahnya, dalam percakapan (get_accessible_projects / set_project_scope), bukan selama login.

Perintah	Fungsinya
login --api-url <url>	Masuk ke tumpukan
login --force	Masuk lagi / ganti akun
login --show-token	Cetak token sesi saat ini (debugging)
logout [--api-url <url>] [--all]	Hapus sesi tersimpan untuk tumpukan (atau semua tumpukan)

Saat Anda memulai server melalui stdio di terminal interaktif tanpa sesi tersimpan, server menjalankan login browser ini secara otomatis pada awal pertama. Klien MCP (Claude, Cursor, …) meluncurkan server di latar belakang di mana browser tidak dapat dibuka, jadi jalankan login sendiri sekali terlebih dahulu.

Memulai tanpa akun Keboola

Anda juga dapat memulai server hanya dengan KBC_STORAGE_API_URL dan tanpa kredensial sama sekali. Server muncul dalam mode bootstrap: alat yang memerlukan akses Keboola menjelaskan cara mendapatkan kredensial, dan satu alat berfungsi tanpa kredensial—create_project. Alat ini membuat proyek Keboola baru, menandatangani sesi ke proyek tersebut, dan mengembalikan URL konfirmasi. Membuka URL tersebut di browser dan masuk membuat proyek menjadi milik Anda secara permanen; sampai saat itu proyek bersifat sementara dan Keboola dapat mengklaimnya kembali, dan setelah Anda mengonfirmasi, sesi yang dibuat alat tersebut dicabut dan Anda melanjutkan dengan login Anda sendiri.

Ini memerlukan tumpukan dengan penyediaan agen diaktifkan; di tempat lain alat melaporkan bahwa alat tersebut tidak tersedia.

Autentikasi tanpa browser

Untuk kontainer atau CI di mana login browser tidak memungkinkan, berikan token akses atau token akses pribadi Keboola secara langsung—atur KBC_STORAGE_TOKEN (variabel env) atau kirim header X-StorageAPI-Token—bersama dengan KBC_PROJECT_ID (atau header X-KBC-ProjectId) untuk memilih proyek. Pada transport HTTP, ini dapat diberikan per permintaan sebagai header, sehingga setiap permintaan membawa kredensialnya sendiri.

KBC_WORKSPACE_ID

Menetapkan kueri ke satu workspace yang sudah ada dan spesifik berdasarkan ID-nya alih-alih pencarian berbasis skema di atas, dan lebih diutamakan daripada KBC_WORKSPACE_SCHEMA saat keduanya diatur. Ini adalah opsi yang diberikan oleh pemanggil Data App / kai-agent, sebagai header X-Workspace-Id, sehingga Kai yang tertanam dalam aplikasi tersebut hanya melakukan kueri melalui workspace-nya sendiri.

Atur melalui variabel lingkungan KBC_WORKSPACE_ID, flag CLI --workspace-id, atau (per-permintaan, untuk penerapan multi-pengguna) header X-Workspace-Id.

KBC_STORAGE_API_URL (Wilayah Keboola)

URL API Wilayah Keboola Anda bergantung pada wilayah penerapan Anda. Anda dapat menentukan wilayah Anda dengan melihat URL di browser saat masuk ke proyek Keboola Anda:

Wilayah	URL API
AWS Amerika Utara	https://connection.keboola.com
AWS Eropa	https://connection.eu-central-1.keboola.com
Google Cloud EU	https://connection.europe-west3.gcp.keboola.com
Google Cloud US	https://connection.us-east4.gcp.keboola.com
Azure EU	https://connection.north-europe.azure.keboola.com

KBC_BRANCH_ID (Opsional)

Untuk beroperasi pada cabang pengembangan Keboola tertentu, atur ID cabang menggunakan parameter KBC_BRANCH_ID. Server MCP membatasi fungsinya pada cabang yang ditentukan, memastikan semua perubahan tetap terisolasi dan tidak berdampak pada cabang produksi.

• Jika tidak disediakan, server menggunakan cabang produksi secara default.
• Untuk pekerjaan pengembangan, atur KBC_BRANCH_ID ke ID numerik cabang Anda (misalnya, 123456). Anda dapat menemukan ID cabang pengembangan di URL saat menavigasi ke cabang pengembangan di UI, contohnya: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard.
• Pada transportasi jarak jauh, Anda dapat menimpa per-permintaan dengan header HTTP X-Branch-Id: <branchId> atau KBC_BRANCH_ID: <branchId>.

Instalasi

Pastikan Anda memiliki:

• Python 3.10+ terinstal
• Akses ke proyek Keboola dengan hak admin
• Klien MCP pilihan Anda (Claude, Cursor, dll.)

Catatan: Pastikan Anda memiliki uv terinstal. Klien MCP akan menggunakannya untuk mengunduh dan menjalankan Keboola MCP Server secara otomatis. Menginstal uv:

macOS/Linux:

#if homebrew is not installed on your machine use:
# /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install using Homebrew
brew install uv

Windows:

# Using the installer script
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or using pip
pip install uv

# Or using winget
winget install --id=astral-sh.uv -e

Untuk opsi instalasi lainnya, lihat dokumentasi uv resmi.

Menjalankan Keboola MCP Server

Ada empat cara untuk menggunakan Keboola MCP Server, tergantung pada kebutuhan Anda:

Opsi A: Mode Terintegrasi (Direkomendasikan)

Dalam mode ini, Claude atau Cursor secara otomatis memulai server MCP untuk Anda.

1. Masuk sekali di terminal sehingga sesi tersimpan (klien meluncurkan server di latar belakang, di mana browser tidak dapat dibuka):

   uvx keboola_mcp_server login --api-url https://connection.YOUR_REGION.keboola.com
   

2. Konfigurasikan klien MCP Anda (Claude/Cursor) dengan pengaturan di bawah ini — hanya KBC_STORAGE_API_URL yang diperlukan.
3. Klien akan secara otomatis meluncurkan server MCP saat diperlukan.

Konfigurasi Claude Desktop

1. Buka Claude (pojok kiri atas layar Anda) -> Settings → Developer → Edit Config (jika Anda tidak melihat claude_desktop_config.json, buatlah)
2. Tambahkan konfigurasi berikut:
3. Mulai ulang Claude desktop agar perubahan berlaku

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": ["keboola_mcp_server --transport <transport>"],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

Lokasi file konfigurasi:

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

Konfigurasi Cursor

1. Buka Settings → MCP
2. Klik "+ Add new global MCP Server"
3. Konfigurasikan dengan pengaturan ini:

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": ["keboola_mcp_server --transport <transport>"],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

Catatan: Gunakan nama yang singkat dan deskriptif untuk server MCP. Karena nama alat lengkap mencakup nama server dan harus tetap di bawah ~60 karakter, nama yang lebih panjang mungkin disaring di Cursor dan tidak akan ditampilkan kepada Agen.

Konfigurasi Cursor untuk Windows WSL

Saat menjalankan server MCP dari Windows Subsystem for Linux dengan Cursor AI, gunakan konfigurasi ini:

{
  "mcpServers": {
    "keboola":{
      "command": "wsl.exe",
      "args": [
          "bash",
          "-c '",
          "export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com &&",
          "export KBC_BRANCH_ID=your_branch_id_optional &&",
          "/snap/bin/uvx keboola_mcp_server --transport <transport>",
          "'"
      ]
    }
  }
}

Opsi B: Mode Pengembangan Lokal

Untuk pengembang yang mengerjakan kode server MCP itu sendiri:

1. Klon repositori dan siapkan lingkungan lokal
2. Konfigurasikan Claude/Cursor untuk menggunakan jalur Python lokal Anda:

{
  "mcpServers": {
    "keboola": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": [
        "-m",
        "keboola_mcp_server --transport <transport>"
      ],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

Opsi C: Mode CLI Manual (Hanya untuk Pengujian)

Anda dapat menjalankan server secara manual di terminal untuk pengujian atau debugging:

# Sign in once (stores a session under ~/.keboola/mcp), then start the server.
export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com
uvx keboola_mcp_server login --api-url "$KBC_STORAGE_API_URL"

uvx keboola_mcp_server --transport streamable-http

Catatan: Mode ini terutama untuk debugging atau pengujian. Untuk penggunaan normal dengan Claude atau Cursor, Anda tidak perlu menjalankan server secara manual.

Catatan: Server akan menggunakan transportasi Streamable HTTP dan mendengarkan di localhost:8000 untuk koneksi masuk di /mcp. Anda dapat menggunakan parameter --port dan --host untuk membuatnya mendengarkan di tempat lain.

Opsi D: Menggunakan Docker

Kontainer tidak dapat membuka browser, jadi autentikasi dengan token (lihat Autentikasi tanpa browser): atur KBC_STORAGE_TOKEN ke token akses/pribadi Keboola dan KBC_PROJECT_ID ke proyek target. (Melalui HTTP Anda dapat meneruskan header X-StorageAPI-Token / X-KBC-ProjectId per permintaan dan menghilangkan ini.)

docker pull keboola/mcp-server:latest

docker run \
  --name keboola_mcp_server \
  --rm \
  -it \
  -p 127.0.0.1:8000:8000 \
  -e KBC_STORAGE_API_URL="https://connection.YOUR_REGION.keboola.com" \
  -e KBC_STORAGE_TOKEN="YOUR_KEBOOLA_TOKEN" \
  -e KBC_PROJECT_ID="YOUR_PROJECT_ID" \
  -e KBC_BRANCH_ID="YOUR_BRANCH_ID_OPTIONAL" \
  keboola/mcp-server:latest \
  --transport streamable-http \
  --host 0.0.0.0

Catatan: Server akan menggunakan transportasi Streamable HTTP dan mendengarkan di localhost:8000 untuk koneksi masuk di /mcp. Anda dapat mengubah -p untuk memetakan port kontainer ke tempat lain.

Apakah Saya Perlu Memulai Server Sendiri?

Skenario	Perlu Menjalankan Secara Manual?	Gunakan Pengaturan Ini
Menggunakan Claude/Cursor	Tidak	Konfigurasikan MCP di pengaturan aplikasi
Mengembangkan MCP secara lokal	Tidak (Claude memulainya)	Arahkan konfigurasi ke jalur python
Menguji CLI secara manual	Ya	Gunakan terminal untuk menjalankan
Menggunakan Docker	Ya	Jalankan kontainer docker

Menggunakan Server MCP

Setelah klien MCP Anda (Claude/Cursor) dikonfigurasi dan berjalan, Anda dapat mulai menanyakan data Keboola Anda:

Verifikasi Pengaturan Anda

Anda dapat memulai dengan kueri sederhana untuk mengonfirmasi semuanya berfungsi:

What buckets and tables are in my Keboola project?

Contoh Hal yang Dapat Anda Lakukan

Eksplorasi Data:

• "Tabel apa yang berisi informasi pelanggan?"
• "Jalankan kueri untuk menemukan 10 pelanggan teratas berdasarkan pendapatan"

Analisis Data:

• "Analisis data penjualan saya berdasarkan wilayah untuk kuartal terakhir"
• "Temukan korelasi antara usia pelanggan dan frekuensi pembelian"

Pipeline Data:

• "Buat transformasi SQL yang menggabungkan tabel pelanggan dan pesanan"
• "Mulai pekerjaan ekstraksi data untuk komponen Salesforce saya"

Kompatibilitas

Dukungan Klien MCP

Klien MCP	Status Dukungan	Metode Koneksi
Claude (Desktop & Web)	✅ didukung	stdio
Cursor	✅ didukung	stdio
Windsurf, Zed, Replit	✅ Didukung	stdio
Codeium, Sourcegraph	✅ Didukung	Streamable HTTP
Klien MCP Kustom	✅ Didukung	Streamable HTTP atau stdio

Alat yang Didukung

Catatan: Agen AI Anda akan secara otomatis menyesuaikan diri dengan alat baru.

Untuk daftar lengkap alat yang tersedia dengan deskripsi terperinci, parameter, dan contoh penggunaan, lihat TOOLS.md.

Pemecahan Masalah

Masalah Umum

Masalah	Solusi
Kesalahan Autentikasi	Jalankan ulang keboola_mcp_server login (atau, jika mengautentikasi dengan token, verifikasi token dan KBC_PROJECT_ID)
Waktu Habis Koneksi	Periksa konektivitas jaringan

Pengembangan

Instalasi

Pengaturan dasar:

uv sync --extra dev

Dengan pengaturan dasar, Anda dapat menggunakan uv run tox untuk menjalankan tes dan memeriksa gaya kode.

Pengaturan yang direkomendasikan:

uv sync --extra dev --extra tests --extra integtests --extra codestyle

Dengan pengaturan yang direkomendasikan, paket untuk pengujian dan pemeriksaan gaya kode akan diinstal yang memungkinkan IDE seperti VsCode atau Cursor untuk memeriksa kode atau menjalankan tes selama pengembangan.

Tes integrasi

Untuk menjalankan tes integrasi secara lokal, gunakan uv run tox -e integtests. CATATAN: Anda perlu mengatur variabel lingkungan berikut:

• INTEGTEST_POOL_STORAGE_API_URL
• INTEGTEST_STORAGE_TOKENS
• INTEGTEST_STORAGE_TOKEN_STORAGE_BRANCHES

Untuk mendapatkan nilai-nilai ini, Anda memerlukan proyek Keboola khusus untuk tes integrasi. Setiap sesi tes membuat ruang kerja hanya-baca sendiri, jadi tidak ada skema ruang kerja yang perlu dikonfigurasi. Lihat integtests/README.md untuk instruksi pengaturan terperinci dan dokumentasi desain.

Memperbarui uv.lock

Perbarui file uv.lock jika Anda telah menambahkan atau menghapus dependensi. Pertimbangkan juga untuk memperbarui kunci dengan versi dependensi yang lebih baru saat membuat rilis (uv lock --upgrade).

Memperbarui Dokumentasi Alat

Saat Anda membuat perubahan pada deskripsi alat apa pun (docstrings dalam fungsi alat), Anda harus membuat ulang file dokumentasi TOOLS.md untuk mencerminkan perubahan ini:

uv run python -m src.keboola_mcp_server.generate_tool_docs

Merilis

Kami tidak memotong rilis untuk setiap PR yang digabungkan. Pekerjaan mendarat di trunk (main) secara terus-menerus, dan kami merilis secara berkala setelah perubahan diuji ulang bersama — ini menghindari merusak pengaturan yang berfungsi bagi pengguna.

Rilis dibuat dengan mendorong satu atau dua tag git:

• vX.Y.Z — rilis server MCP (selalu)
• agent-vX.Y.Z — rilis In Platform Agent (hanya saat agen juga dirilis)

Salah satu tag memicu CI release.yml, yang membangun dan menerbitkan gambar Docker. KaiBench hanya berjalan pada tag vX.Y.Z produksi (bukan agent-vX.Y.Z, dan bukan -dev. prarilis). Gunakan keterampilan release-notes — ini menyiapkan catatan rilis dan PR draf serta memandu penandaan vX.Y.Z dan agent-vX.Y.Z.

Dukungan dan Umpan Balik

⭐ Cara utama untuk mendapatkan bantuan, melaporkan bug, atau meminta fitur adalah dengan membuka masalah di GitHub. ⭐

Tim pengembangan secara aktif memantau masalah dan akan merespons secepat mungkin. Untuk informasi umum tentang Keboola, silakan gunakan sumber daya di bawah ini.

Sumber Daya

• Dokumentasi Pengguna
• Dokumentasi Pengembang
• Platform Keboola
• Pelacak Masalah ← Metode kontak utama untuk Server MCP

Terhubung

• LinkedIn
• Twitter
• Changelog