Keboola MCP Server

Keboola MCP Sunucusu

Yapay zeka ajanlarınızı, MCP istemcilerinizi (Cursor, Claude, Windsurf, VS Code ...) ve diğer yapay zeka asistanlarınızı Keboola'ya bağlayın. Verileri, dönüşümleri, SQL sorgularını ve iş tetikleyicilerini hiçbir yapıştırıcı kod gerektirmeden sunun. Ajanlara doğru veriyi, ihtiyaç duydukları anda ve yerde ulaştırın.

Genel Bakış

Keboola MCP Sunucusu, Keboola projeniz ile modern yapay zeka araçları arasında açık kaynaklı bir köprüdür. Depolama erişimi, SQL dönüşümleri ve iş tetikleyicileri gibi Keboola özelliklerini Claude, Cursor, CrewAI, LangChain, Amazon Q ve daha fazlası için çağrılabilir araçlara dönüştürür.

• Hızlı Başlangıç
• Yerel Kurulum

Özellikler

Yapay Zeka Ajanı ve MCP Sunucusu ile şunları yapabilirsiniz:

• Depolama: Tabloları doğrudan sorgulayın ve tablo veya bucket açıklamalarını yönetin
• Bileşenler: Çıkarıcıları, yazıcıları, veri uygulamalarını ve dönüşüm yapılandırmalarını oluşturun, listeleyin ve inceleyin
• SQL: Doğal dil ile SQL dönüşümleri oluşturun
• İşler: Bileşenleri ve dönüşümleri çalıştırın, iş yürütme ayrıntılarını alın
• Akışlar: Koşullu Akışlar ve Orkestratör Akışları kullanarak iş akışı hatları oluşturun ve yönetin.
• Veri Uygulamaları: Depolama verileriniz üzerindeki sorgularınızı görüntüleyen Keboola Streamlit Veri Uygulamaları oluşturun, dağıtın ve yönetin.
• Meta Veri: Doğal dil kullanarak proje dokümantasyonunu ve nesne meta verilerini arayın, okuyun ve güncelleyin
• Geliştirme Dalları: Tüm işlemlerin seçilen dalla sınırlı olduğu, üretim dışındaki geliştirme dallarında güvenle çalışın.

---

🚀 Hızlı Başlangıç: Uzak MCP Sunucusu (En Kolay Yol)

Keboola MCP Sunucusunu kullanmanın en kolay yolu Uzak MCP Sunucumuzdur. Bu barındırılan çözüm, yerel kurulum, yapılandırma veya kurulum ihtiyacını ortadan kaldırır.

Uzak MCP Sunucusu Nedir?

Uzak sunucumuz, her çok kiracılı Keboola yığınında barındırılır ve OAuth kimlik doğrulamasını destekler. Uzak Streamable HTTP bağlantısını ve OAuth kimlik doğrulamasını destekleyen herhangi bir yapay zeka asistanından bağlanabilirsiniz.

Nasıl Bağlanılır

1. Uzak sunucu URL'nizi alın: Keboola Proje Ayarlarınız → MCP Server sekmesine gidin
2. Sunucu URL'sini kopyalayın: https://mcp.<YOUR_REGION>.keboola.com/mcp gibi görünecektir
3. Yapay zeka asistanınızı yapılandırın: URL'yi yapay zeka asistanınızın MCP ayarlarına yapıştırın
4. Kimlik doğrulayın: Keboola hesabınızla kimlik doğrulamanız ve projenizi seçmeniz istenecektir

Desteklenen İstemciler

• Cursor: Projenizin MCP Sunucusu ayarlarındaki "Cursor'a Kur" düğmesini kullanın veya bu düğmeye tıklayın
• Claude Desktop: Ayarlar → Entegrasyonlar aracılığıyla entegrasyonu ekleyin
• Claude Code: claude mcp add --transport http keboola <URL> kullanarak kurun (detaylar için aşağıya bakın)
• Windsurf: Uzak sunucu URL'si ile yapılandırın
• Make: Uzak sunucu URL'si ile yapılandırın
• Diğer MCP istemcileri: Uzak sunucu URL'si ile yapılandırın

Claude Code Kurulumu

Claude Code, terminalinizi kullanarak Claude ile etkileşim kurmanızı sağlayan bir komut satırı arayüz aracıdır. Keboola MCP Sunucusu entegrasyonunu basit bir komutla kurabilirsiniz.

Kurulum:

Terminalinizde aşağıdaki komutu çalıştırın, <YOUR_REGION> yerine Keboola bölgenizi yazın:

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

Bölgeye özel komutlar:

Bölge	Kurulum Komutu
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

Kullanım:

Kurulduktan sonra, Claude Code'da /mcp yazarak ve kullanmak istediğiniz Keboola araçlarını seçerek Keboola MCP Sunucusunu kullanabilirsiniz.

Kimlik Doğrulama:

Claude Code'da Keboola MCP Sunucusunu ilk kullandığınızda, şunları yapmanızı isteyen bir tarayıcı penceresi açılacaktır:

1. Keboola hesabınızla oturum açın
2. Bağlanmak istediğiniz projeyi seçin
3. Bağlantıyı yetkilendirin

Kimlik doğrulamadan sonra, doğrudan Claude Code'dan Keboola araçlarını kullanmaya başlayabilirsiniz.

Ayrıntılı kurulum talimatları ve bölgeye özel URL'ler için Uzak Sunucu Kurulumu belgelerimize bakın.

Geliştirme Dallarını Kullanma

Üretim verilerinizi etkilemeden Keboola geliştirme dallarında güvenle çalışabilirsiniz. Uzaktan barındırılan MCP Sunucuları KBC_BRANCH_ID parametresine saygı duyar ve tüm işlemleri belirtilen dalla sınırlar. Geliştirme dalı kimliğini, kullanıcı arayüzünde geliştirme dalına giderken URL'de bulabilirsiniz, örneğin: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard. Dal kimliği, X-Branch-Id: <branchId> başlığı kullanılarak her isteğe dahil edilmelidir, aksi takdirde MCP Sunucusu varsayılan olarak üretim dalını kullanır. Bu, yapay zeka istemcisi veya sunucu bağlantısını yöneten ortam tarafından yönetilmelidir.

Araç Yetkilendirme ve Erişim Kontrolü

HTTP tabanlı aktarımlar (Streamable HTTP) kullanırken, HTTP başlıklarını kullanarak istemciler için hangi araçların kullanılabilir olduğunu kontrol edebilirsiniz. Bu, yapay zeka ajan yeteneklerini kısıtlamak veya uyumluluk politikalarını uygulamak için kullanışlıdır.

Yetkilendirme Başlıkları

Başlık	Açıklama	Örnek
X-Allowed-Tools	İzin verilen araçların virgülle ayrılmış listesi	get_configs,get_buckets,query_data
X-Disallowed-Tools	Hariç tutulacak araçların virgülle ayrılmış listesi	create_config,run_job
X-Read-Only-Mode	Yalnızca salt okunur araçlarla kısıtla	true, 1 veya yes

Filtre Davranışı

Filtreler şu sırayla uygulanır: izin verilen → salt okunur kesişimi → izin verilmeyen hariç tutma. Boş başlıklar = kısıtlama yok.

Salt Okunur Araçlar

Salt okunur araçlar, readOnlyHint=True ile açıklanmış olanlardır. Bu araçlar, Keboola projenizde herhangi bir değişiklik yapmadan yalnızca bilgi alır. Salt okunur araçların güncel listesi için, gerçek araç setinin otomatik olarak oluşturulmuş bir anlık görüntüsü olan TOOLS.md dosyasına bakın.

Örnek: Salt Okunur Erişim

X-Read-Only-Mode: true

Ayrıntılı belgeler için developers.keboola.com/integrate/mcp/#tool-authorization-and-access-control adresine bakın.

---

Yerel MCP Sunucusu Kurulumu (Özel veya Geliştirme Yolu)

Tam kontrol ve kolay geliştirme için MCP sunucusunu kendi makinenizde çalıştırın. Araçları özelleştirmek, yerel olarak hata ayıklamak veya hızlı yineleme yapmak istediğinizde bunu seçin. Depoyu klonlayacak, sunucu aktarımına bağlı olarak ortam değişkenleri veya başlıklar aracılığıyla Keboola kimlik bilgilerini ayarlayacak, bağımlılıkları kuracak ve sunucuyu başlatacaksınız. Bu yaklaşım maksimum esneklik (özel araçlar, yerel günlük kaydı, çevrimdışı yineleme) sunar ancak manuel kurulum gerektirir ve güncellemeleri ve sırları kendiniz yönetirsiniz.

Sunucu, sunucuyu başlatırken --transport <transport> argümanı sağlanarak seçilebilen birden çok aktarım seçeneğini destekler:

• stdio - --transport belirtilmediğinde varsayılan. Genellikle tek bir istemciyle yerel dağıtım için kullanılan standart giriş/çıkış.
• streamable-http - İstemci ve sunucunun sürekli olarak mesaj alışverişi yapmasına olanak tanıyan çift yönlü akış kanalıyla sunucuyu HTTP üzerinden uzaktan çalıştırır. /mcp üzerinden bağlanın (örn. http://localhost:8000/mcp).
• http-compat - streamable-http için bir takma ad, geriye dönük uyumluluk için tutulur.

İstemci-sunucu iletişimi için, Keboola Bölgenizdeki projenizle çalışmayı sağlamak üzere Keboola kimlik bilgileri sağlanmalıdır. Aşağıdakiler gereklidir: KBC_STORAGE_TOKEN, KBC_STORAGE_API_URL, KBC_WORKSPACE_SCHEMA ve isteğe bağlı olarak KBC_BRANCH_ID. Bunları iki şekilde sağlayabilirsiniz:

• Kişisel kullanım için (esas olarak stdio aktarımıyla): sunucuyu başlatmadan önce ortam değişkenlerini ayarlayın. Tüm istekler bu önceden tanımlanmış kimlik bilgilerini yeniden kullanacaktır.
• Çok kullanıcılı kullanım için: değişkenleri istek başlıklarına dahil edin, böylece her istek kendisiyle birlikte sağlanan kimlik bilgilerini kullanır.

KBC_STORAGE_TOKEN

Bu, Keboola için kimlik doğrulama belirtecinizdir:

Depolama API belirteçlerinin nasıl oluşturulacağı ve yönetileceği ile ilgili talimatlar için resmi Keboola belgelerine bakın.

Not: MCP sunucusunun sınırlı erişime sahip olmasını istiyorsanız, özel depolama belirteci kullanın; MCP'nin projenizdeki her şeye erişmesini istiyorsanız, ana belirteci kullanın.

KBC_WORKSPACE_SCHEMA

Bu, Keboola'daki çalışma alanınızı tanımlar ve SQL sorguları için kullanılır. Ancak, bu yalnızca Ana Belirteç yerine özel bir depolama belirteci kullanıyorsanız gereklidir:

• Ana Belirteç kullanılıyorsa: Çalışma alanı perde arkasında otomatik olarak oluşturulur
• Özel depolama belirteci kullanılıyorsa: KBC_WORKSPACE_SCHEMA'nızı almak için bu Keboola kılavuzunu izleyin

Not: Manuel olarak bir çalışma alanı oluştururken, Tüm Proje verilerine salt okunur erişim izni ver seçeneğini işaretleyin

Not: KBC_WORKSPACE_SCHEMA, BigQuery çalışma alanlarında Veri Kümesi Adı olarak adlandırılır, sadece bağlan'a tıklayın ve Veri Kümesi Adını kopyalayın

KBC_STORAGE_API_URL (Keboola Bölgesi)

Keboola Bölge API URL'niz, dağıtım bölgenize bağlıdır. Keboola projenizde oturum açtığınızda tarayıcınızdaki URL'ye bakarak bölgenizi belirleyebilirsiniz:

Bölge	API URL
AWS Kuzey Amerika	https://connection.keboola.com
AWS Avrupa	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 (İsteğe Bağlı)

Belirli bir Keboola geliştirme dalında çalışmak için, KBC_BRANCH_ID parametresini kullanarak dal kimliğini ayarlayın. MCP sunucusu, işlevselliğini belirtilen dalla sınırlar ve tüm değişikliklerin izole kalmasını ve üretim dalını etkilememesini sağlar.

• Sağlanmazsa, sunucu varsayılan olarak üretim dalını kullanır.
• Geliştirme çalışmaları için, KBC_BRANCH_ID dalınızın sayısal kimliğine ayarlayın (örn. 123456). Geliştirme dalı kimliğini, kullanıcı arayüzünde geliştirme dalına giderken URL'de bulabilirsiniz, örneğin: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard.
• Uzak aktarımlarda, HTTP başlığı X-Branch-Id: <branchId> veya KBC_BRANCH_ID: <branchId> ile istek başına geçersiz kılabilirsiniz.

Kurulum

Aşağıdakilere sahip olduğunuzdan emin olun:

• Python 3.10+ kurulu
• Yönetici haklarına sahip bir Keboola projesine erişim
• Tercih ettiğiniz MCP istemcisi (Claude, Cursor, vb.)

Not: uv kurulu olduğundan emin olun. MCP istemcisi, Keboola MCP Sunucusunu otomatik olarak indirip çalıştırmak için bunu kullanacaktır. uv Kurulumu:

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

Daha fazla kurulum seçeneği için resmi uv belgelerine bakın.

Keboola MCP Sunucusunu Çalıştırma

İhtiyaçlarınıza bağlı olarak Keboola MCP Sunucusunu kullanmanın dört yolu vardır:

Seçenek A: Entegre Mod (Önerilen)

Bu modda, Claude veya Cursor MCP sunucusunu sizin için otomatik olarak başlatır. Terminalinizde herhangi bir komut çalıştırmanız gerekmez.

1. MCP istemcinizi (Claude/Cursor) uygun ayarlarla yapılandırın
2. İstemci, gerektiğinde MCP sunucusunu otomatik olarak başlatacaktır

Claude Desktop Yapılandırması

1. Claude'a gidin (ekranınızın sol üst köşesi) -> Ayarlar → Geliştirici → Yapılandırmayı Düzenle (claude_desktop_config.json dosyasını görmüyorsanız, oluşturun)
2. Aşağıdaki yapılandırmayı ekleyin:
3. Değişikliklerin etkili olması için Claude masaüstünü yeniden başlatın

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

Yapılandırma dosyası konumları:

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

Cursor Yapılandırması

1. Ayarlar → MCP'ye gidin
2. "+ Yeni global MCP Sunucusu ekle"ye tıklayın
3. Bu ayarlarla yapılandırın:

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

Not: MCP sunucuları için kısa, açıklayıcı adlar kullanın. Tam araç adı sunucu adını içerdiğinden ve ~60 karakterin altında kalması gerektiğinden, daha uzun adlar Cursor'da filtrelenebilir ve Ajana gösterilmeyebilir.

Windows WSL için Cursor Yapılandırması

MCP sunucusunu Windows Subsystem for Linux'tan Cursor AI ile çalıştırırken, bu yapılandırmayı kullanın:

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

Seçenek B: Yerel Geliştirme Modu

MCP sunucusu kodunun kendisi üzerinde çalışan geliştiriciler için:

1. Depoyu klonlayın ve yerel bir ortam kurun
2. Claude/Cursor'u yerel Python yolunuzu kullanacak şekilde yapılandırın:

{
  "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_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

Seçenek C: Manuel CLI Modu (Yalnızca Test İçin)

Test veya hata ayıklama amacıyla sunucuyu bir terminalde manuel olarak çalıştırabilirsiniz:

# Set environment variables
export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com
export KBC_STORAGE_TOKEN=your_keboola_storage_token
export KBC_WORKSPACE_SCHEMA=your_workspace_schema
export KBC_BRANCH_ID=your_branch_id_optional

uvx keboola_mcp_server --transport streamable-http

Not: Bu mod öncelikle hata ayıklama veya test içindir. Claude veya Cursor ile normal kullanım için sunucuyu manuel olarak çalıştırmanız gerekmez.

Not: Sunucu, Streamable HTTP aktarımını kullanacak ve gelen bağlantılar için localhost:8000 adresinde /mcp portunu dinleyecektir. Başka bir yerde dinlemesini sağlamak için --port ve --host parametrelerini kullanabilirsiniz.

Seçenek D: Docker Kullanımı

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_STORAGE_TOKEN" \
  -e KBC_WORKSPACE_SCHEMA="YOUR_WORKSPACE_SCHEMA" \
  -e KBC_BRANCH_ID="YOUR_BRANCH_ID_OPTIONAL" \
  keboola/mcp-server:latest \
  --transport streamable-http \
  --host 0.0.0.0

Not: Sunucu, Streamable HTTP aktarımını kullanacak ve gelen bağlantılar için localhost:8000 adresinde /mcp portunu dinleyecektir. Konteynerin portunu başka bir yere eşlemek için -p değerini değiştirebilirsiniz.

Sunucuyu Kendim Başlatmam Gerekiyor mu?

Senaryo	Manuel Çalıştırma Gerekiyor mu?	Bu Kurulumu Kullanın
Claude/Cursor Kullanımı	Hayır	MCP'yi uygulama ayarlarında yapılandırın
MCP'yi yerelde geliştirme	Hayır (Claude başlatır)	Yapılandırmayı python yoluna yönlendirin
CLI'yi manuel test etme	Evet	Çalıştırmak için terminal kullanın
Docker Kullanımı	Evet	Docker konteynerini çalıştırın

MCP Sunucusunu Kullanma

MCP istemciniz (Claude/Cursor) yapılandırılıp çalıştığında, Keboola verilerinizi sorgulamaya başlayabilirsiniz:

Kurulumunuzu Doğrulayın

Her şeyin çalıştığını doğrulamak için basit bir sorgu ile başlayabilirsiniz:

What buckets and tables are in my Keboola project?

Yapabileceklerinize Dair Örnekler

Veri Keşfi:

• "Hangi tablolar müşteri bilgilerini içeriyor?"
• "Gelire göre en iyi 10 müşteriyi bulmak için bir sorgu çalıştır"

Veri Analizi:

• "Son çeyrek için satış verilerimi bölgeye göre analiz et"
• "Müşteri yaşı ile satın alma sıklığı arasındaki korelasyonları bul"

Veri İşlem Hatları:

• "Müşteri ve sipariş tablolarını birleştiren bir SQL dönüşümü oluştur"
• "Salesforce bileşenim için veri çıkarma işini başlat"

Uyumluluk

MCP İstemci Desteği

MCP İstemcisi	Destek Durumu	Bağlantı Yöntemi
Claude (Masaüstü ve Web)	✅ destekleniyor	stdio
Cursor	✅ destekleniyor	stdio
Windsurf, Zed, Replit	✅ Destekleniyor	stdio
Codeium, Sourcegraph	✅ Destekleniyor	Streamable HTTP
Özel MCP İstemcileri	✅ Destekleniyor	Streamable HTTP veya stdio

Desteklenen Araçlar

Not: Yapay zeka ajanlarınız yeni araçlara otomatik olarak uyum sağlayacaktır.

Ayrıntılı açıklamalar, parametreler ve kullanım örnekleriyle birlikte mevcut araçların tam listesi için TOOLS.md dosyasına bakın.

Sorun Giderme

Yaygın Sorunlar

Sorun	Çözüm
Kimlik Doğrulama Hataları	KBC_STORAGE_TOKEN değerinin geçerli olduğunu doğrulayın
Çalışma Alanı Sorunları	KBC_WORKSPACE_SCHEMA değerinin doğru olduğunu onaylayın
Bağlantı Zaman Aşımı	Ağ bağlantısını kontrol edin

Geliştirme

Kurulum

Temel kurulum:

uv sync --extra dev

Temel kurulum ile testleri çalıştırmak ve kod stilini kontrol etmek için uv run tox kullanabilirsiniz.

Önerilen kurulum:

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

Önerilen kurulum ile test ve kod stili kontrolü için paketler yüklenecek, bu da VsCode veya Cursor gibi IDE'lerin geliştirme sırasında kodu kontrol etmesine veya testleri çalıştırmasına olanak tanıyacaktır.

Entegrasyon testleri

Entegrasyon testlerini yerel olarak çalıştırmak için uv run tox -e integtests kullanın. NOT: Aşağıdaki ortam değişkenlerini ayarlamanız gerekecektir:

• INTEGTEST_POOL_STORAGE_API_URL
• INTEGTEST_STORAGE_TOKENS
• INTEGTEST_STORAGE_TOKEN_STORAGE_BRANCHES

Bu değerleri elde etmek için entegrasyon testleri için özel Keboola projelerine ihtiyacınız vardır. Her test oturumu kendi salt okunur çalışma alanını oluşturur, bu nedenle hiçbir çalışma alanı şemasının yapılandırılması gerekmez. Ayrıntılı kurulum talimatları ve tasarım belgeleri için integtests/README.md dosyasına bakın.

uv.lock Güncelleme

Bağımlılık eklediyseniz veya kaldırdıysanız uv.lock dosyasını güncelleyin. Ayrıca bir sürüm oluştururken kilidi daha yeni bağımlılık sürümleriyle güncellemeyi düşünün (uv lock --upgrade).

Araç Belgelerini Güncelleme

Herhangi bir araç açıklamasında (araç işlevlerindeki docstring'ler) değişiklik yaptığınızda, bu değişiklikleri yansıtmak için TOOLS.md belge dosyasını yeniden oluşturmanız gerekir:

uv run python -m src.keboola_mcp_server.generate_tool_docs

Sürüm Yayınlama

Birleştirilen her PR için sürüm yayınlamayız. Çalışmalar sürekli olarak ana dala (main) eklenir ve değişiklikler birlikte yeniden test edildikten sonra periyodik olarak sürüm yayınlarız — bu, kullanıcılar için çalışan kurulumların bozulmasını önler.

Bir sürüm, bir veya iki git etiketi gönderilerek yapılır:

• vX.Y.Z — MCP sunucu sürümü (her zaman)
• agent-vX.Y.Z — In Platform Agent sürümü (yalnızca ajan da yayınlanıyorsa)

Her iki etiket de Docker imajını oluşturan ve yayınlayan release.yml CI'sını tetikler. KaiBench yalnızca üretim vX.Y.Z etiketlerinde çalışır (agent-vX.Y.Z veya -dev. ön sürümlerinde değil). release-notes becerisini kullanın — sürüm notlarını ve taslak PR'ı hazırlar ve hem vX.Y.Z hem de agent-vX.Y.Z etiketleme sürecinde size rehberlik eder.

Destek ve Geri Bildirim

⭐ Yardım almanın, hataları bildirmenin veya özellik talep etmenin birincil yolu GitHub'da bir konu açmaktır. ⭐

Geliştirme ekibi konuları aktif olarak izler ve mümkün olan en kısa sürede yanıt verir. Keboola hakkında genel bilgi için lütfen aşağıdaki kaynakları kullanın.

Kaynaklar

• Kullanıcı Belgeleri
• Geliştirici Belgeleri
• Keboola Platformu
• Konu Takipçisi ← MCP Sunucusu için birincil iletişim yöntemi

Bağlantı

• LinkedIn
• Twitter
• Değişiklik Günlüğü