Couchbase
resmiCouchbase kümelerinde depolanan verilerle doğal dil kullanarak etkileşim kurun.
Couchbase MCP ile neler yapabilirsiniz?
- Küme verilerini keşfetme — Bucket'ları, scope'ları ve collection'ları listeleyin, ardından
ordersgibi bir collection'ın şemasını çıkarın. - SQL++ sorguları çalıştırma — Bir bucket ve scope üzerinde salt okunur SQL++ sorguları çalıştırın ve sorgu planlarını açıklayın.
- Belgeleri inceleme — Bir belgeyi ID'sine göre getirin veya belgenin tamamını yüklemeden belirli alt belge yollarını okuyun.
- Küme sağlığını kontrol etme — Küme sağlığını, çalışan servisleri ve bağlantı tanılamalarını raporlayın.
- Sorgu performansını analiz etme — En uzun süren, en sık çalıştırılan veya kapsayıcı olmayan indeks sorgularını bulun.
- Arama ve vektör sorguları — Yapılandırılmış indekslerde tam metin araması ve vektör benzerliği sorguları çalıştırın.
Dokümantasyon
Couchbase MCP Server
Couchbase MCP Server, AI aracıların Couchbase Server'lardaki (ister Capella üzerinde barındırılan ister kendi yönettiğiniz) veya Operational Insights Enterprise'daki verilere bağlanıp bunlarla etkileşim kurmasını sağlayan, kendi barındırdığınız bir MCP Server'dır. Salt okunur mod ve ayrıntılı araç devre dışı bırakma seçenekleriyle güvenlik denetimleri sunarken Küme Durumu, Veri Şeması, Sorgu ve daha fazlasını içeren kategorilerde araçlar sağlar. OAuth özellikleriyle birlikte hem STDIO hem de Streamable HTTP aktarımlarını destekler.
Couchbase MCP Server, Python Package Index (PyPI) paketi olarak ve Docker aracılığıyla dağıtılır. Couchbase MCP Server için kurumsal destek, Couchbase AI Data Plane lisansı alınarak kullanılabilir; bu lisans Couchbase Agent Memory ve Couchbase Agent Catalog kullanımını ve kurumsal desteğini de kapsar.
Tam dokümantasyon: docs.couchbase.com/mcp-server
İçindekiler
- Couchbase MCP Server neden kullanılmalı
- Sunucu seçimi
- Operational Server
- Operational Insights Server
- Ortak yapılandırma
- İstemci kurulumu
- Docker
- Sorun giderme
- SSS
- Katkıda bulunma
- Kullanım verileri, LLM riskleri ve destek politikası
Couchbase MCP Server neden kullanılmalı
- Varsayılan olarak güvenli —
CB_MCP_READ_ONLY_MODE=falseayarlanmadığı sürece yazma araçları yüklenmez ve verileri değiştiren sorgular engellenir; ayrıca tek tek araçlar devre dışı bırakılabilir veya kullanıcı onayına bağlanabilir. - Couchbase Server ve Operational Insights — operational server, aynı yapılandırmayla Couchbase Capella'ya veya kendi yönettiğiniz bir Couchbase Server kümesine bağlanır; Operational Insights server ise kendi yönettiğiniz Operational Insights kümelerine bağlanır.
- RBAC farkındalığı — araç denetimleri LLM'ye yol gösterir; Couchbase kullanıcısının rol tabanlı erişim denetimi, yetkili güvenlik sınırı olmaya devam eder.
- Üretim aktarımları — yerel masaüstü istemcileri için STDIO veya isteğe bağlı OAuth 2.1 (JWKS yayımlayan tüm IdP'ler: Auth0, Okta, Keycloak, Entra, Cognito, …), sağlık kontrolleri ve paylaşımlı dağıtımlar için denetim günlüğü içeren Streamable HTTP. Operational server, daha fazla CPU çekirdeği kullanmak için birden çok worker da çalıştırabilir.
- Herhangi bir MCP istemcisi — Claude Desktop, Cursor, Windsurf, VS Code ve JetBrains AI Assistant/Junie ile test edilmiştir.
Bağlandıktan sonra şunlar gibi sorular sorabilirsiniz:
- "Hangi bucket'larım, scope'larım ve collection'larım var;
orderscollection'ının şeması nedir?" - "
status = 'active'koşulunu sağlayanusersiçindeki en yeni 10 belgeyi bul." - "Son bir saatteki en yavaş 5 sorgu hangileri ve bunlardan herhangi birinde covering index eksik mi?"
- "Bu küme sağlıklı mı ve hangi servisler çalışıyor?"
- "Bu alanlarla
productsiçine yeni bir belge ekle: …" (CB_MCP_READ_ONLY_MODE=falsegerektirir)
Sunucu seçimi
Bu paket iki MCP server içerir. Her biri kendi alt komutuyla başlatılır, farklı türde bir kümeye bağlanır ve kendine ait araçları vardır. Kümenize uygun olanı seçin, kurulum ve araçlar için ilgili bölümdeki adımları izleyin, ardından her ikisinin de paylaştığı ayarlar için Ortak yapılandırma bölümüne bakın. İkisini de kullanmak için MCP istemcinizde her birini ayrı bir server olarak kaydedin.
| Operational server | Operational Insights server | |
|---|---|---|
| Kullanım alanı | Bir Couchbase kümesi (Capella veya kendi yönettiğiniz) | Kendi yönettiğiniz bir Operational Insights kümesi (Capella'da kullanılamaz) |
| Alt komut | operational (varsayılan) | operational-insights |
| Bağlantı dizesi | couchbase:// / couchbases:// | HTTP(S) URL'si, ör. http://localhost:8095 |
| Kimlik bilgisi değişkenleri | CB_CONNECTION_STRING, CB_USERNAME, … | CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING, CB_OPERATIONAL_INSIGHTS_USERNAME, … |
| Araçlar | 52 — küme durumu, şema, KV, SQL++, indeksler, tam metin ve vektör araması, sorgu performansı | 13 — şema, SQL++ (senkron ve asenkron), indeksler, dışa aktarımlar |
| Varsayılan HTTP portu | 8000 | 8001 |
| Varsayılan günlük dosyası | mcp_server.log | mcp_server_operational_insights.log |
Alt komut bugün için operational server'da isteğe bağlıdır — yalın bir
couchbase-mcp-serveronu başlatır — ancak adını belirtmek yapılandırmanızı belirsizlikten kurtarır. Seçenekleri alt komuttan sonra yazın:couchbase-mcp-server operational --transport=http. Yüklü sürümüuvx couchbase-mcp-server --versionile kontrol edin.
Operational Server
operational server, couchbase Python SDK'sını kullanarak Capella'daki veya kendi yönettiğiniz Couchbase Server'daki bir Couchbase kümesine bağlanır.
Operational hızlı başlangıç
Çalışan bir Couchbase kümesine — Capella ücretsiz katmanı bir küme edinmenin en hızlı yoludur (örnek bir veri kümesini içe aktarabilirsiniz) — ve bir MCP istemcisine ihtiyacınız vardır. Bu yapılandırmalardan birini istemcinize ekleyin (her istemcinin yapılandırma dosyasının konumu için İstemci kurulumu bölümüne bakın). İstemcide zaten başka server'lar varsa, mevcut mcpServers nesnesine couchbase ekleyin.
PyPI'dan uvx ile (uv ve Python 3.11+ gerektirir):
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": ["couchbase-mcp-server", "operational"],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password"
}
}
}
}
Docker ile (yalnızca Docker gerektirir):
{
"mcpServers": {
"couchbase": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "CB_CONNECTION_STRING=couchbases://connection-string",
"-e", "CB_USERNAME=username",
"-e", "CB_PASSWORD=password",
"couchbase/mcp-server:latest", "operational"
]
}
}
}
Kaynak koddan
git clone https://github.com/couchbase/mcp-server-couchbase.git
{
"mcpServers": {
"couchbase": {
"command": "uv",
"args": [
"--directory", "path/to/cloned/repo/mcp-server-couchbase/",
"run", "src/mcp_server.py", "operational"
],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password"
}
}
}
}
path/to/cloned/repo/mcp-server-couchbase/, klonunuzun yoludur — sondaki eğik çizgiyi koruyun. Güncellemeleri aldıktan sonra bağımlılıkları güncellemek için uv sync komutunu çalıştırın.
Operational bağlantısı ve kimlik doğrulama
Ya kullanıcı adı ve parola ya da istemci sertifikası (mTLS) kullanın. İkisi de ayarlanmışsa sertifika kullanılır.
| Ortam değişkeni | CLI bağımsız değişkeni | Açıklama |
|---|---|---|
CB_CONNECTION_STRING | --connection-string | Kümeye ait bağlantı dizesi. Zorunlu |
CB_USERNAME / CB_PASSWORD | --username / --password | Temel kimlik doğrulama |
CB_CLIENT_CERT_PATH / CB_CLIENT_KEY_PATH | --client-cert-path / --client-key-path | mTLS kimlik doğrulaması |
CB_CA_CERT_PATH | --ca-cert-path | Kendinden imzalı/güvenilmeyen sunucu sertifikası için kök sertifika (Capella için gerekmez) |
mTLS örneği
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": ["couchbase-mcp-server", "operational"],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_CLIENT_CERT_PATH": "/path/to/client-certificate.pem",
"CB_CLIENT_KEY_PATH": "/path/to/client.key"
}
}
}
}
Operational araçları
Yalnızca okunur mod varsayılan olarak açıkken yazma araçları (✏️ ile işaretli) yüklenmez. 🖥️ ile işaretli araçlar yalnızca kendi yönettiğiniz kurulumlarda kullanılabilir — Capella'nın sunmadığı yönetici REST uç noktalarını kullanırlar veya (discover_tool_input_values) yalnızca bunu kullanan bir araç için referans verisi sunarlar — bu nedenle kendi yönettiğiniz Couchbase Server 7.6+ gerekir ve Capella bağlantılarında kaydedilmezler.
Küme kurulumu ve durumu
| Araç | Açıklama |
|---|---|
get_server_configuration_status | Kümeye bağlanmadan sunucu durumu ve yapılandırması: salt okunur mod, devre dışı bırakılmış/onay gerektiren araçlar, OAuth, günlük kaydı ve denetim sayaçları |
test_cluster_connection | Kümeye bağlanarak küme kimlik bilgilerini denetleme |
get_cluster_health_and_services | Küme durumu ve çalışan servisler; isteğe bağlı olarak service_types ile filtrelenebilir |
get_client_connectivity_report | Etkin ağ yoklaması yapmadan SDK'nın önbelleğe alınmış bağlantı tanılamaları |
get_cluster_metrics 🖥️ | Geçmiş bir zaman aralığındaki küme istatistikleri (stats-range uç noktası) |
get_cluster_tasks 🖥️ | Şu anda çalışan görevler — rebalance, compaction, XDCR, indeks oluşturma. ro_admin gerekir |
get_cluster_health_snapshot 🖥️ | Düğüm başına durum: servis topolojisi, üyelik, orchestrator ve genel durum özeti. ro_admin gerekir |
get_bucket_config 🖥️ | Bir bucket'ın (veya tüm bucket'ların) yapılandırması ve canlı durumu — kotalar, tahliye, replikalar, dayanıklılık, depolama, compaction. ro_admin gerekir |
get_cluster_system_events 🖥️ | Sistem olay günlüğü (yapılandırma değişiklikleri, failover'lar, rebalance işlemleri, yeniden başlatmalar); since_time ile zaman aralığı belirlenebilir. Full Admin veya Cluster Admin gerekir |
discover_tool_input_values 🖥️ | Diğer araçların ihtiyaç duyduğu tam girdi değerlerini arama (ör. get_cluster_metrics için tüm metrik adları). Çevrimdışı çalışır |
Veri modeli ve şema keşfi
| Araç | Açıklama |
|---|---|
get_buckets_in_cluster | Kümedeki tüm bucket'ları listeleme |
get_scopes_in_bucket | Bir bucket'taki tüm scope'ları listeleme |
get_collections_in_scope | Bir scope'taki tüm collection'ları listeleme (Query servisi gerekir) |
get_scopes_and_collections_in_bucket | Bir bucket'taki tüm scope ve collection'ları listeleme |
get_schema_for_collection | Bir collection'ın yapısını çıkarma |
create_scope ✏️ | Bir bucket'ta scope oluşturma (Server 7.6+ ve Capella) |
create_collection ✏️ | Mevcut bir scope'ta collection oluşturma (Server 7.6+ ve Capella) |
delete_scope ✏️ | Bir scope'u ve tüm collection'larını silme — kalıcıdır |
delete_collection ✏️ | Bir collection'ı ve tüm belgelerini silme — kalıcıdır |
Belge (KV) işlemleri
| Araç | Açıklama |
|---|---|
get_document_by_id | Bir belgeyi kimliğine göre alma |
lookup_subdocument | Belgenin tamamını getirmeden belirli yolları okuma, varlık denetimleri veya sayım yapma |
upsert_document_by_id ✏️ | Kimliğine göre bir belgeyi upsert etme |
insert_document_by_id ✏️ | Yeni bir belge ekleme (zaten varsa başarısız olur) |
replace_document_by_id ✏️ | Mevcut bir belgeyi değiştirme (yoksa başarısız olur) |
delete_document_by_id ✏️ | Bir belgeyi kimliğine göre silme |
mutate_subdocument ✏️ | Mevcut bir belgedeki yolları değiştirme (upsert, insert, replace, remove, dizi işlemleri, sayaçlar) |
Sorgu ve indeksleme
| Araç | Açıklama |
|---|---|
run_sql_plus_plus_query | Bir bucket ve scope kapsamında SQL++ sorgusu çalıştırma — collection adlarını doğrudan kullanın (SELECT * FROM users). Salt okunur modda verileri değiştiren ifadeler engellenir |
explain_sql_plus_plus_query | EXPLAIN planı oluşturup değerlendirme: meta veriler, çıkarılan plan ve bulgular |
get_index_advisor_recommendations | Bir SQL++ sorgusu için Index Advisor önerileri |
list_indexes | Tanımlarıyla birlikte indeksleri listeleme; bucket/scope/collection/ad ile filtrelenebilir; vektör indekslerini işaretler (is_vector, vector_type) |
get_index_stats 🖥️ | Düğüm başına indeks boyutu, parçalanma, tarama trafiği ve gecikme — baskıyı ve kullanılmayan indeksleri bulur |
create_query_index ✏️ | Skaler, Hyperscale vektör veya Composite vektör GSI indeksi oluşturma (index_type). Varsayılan olarak ertelenir — ardından build_index kullanın |
create_index ✏️ | Kullanımdan kaldırıldı — create_query_index kullanın. 2.0 sürümünde kaldırıldı |
build_index ✏️ | Bir collection'daki ertelenmiş tüm indeksleri oluşturma |
drop_index ✏️ | Bir GSI indeksini (skaler veya vektör) bırakma |
Tam metin araması (FTS)
Couchbase Server 7.6+ ve Search servisi gerekir. Hem scope düzeyindeki hem de küme düzeyindeki (eski) indeksler desteklenir: scope düzeyindeki indeksler için bucket_name ve scope_name değerlerini birlikte iletin; aksi durumda ikisini de belirtmeyin.
| Araç | Açıklama |
|---|---|
list_search_indexes | Arama dizinlerini listeler — küme düzeyinde, kova başına veya kapsam başına |
get_search_index_definition | Tek bir Arama dizininin tam tanımı (eşlemeler, analizörler, plan parametreleri) |
run_search | Ham JSON gövdesinden vektör dışı herhangi bir FTS sorgusu çalıştırır; explain=true yürütme planını döndürür |
upsert_search_index ✏️ | Vektör alanı eşlemeleri de dahil olmak üzere bir Arama dizini oluşturur veya günceller. Güncellemeler tam yeniden oluşturmayı tetikler — eşzamanlı değişikliklerin üzerine yazmamak için geçerli uuid değerini iletin |
drop_search_index ✏️ | Bir Arama dizinini siler — kalıcıdır |
Vektör araması
Her iki araç da düz sorgu metnini Embedding Providers altında yapılandırılan modelle gömer. Kendi yönettiğiniz Couchbase Server ve Capella'da kullanılabilir.
| Araç | Açıklama |
|---|---|
run_vector_query | APPROX_VECTOR_DISTANCE() aracılığıyla bir GSI vektör dizininde benzerlik araması (Server 8.0+). Dizin otomatik olarak seçilir; SQL++ where ön filtresini ve Hyperscale ayarlarını (num_probes, rerank, top_n_scan) destekler. Tam belgeleri döndürür |
run_vector_search | Adlandırılmış bir dizinde Arama hizmeti vektör araması (Server 7.6+). scalar_query bunu hibrit hâle getirir; prefilter önce adayları daraltır. Her isabet için dizinde saklanan alanları döndürür |
Sorgu performansı analizi
| Araç | Açıklama |
|---|---|
get_longest_running_queries | Ortalama hizmet süresine göre en uzun süren sorgular |
get_most_frequent_queries | En sık yürütülen sorgular |
get_queries_with_largest_response_sizes | Yanıt boyutları en büyük olan sorgular |
get_queries_with_large_result_count | Sonuç sayıları en yüksek olan sorgular |
get_queries_using_primary_index | Birincil dizin kullanan sorgular |
get_queries_not_using_covering_index | Kapsayıcı dizin kullanmayan sorgular |
get_queries_not_selective | Taramaları — ikincil dizin, birincil dizin veya sıralı tarama — nihai sonuçtan çok daha fazla belge döndüren sorgular |
Sorgu hizmeti durumu 🖥️
Bunlar, her sorgu düğümünde Sorgu hizmetinin kendi yönetici REST API'sini çağırır.
| Araç | Açıklama |
|---|---|
get_cluster_query_vitals | Sorgu motoru durumu: istek hızı, etkin/kuyruktaki istekler, bellek, GC, çalışma süresi. ro_admin gerekir |
get_active_queries | Şu anda tüm sorgu düğümlerinde yürütülen sorgular. ro_admin gerekir |
delete_active_query ✏️ | Devam eden bir sorguyu istek kimliğine göre iptal eder. Tam Yönetici veya Küme Yöneticisi gerekir |
Capella'da otomatik olarak devre dışı bırakılan araçlar
🖥️ araçları, Capella'nın kullanıma açmadığı yönetici REST uç noktaları üzerinden Couchbase'e erişir (tek istisna olan discover_tool_input_values, yalnızca bu uç noktalara ihtiyaç duyan bir araca hizmet verdiği için kullanıma sunulmaz). CB_CONNECTION_STRING içindeki her ana makine .cloud.couchbase.com ile bitiyorsa sunucu bu araçları kaydetmez ve bunları kendi devre dışı araçlarınız ile birlikte get_server_configuration_status içinde ve başlangıç günlüğünde bildirir. get_cluster_health_and_services ve get_client_connectivity_report gibi SDK tabanlı araçlar kullanılabilir durumda kalır.
| Araç | Gereken uç nokta |
|---|---|
get_cluster_metrics | Yönetim REST'i (/pools/default/stats/range) |
get_cluster_tasks | Yönetim REST'i (/pools/default/tasks) |
get_bucket_config | Yönetim REST'i (/pools/default/buckets[/<name>]) |
get_cluster_health_snapshot | Yönetim REST'i ve düğüm başına uç noktalar |
get_cluster_system_events | Yönetim REST'i (/events) |
get_index_stats | Dizin Hizmeti REST'i (her dizinleyicinin /api/v1/stats değeri) |
get_cluster_query_vitals | Sorgu hizmeti REST'i (/admin/vitals) |
get_active_queries | Sorgu hizmeti REST'i (/admin/active_requests) |
delete_active_query | Sorgu hizmeti REST'i (DELETE /admin/active_requests/{id}) |
discover_tool_input_values | Yok (çevrimdışı çalışır), ancak yalnızca Capella'da bulunmayan get_cluster_metrics aracına hizmet eder |
Embedding Providers
run_vector_query ve run_vector_search, sorgu metnini CB_MCP_EMBEDDING_MODEL_PROVIDER içinde ayarlanan sağlayıcıyla gömer. Bu isteğe bağlıdır: ayarlanmadan sunucu normal şekilde başlar ve her iki araç da kayıtlı kalır; ancak çağrıldıklarında neyin ayarlanması gerektiğini açıklayan bir hata döndürürler.
CB_MCP_EMBEDDING_MODEL_PROVIDER | Gerekli | İsteğe bağlı | Notlar |
|---|---|---|---|
capella | CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL, CB_MCP_EMBEDDING_MODEL_ENDPOINT | — | Capella Model Service. CB_MCP_EMBEDDING_MODEL_ENDPOINT, Capella'nın AI Data Plane > Models bölümündeki dağıtımınıza özel URL'dir (ör. https://<id>.ai.couchbase.com) |
openai | CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL | CB_MCP_EMBEDDING_MODEL_ENDPOINT | OpenAI uyumlu yerel bir sunucu (Ollama, vLLM, LM Studio) kullanmak için uç noktayı ayarlayın |
cohere | CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL | CB_MCP_EMBEDDING_MODEL_ENDPOINT | |
voyage | CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL | CB_MCP_EMBEDDING_MODEL_ENDPOINT | |
bedrock | CB_MCP_EMBEDDING_MODEL | CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY, CB_MCP_EMBEDDING_MODEL_AWS_REGION | Amazon Titan gömme modelleri (ör. amazon.titan-embed-text-v2:0) — sağlayıcı, Titan'ın inputText istek biçimini gönderir; bu nedenle Cohere Embed gibi diğer Bedrock gömme modelleri henüz desteklenmemektedir. Varsayılan AWS zincirini kullanmak için kimlik bilgilerini belirtmeyin. Ek gereksinim: pip install couchbase-mcp-server[bedrock-embeddings] |
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password",
"CB_MCP_EMBEDDING_MODEL_PROVIDER": "openai",
"CB_MCP_EMBEDDING_MODEL": "text-embedding-3-small",
"CB_MCP_EMBEDDING_MODEL_API_KEY": "sk-..."
}
Tüm Seçenekler
operational server
için tüm ortam değişkenleri ve CLI bayrakları
Operational Insights server, kendi bağlantı ayarları ve CB_MCP_EMBEDDING_MODEL_* seçeneklerinin olmaması dışında aynı seçenekleri kabul eder.
| Ortam Değişkeni | CLI Argümanı | Açıklama | Varsayılan |
|---|---|---|---|
CB_CONNECTION_STRING | --connection-string | Couchbase kümesine bağlantı dizesi | Gerekli |
CB_USERNAME | --username | Temel kimlik doğrulama için gerekli bucket'lara erişimi olan kullanıcı adı | Gerekli (veya mTLS için İstemci Sertifikası ve Anahtarı gerekir) |
CB_PASSWORD | --password | Temel kimlik doğrulama parolası | Gerekli (veya mTLS için İstemci Sertifikası ve Anahtarı gerekir) |
CB_CLIENT_CERT_PATH | --client-cert-path | mTLS kimlik doğrulaması için istemci sertifika dosyasının yolu | mTLS kullanılıyorsa gerekli (veya Kullanıcı Adı ve Parola gerekir) |
CB_CLIENT_KEY_PATH | --client-key-path | mTLS kimlik doğrulaması için istemci anahtar dosyasının yolu | mTLS kullanılıyorsa gerekli (veya Kullanıcı Adı ve Parola gerekir) |
CB_CA_CERT_PATH | --ca-cert-path | Sunucu kendinden imzalı/güvenilmeyen bir sertifikayla yapılandırılmışsa TLS için sunucu kök sertifikasının yolu. Capella'ya bağlanırken bu gerekli değildir | |
CB_MCP_READ_ONLY_MODE | --read-only-mode | Tüm veri değişikliklerini engeller (KV, Query, kapsam/koleksiyon yönetimi, dizin yönetimi ve FTS dizin yönetimi). Etkinleştirildiğinde yazma araçları yüklenmez. | true |
CB_MCP_TRANSPORT | --transport | Taşıma modu: stdio, http | stdio |
CB_MCP_HOST | --host | HTTP taşıma modu için ana makine | 127.0.0.1 |
CB_MCP_PORT | --port | HTTP taşıma modu için bağlantı noktası | 8000 |
CB_MCP_WORKERS | --workers | http taşıması için sunucu çalışan süreçlerinin sayısı. 1'den büyük değerler durum bilgisiz HTTP modunda çalışır (Birden Çok Çalışan bölümüne bakın) | 1 |
CB_MCP_STATELESS_HTTP | --stateless-http | Her HTTP isteğini oturum başına durum olmadan işler. Yalnızca http ile dikkate alınır; onay gerektiren araçlarla birlikte kullanılamaz (Birden Çok Çalışan bölümüne bakın) | çalışan sayısı > 1 olduğunda true, aksi takdirde false |
CB_MCP_DISABLED_TOOLS | --disabled-tools | Devre dışı bırakılacak araçlar (Araçları Devre Dışı Bırakma bölümüne bakın) | Yok |
CB_MCP_CONFIRMATION_REQUIRED_TOOLS | --confirmation-required-tools | MCP istemi aracılığıyla yürütülmeden önce açık kullanıcı onayı gerektiren araçlar (Onay Gerektirme bölümüne bakın) | Yok |
CB_MCP_LOG_LEVEL | --log-level | MCP sunucusunun günlük kaydı düzeyi: off, debug, info, warning, error (Günlük Kaydı bölümüne bakın) | info |
CB_MCP_LOG_SINKS | --log-sinks | Virgülle ayrılmış günlük hedefleri: stderr, file veya her ikisi (Günlük Kaydı bölümüne bakın) | stderr |
CB_MCP_LOG_FILE | --log-file | Düzey başına günlük dosyaları için temel yol (yalnızca file hedefi etkinleştirildiğinde kullanılır) | mcp_server.log |
CB_MCP_LOG_ROTATION_MAX_SIZE_MB | --log-rotation-max-size-mb | Her düzey tarafından devralınan ve üzerine yazılmadığı sürece günlük dosyası döndürülmeden önce dosya başına uygulanacak genel maksimum boyut MB cinsinden. 0 — veya negatif, nan ya da inf gibi kullanılamayan bir değer — geçersizdir ve başlangıç uyarısıyla varsayılan değere döner | 1 (1 MB) |
CB_MCP_LOG_MAX_BYTES | --log-max-bytes | Kullanımdan kaldırıldı — CB_MCP_LOG_ROTATION_MAX_SIZE_MB (MB) kullanın. Geriye dönük uyumluluk için hâlâ dikkate alınan genel döndürme boyutu bayt cinsinden; CB_MCP_LOG_ROTATION_MAX_SIZE_MB de ayarlanmışsa yok sayılır | Ayarlanmamış |
CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB | --log-error-rotation-max-size-mb | ERROR günlük dosyası için döndürme boyutu MB cinsinden; ERROR için CB_MCP_LOG_ROTATION_MAX_SIZE_MB değerini geçersiz kılar | CB_MCP_LOG_ROTATION_MAX_SIZE_MB değerini devralır |
CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB | --log-warning-rotation-max-size-mb | WARNING günlük dosyası için döndürme boyutu MB cinsinden; WARNING için CB_MCP_LOG_ROTATION_MAX_SIZE_MB değerini geçersiz kılar | CB_MCP_LOG_ROTATION_MAX_SIZE_MB değerini devralır |
CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB | --log-info-rotation-max-size-mb | INFO günlük dosyası için döndürme boyutu MB cinsinden; INFO için CB_MCP_LOG_ROTATION_MAX_SIZE_MB değerini geçersiz kılar | CB_MCP_LOG_ROTATION_MAX_SIZE_MB değerini devralır |
CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB | --log-debug-rotation-max-size-mb | DEBUG günlük dosyası için döndürme boyutu MB cinsinden; DEBUG için CB_MCP_LOG_ROTATION_MAX_SIZE_MB değerini geçersiz kılar | CB_MCP_LOG_ROTATION_MAX_SIZE_MB değerini devralır |
CB_MCP_LOG_RETENTION_BACKUP_COUNT | --log-retention-backup-count | Düzey başına günlük dosyası için tutulan döndürülmüş yedek dosyalar (etkin dosya hariç); üzerine yazılmadığı sürece tüm düzeylere uygulanır. 0 yalnızca etkin dosyayı tutar (Günlük Kaydı bölümüne bakın) | 1 |
CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT | --log-error-retention-backup-count | ERROR günlük dosyası için tutulan döndürülmüş yedekler; ERROR için genel sayıyı geçersiz kılar | CB_MCP_LOG_RETENTION_BACKUP_COUNT değerini devralır |
CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT | --log-warning-retention-backup-count | WARNING günlük dosyası için tutulan döndürülmüş yedekler; WARNING için genel sayıyı geçersiz kılar | CB_MCP_LOG_RETENTION_BACKUP_COUNT değerini devralır |
CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT | --log-info-retention-backup-count | INFO günlük dosyası için tutulan döndürülmüş yedekler; INFO için genel sayıyı geçersiz kılar | CB_MCP_LOG_RETENTION_BACKUP_COUNT değerini devralır |
CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT | --log-debug-retention-backup-count | DEBUG günlük dosyası için tutulan döndürülmüş yedekler; DEBUG için genel sayıyı geçersiz kılar | CB_MCP_LOG_RETENTION_BACKUP_COUNT değerini devralır |
CB_MCP_OAUTH_JWT_JWKS_URI | --oauth-jwks-uri | Taşıyıcı JWT'leri doğrulamak için kullanılan kimlik sağlayıcısının JWKS uç noktası. Veren ve hedef kitleyle birlikte ayarlandığında OAuth'u etkinleştirir (OAuth 2.1 Yetkilendirmesi bölümüne bakın) | Yok |
CB_MCP_OAUTH_JWT_ISSUER | --oauth-issuer | Beklenen JWT iss claim'i. OAuth'u etkinleştirmek için gereklidir | Yok |
CB_MCP_OAUTH_JWT_AUDIENCE | --oauth-audience | Beklenen JWT aud claim'i. OAuth'u etkinleştirmek için gereklidir | Yok |
CB_MCP_OAUTH_JWT_ALGORITHM | --oauth-algorithm | JWT imzalama algoritması: RS256/384/512, ES256/384/512, PS256/384/512 seçeneklerinden biri | RS256 |
CB_MCP_OAUTH_MCP_BASE_URL | --oauth-mcp-base-url | Bu sunucunun genel temel URL'si. Ayarlandığında, PRM uyumlu istemcilerin kimlik sağlayıcısını keşfedebilmesi için RFC 9728 Korumalı Kaynak Meta Verilerini yayımlar | Yok |
CB_MCP_OAUTH_SCOPE_READ_LABEL | --oauth-scope-read-label | 'read' erişimi olarak değerlendirilen OAuth kapsam etiketini geçersiz kılar (PRM'de duyurulur ve belirtecin scope/scp claim'iyle eşleştirilir). Kimlik sağlayıcınız standart biçimi üretemiyorsa kullanın | couchbase-mcp:read |
CB_MCP_OAUTH_SCOPE_WRITE_LABEL | --oauth-scope-write-label | 'write' erişimi olarak değerlendirilen OAuth kapsam etiketini geçersiz kılar; okuma etiketiyle aynı anlamı taşır | couchbase-mcp:write |
CB_MCP_AUDIT_LOG_ENABLED | --audit-log-enabled | Denetim günlüğünü etkinleştirir — CB_MCP_LOG_* operasyonel günlüklerinden ayrı, kararlı bir şemaya ve kendi saklama politikasına sahip bir hedef (Denetim bölümüne bakın) | false |
CB_MCP_AUDIT_LOG_SINKS | --audit-log-sinks | Virgülle ayrılmış denetim hedefleri: console, file veya her ikisi. console, stderr'e yazar — stdio üzerinde JSON-RPC protokolünü taşıyan stdout'a asla yazmaz | console |
CB_MCP_AUDIT_LOG_FILE_PATH | --audit-log-file-path | Denetim günlük dosyasının yolu. file hedefler arasındaysa gereklidir; ana makine adı ve süreç kimliği uzantıdan önce eklenir (audit.log → audit.<host>.<pid>.log) | Yok |
CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB | --audit-log-rotation-max-size-mb | Etkin denetim dosyası döndürülmeden önce ulaşabileceği maksimum boyut MB cinsinden. 0, boyuta dayalı döndürmeyi kapatır | 10 (10 MB) |
CB_MCP_AUDIT_LOG_ROTATION_INTERVAL | --audit-log-rotation-interval | Etkin denetim dosyasının döndürülmeden önce ulaşabileceği yaş; birimin d (24 saat) veya w (7 gün) olduğu <value><unit> biçiminde — ör. 1d, 30d, 8w. 0, aralığa dayalı döndürmeyi kapatır | 1d |
CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS | --audit-log-retention-max-backups | Her denetim dosyası başına tutulan döndürülmüş yedekler; etkin dosya hariçtir. Yedekler gzip ile sıkıştırılır. 0 hiçbir yedek tutmaz. Bu, tek bir dosyanın boyutunu sınırlar; dizinin tamamını değil — Denetim bölümüne bakın | 10 |
CB_MCP_AUDIT_LOG_TOOL_ARGS | --audit-log-tool-args | Araç bağımsız değişkeni değerlerini denetim günlüğüne kaydeder. Varsayılan olarak kapalıdır — bu sürümde hassas veri ayıklama yoktur; dolayısıyla etkinleştirilmesi, tam belge gövdeleri dahil bağımsız değişkenleri olduğu gibi yazar | false |
CB_MCP_AUDIT_LOG_DISABLED_EVENTS | --audit-log-disabled-events | Bastırılacak denetim olayları: virgülle ayrılmış sayısal olay kimlikleri (ör. 61490,61492) veya her satırda bir kimlik bulunan bir dosya. Yalnızca filtrelenebilir olaylar bastırılabilir | Yok |
CB_MCP_EMBEDDING_MODEL_PROVIDER | --embedding-model-provider | run_vector_query / run_vector_search için gömme sağlayıcısı: capella, openai, cohere, voyage, bedrock seçeneklerinden biri. Ayarlanmaması, yapılandırılana kadar her iki aracın da gömme adımını devre dışı bırakır — Gömme Sağlayıcısı Yapılandırması bölümüne bakın | Yok |
CB_MCP_EMBEDDING_MODEL | --embedding-model | Yapılandırılmış gömme sağlayıcısının model adı/kimliği | Yok |
CB_MCP_EMBEDDING_MODEL_API_KEY | --embedding-model-api-key | Yapılandırılmış sağlayıcının API anahtarı. bedrock tarafından kullanılmaz (bunun yerine AWS kimlik bilgisi zincirini / CB_MCP_EMBEDDING_MODEL_AWS_* kullanır) | Yok |
CB_MCP_EMBEDDING_MODEL_ENDPOINT | --embedding-model-endpoint | Temel URL geçersiz kılması (OpenAI uyumlu yerel sunucu veya Capella Model Service dağıtımının kendi URL'si — CB_MCP_EMBEDDING_MODEL_PROVIDER=capella olduğunda gerekli) | Yok |
CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID | --embedding-model-aws-access-key-id | AWS erişim anahtarı kimliği; yalnızca bedrock sağlayıcısı için. Varsayılan AWS kimlik bilgisi zincirini kullanmak için belirtmeyin | Yok |
CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY | --embedding-model-aws-secret-access-key | AWS gizli erişim anahtarı; yalnızca bedrock sağlayıcısı için | Yok |
CB_MCP_EMBEDDING_MODEL_AWS_REGION | --embedding-model-aws-region | AWS bölgesi; yalnızca bedrock sağlayıcısı için. Ayarlanmamışsa AWS SDK'nın kendi bölge çözümlemesine geri döner | Yok |
Operational Insights Sunucusu
operational-insights sunucusu, kendi yönettiğiniz Operational Insights kümelerine bağlanır. Operational Insights, gerçek zamanlı uygulamalar ve operasyonel zekâ için gerçek zamanlı bir analitik veritabanıdır (RT-OLAP). Sunucu Capella için kullanılamaz. couchbase-operational-insights SDK'sını kullanır. Operasyonel sunucudan ayrı, kendi süreci olarak çalışır.
[!IMPORTANT]
CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING, bircouchbase://bağlantı dizesi değil, HTTP(S) URL'sidir — ör.http://localhost:8095veya TLS üzerindenhttps://<host>:18095. Bu, en sık karşılaşılan yanlış yapılandırmadır.
Operational Insights Hızlı Başlangıç
PyPI'dan uvx ile:
{
"mcpServers": {
"couchbase-operational-insights": {
"command": "uvx",
"args": ["couchbase-mcp-server", "operational-insights"],
"env": {
"CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING": "http://localhost:8095",
"CB_OPERATIONAL_INSIGHTS_USERNAME": "Administrator",
"CB_OPERATIONAL_INSIGHTS_PASSWORD": "password"
}
}
}
}
Docker ile:
{
"mcpServers": {
"couchbase-operational-insights": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING=http://host.docker.internal:8095",
"-e", "CB_OPERATIONAL_INSIGHTS_USERNAME=Administrator",
"-e", "CB_OPERATIONAL_INSIGHTS_PASSWORD=password",
"couchbase/mcp-server:latest", "operational-insights"
]
}
}
}
Kaynak koddan çalıştırmak için, son bağımsız değişken olarak operational-insights ve yukarıdaki değişkenleri kullanarak operasyonel kaynak yapılandırmasını kullanın.
Operational Insights Bağlantısı ve Kimlik Doğrulaması
| Ortam Değişkeni | CLI Argümanı | Açıklama |
|---|---|---|
CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING | --connection-string | Uç nokta URL'si (HTTP/HTTPS). Zorunlu |
CB_OPERATIONAL_INSIGHTS_USERNAME | --username | Kullanıcı adı |
CB_OPERATIONAL_INSIGHTS_PASSWORD | --password | Parola |
CB_OPERATIONAL_INSIGHTS_CA_CERT_PATH | --ca-cert-path | Kendinden imzalı/güvenilmeyen sunucu sertifikası için kök sertifika (PEM) |
CB_OPERATIONAL_INSIGHTS_CLIENT_CERT_PATH | --client-cert-path | mTLS için istemci sertifikası — PEM (anahtarla birlikte) veya PKCS#12 paketi (.p12/.pfx, anahtar yok). Bir https:// URL'si gerektirir; kullanıcı adı/parolayı geçersiz kılar |
CB_OPERATIONAL_INSIGHTS_CLIENT_KEY_PATH | --client-key-path | İstemci sertifikası için özel anahtar (PEM). PKCS#12 için ayarlamayın |
CB_OPERATIONAL_INSIGHTS_CLIENT_CERT_PASSWORD | --client-cert-password | Şifrelenmiş anahtarın veya PKCS#12 paketinin parolası |
CB_MCP_OPERATIONAL_INSIGHTS_QUERY_RESULT_MAX_SIZE | --operational-insights-query-result-max-size | Maksimum sorgu sonucu boyutu bayt cinsinden. Ayarlanmaması sınır olmadığı anlamına gelir. Ayarlandığında okuma bütçe sınırında durur ve yanıt truncated: true bildirir; sınırı aşacak bir satır döndürülmez. 4 MiB (4194304) üzerindeki değerler 4 MiB'ye düşürülür ve başlangıçta stderr'e bir uyarı yazılır |
CB_MCP_OPERATIONAL_INSIGHTS_ASYNC_QUERY_RESULT_TIMEOUT | --operational-insights-async-query-result-timeout | Her eşzamansız sorgu isteği için saniye cinsinden zaman aşımı: sorguyu başlatma, durumunu kontrol etme, sonuçları getirme, sonuçları atma ve iptal etme. Getirme işlemi için tüm indirme süresini kapsar; bu nedenle okunması bundan uzun süren bir sonuç başarısız olur. Büyük sonuçlar veya yavaş bağlantılar için artırın. Pozitif tam sayı, varsayılan 30, maksimum 600. Daha büyük değerler 600 değerine düşürülür ve uyarı verilir; diğer geçersiz değerler uyarı olarak günlüğe kaydedilir ve 30 kullanılır |
Tüm ortak yapılandırma ayarları geçerlidir; operasyonel sunucudan farkları şunlardır:
- Varsayılan bağlantı noktası
8001, varsayılan günlük dosyası isemcp_server_operational_insights.logolduğundan iki sunucu yan yana çalışabilir. - Eşzamansız sorgu tanıtıcıları işlem belleğinde bulunduğundan yalnızca bir çalışan desteklenir (
CB_MCP_WORKERS=1). CB_MCP_EMBEDDING_MODEL_*seçenekleri yoktur.
Operational Insights Araçları
get_server_configuration_status dışındaki tüm adların başına operational_insights_ eklenir; böylece iki sunucu çakışma olmadan tek bir istemciye kaydedilebilir. Yazma aracı (✏️ ile işaretli), varsayılan olarak açık olan salt okunur mod etkinken yüklenmez.
Sunucu Durumu
| Araç | Açıklama |
|---|---|
get_server_configuration_status | Operasyonel sunucudakiyle aynı araç |
Veri Modeli ve Şema Keşfi
| Araç | Açıklama |
|---|---|
operational_insights_get_databases_in_cluster | Veritabanlarını listele |
operational_insights_get_scopes_in_database | Bir veritabanındaki kapsamları listele |
operational_insights_get_collections_in_scope | Bir kapsamdaki koleksiyonları (veri kümelerini) listele |
operational_insights_get_schema_for_collection | Örnekleme yoluyla bir koleksiyonun JSON şemasını çıkar |
Sorgu ve Dizin
| Araç | Açıklama |
|---|---|
operational_insights_list_indexes | System.Metadata.Index içindeki ikincil dizinleri listele |
operational_insights_explain_query | Bir SQL++ ifadesini çalıştırmadan EXPLAIN et |
operational_insights_run_query_sync | SQL++ çalıştır ve sonuç boyutu sınırına kadar satırları döndür; bunun yerine dışa aktarabilir. Salt okunur mod sunucu tarafında uygulanır |
operational_insights_run_query_async | Uzun süren bir sorguyu başlat ve satırları beklemeden bir query_handle döndür; büyük dışa aktarımlar için de tercih edilir. Salt okunur mod sunucu tarafında uygulanır |
operational_insights_get_async_query_results | Eşzamansız bir sorguyu yokla; hazır olduğunda satırları (veya dışa aktarma hedefini) döndürür |
operational_insights_discard_async_query_results | Tamamlanmış bir eşzamansız sorgunun sonuçlarını serbest bırak |
operational_insights_cancel_async_query | Hâlâ çalışan bir eşzamansız sorguyu durdur (salt okunur modda izin verilir) |
operational_insights_create_index ✏️ | CREATE INDEX aracılığıyla ikincil dizin oluştur |
Eşzamansız sorgular başlat → yokla → sonuçları at veya iptal et akışını izler: operational_insights_run_query_async bir query_handle döndürür, operational_insights_get_async_query_results hazır olana kadar yoklanır, ardından operational_insights_discard_async_query_results sonuçları serbest bırakır veya operational_insights_cancel_async_query hâlâ çalışan bir sorguyu durdurur.
Büyük sonuçları dışa aktarma
Satırları döndürmek yerine operational_insights_run_query_sync ve operational_insights_run_query_async, ifadeyi COPY ... TO içine alıp satırları harici nesne depolama alanına yazabilir. copy_to_link ( CREATE LINK ... TYPE S3 ile oluşturulmuş mevcut bir bağlantı), copy_to_bucket ve copy_to_path değerlerinin üçünü de, ayrıca isteğe bağlı olarak copy_to_format değerini (json varsayılanı veya parquet) iletin. Araç daha sonra satır içermeyen bir onay döndürür:
{
"success": true,
"exported": true,
"destination": {"link": "s3Link", "bucket": "my-exports", "path": "exports/run1", "format": "json"},
"message": "Results were written to my-exports/exports/run1 as json. ..."
}
- Kısmi bir hedef reddedilir; sessizce satır döndürülmez.
- Eşzamanlı araç yüklemenin tamamlanmasını bekler; büyük dışa aktarımlar için eşzamansız aracı tercih edin.
- Dışa aktarımlar harici depolama alanına yazdığından salt okunur modda engellenir; bu nedenle
CB_MCP_READ_ONLY_MODE=falseveyacouchbase-mcp:writeiznine sahip bir belirteç gerekir. csvsunulmaz; çünkü rastgele birSELECTüzerinden çıkarılamayan açık bir çıktı şeması gerektirir.
Ortak Yapılandırma
Bu ayarlar her iki sunucuda da aynı şekilde çalışır. Her seçenek ortam değişkeni olarak veya alt komuttan sonra CLI bayrağı olarak ayarlanabilir.
Güvenlik Denetimleri
Şu güvenlik ilkelerini izleyin:
- Veritabanı kullanıcısına en az ayrıcalığı verin — yetkili sınır RBAC'dir (aşağıya bakın).
- Aracıya yalnızca ihtiyaç duyduğu araçları sağlayın, geri kalanını devre dışı bırakın — yüklenen her araç LLM'nin çağırabileceği bir araçtır. Araç listesini en aza indirmek için salt okunur modu ve
CB_MCP_DISABLED_TOOLSkullanın. - Sakladığınız hassas araçlar için onay isteyin — bkz. Onay isteme.
Aşağıdaki denetimler en geniş kapsamlıdan en dar kapsamlıya doğru üç katman oluşturur. Bunları birlikte kullanın; ancak hiçbirinin RBAC'nin yerini tutmadığını unutmayın.
[!IMPORTANT] Veritabanı kullanıcısının RBAC izinleri, yetkili güvenlik denetimidir. Örneğin,
upsert_document_by_idvedelete_document_by_idaraçlarını devre dışı bırakmak,run_sql_plus_plus_queryaracınınINSERT/UPDATE/DELETE/MERGEçalıştırmasını engellemez — bunu yalnızca salt okunur mod veya eksik RBAC izinleri sağlar. Sunucunun veritabanı kullanıcısına yalnızca ihtiyaç duyduğu izinleri verin.
Salt okunur mod
CB_MCP_READ_ONLY_MODE (varsayılan true), yazma işlemleri için tek anahtardır:
true— her sunucunun araç listesinde ✏️ ile işaretli yazma araçları yüklenmez ve verileri veya yapıyı değiştiren sorgular engellenir.false— yazma araçları yüklenir ve değişiklik yapan sorgulara izin verilir.
Araçları devre dışı bırakma
CB_MCP_DISABLED_TOOLS, araçları keşif listesinden tamamen kaldırır. Virgülle ayrılmış bir listeyi veya her satırda bir araç adı bulunan bir dosyanın yolunu kabul eder (# yorum başlatır):
CB_MCP_DISABLED_TOOLS="upsert_document_by_id,delete_document_by_id"
# or
CB_MCP_DISABLED_TOOLS=/path/to/disabled_tools.txt
# disabled_tools.txt
# Write operations
upsert_document_by_id
delete_document_by_id
# Index advisor
get_index_advisor_recommendations
Capella'da operasyonel sunucu ayrıca bazı yönetici araçlarını otomatik olarak devre dışı bırakır.
Onay isteme (elicitation)
CB_MCP_CONFIRMATION_REQUIRED_TOOLS, listelenen bir araç çalıştırılmadan önce MCP elicitation kullanarak kullanıcıdan onay ister. Devre dışı bırakılan araçlarla aynı virgülle ayrılmış liste veya dosya biçimlerini kabul eder:
CB_MCP_CONFIRMATION_REQUIRED_TOOLS="delete_document_by_id,replace_document_by_id"
- İstemci elicitation'ı destekliyorsa araç çalıştırılmadan önce kullanıcıdan onay istenir.
- Desteklemiyorsa geriye dönük uyumluluk için araç onay alınmadan çalıştırılır.
- Onay için bir MCP oturumu gerekir; bu nedenle durumsuz HTTP ile (
CB_MCP_STATELESS_HTTP=trueveya 1'den büyükCB_MCP_WORKERS) birlikte kullanılamaz. Sunucu bu birleşimle başlatılmayı reddeder. Yük dengeleyici arkasında onay için yapışkan oturumlar gerekir — bkz. Yük dengeleyiciler.
Aktarımlar
| Aktarım | Kullanım amacı | Uç nokta |
|---|---|---|
stdio (varsayılan) | Sunucuyu alt süreç olarak başlatan tek bir yerel istemci | — |
http | Tek bir sunucuyu paylaşan birden çok istemci; OAuth'u, sağlık kontrollerini ve operasyonel sunucudaki çalışanları destekler | http://<host>:<port>/mcp |
Aktarımı CB_MCP_TRANSPORT ile, bağlama adresini CB_MCP_HOST ile (varsayılan 127.0.0.1) ve bağlantı noktasını CB_MCP_PORT ile ayarlayın (ayarlanmadığında her sunucunun varsayılan bağlantı noktası kullanılır). OAuth olmadan HTTP uç noktası kimlik doğrulamasızdır.
uvx couchbase-mcp-server operational \
--connection-string='<couchbase_connection_string>' \
--username='<database_username>' \
--password='<database_password>' \
--transport=http
Ardından istemcinizi URL'ye yönlendirin:
{
"mcpServers": {
"couchbase-http": {
"url": "http://localhost:8000/mcp"
}
}
}
Birden çok çalışan
Tek bir işlem en fazla yaklaşık bir CPU çekirdeği kullanır. --workers N (CB_MCP_WORKERS), N işlemi aynı ana bilgisayar ve bağlantı noktası arkasında çalıştırır; kullanılabilir çekirdek sayısı iyi bir başlangıç noktasıdır. Çalışanlar yalnızca operasyonel sunucuda desteklenir. Birden fazla çalışanla:
httpaktarımı gereklidir ve istemcinin istekleri farklı çalışanlara ulaşabileceğinden sunucu durumsuz HTTP modunda çalışır. Örneğin, yapışkan oturumlar olmayan bir yük dengeleyicinin arkasında tek çalışan kullanırken--stateless-http=trueayarını da yapabilirsiniz.- Onay gerektiren araçlar kullanılamaz.
- Her işlem, ana bilgisayar ve işlem kimliğiyle adlandırılmış kendi günlük dosyalarını yazar (
mcp_server.<host>.<pid>.info.log) — denetleyici için bir küme ve her çalışan için bir küme.
Yük dengeleyiciler
Bir yük dengeleyicinin arkasında birden çok sunucu örneği çalıştırabilirsiniz. Her örnek MCP oturumlarını kendi belleğinde tuttuğundan, yük dengeleyici ayarı hangi davranışların mümkün olduğunu belirler:
| Yük dengeleyici | Sunucu ayarı | Onay gerektiren araçlar |
|---|---|---|
Mcp-Session-Id istek başlığına göre yönlendirilen yapışkan oturumlar | Tek çalışan, durum bilgili (varsayılan) | Desteklenir |
| Yapışkan oturum yok | --stateless-http=true | Desteklenmez — yapılandırılmışlarsa sunucu başlatmayı reddeder |
- Yapışkan oturumlar olmadan, durum bilgili bir örnek oturumu başka bir örnekte oluşturulmuş her isteği reddeder. Bu durumda durumsuz modu kullanın.
- Çerezlere değil,
Mcp-Session-Idbaşlığına göre yönlendirin. Birçok MCP istemcisi çerezleri saklamaz. - Bir örnek yeniden başlatılırsa veya yük devretme gerçekleşirse oturumları ve bekleyen onay istemleri kaybolur. İstemcinin yeni bir oturum başlatması gerekir.
- Operational Insights eşzamansız sorguları, durumsuz modda bile
query_handledeğerlerini sorguyu başlatan örneğin belleğinde tutar. Sorguyu başka bir örnekte yoklamak, sonuçlarını atmak veya iptal etmekUnknown query_handledöndürür. Bu araçları tek bir örnekle veya tüm çağrıların sorguyu başlatan örneğe ulaşmasını sağlayan yapışkan oturumlarla kullanın. Durumsuz modMcp-Session-Idgöndermez; bu nedenle istemci IP adresi gibi başka bir yakınlık anahtarı gerekir.
Sağlık kontrolü
HTTP modunda GET /health, MCP bağlantı noktasında {"status": "ok", "server": "<server>"} döndürür. Bu bir canlılık kontrolüdür: kümeye bağlanmaz (dolayısıyla küme kesintisi sağlıklı kapsayıcıların yeniden başlatılmasına neden olmaz), OAuth etkin olsa bile kimlik doğrulaması gerektirmez ve her çalışan tarafından sunulur. Yoklama örnekleri için bkz. Docker.
OAuth 2.1 Yetkilendirmesi
--transport=http ile her iki sunucu da kimlik sağlayıcınızın JWKS'sine göre bearer JWT'lerini doğrulayan bir OAuth 2.1 kaynak sunucusu olarak çalışabilir. JWKS yayımlayan tüm OAuth 2.1/OIDC sağlayıcılarıyla çalışır; belirteç vermez veya kullanıcıları yönetmez. OAuth ayarları stdio üzerinde yok sayılır.
- OAuth yalnızca
CB_MCP_OAUTH_JWT_JWKS_URI,CB_MCP_OAUTH_JWT_ISSUERveCB_MCP_OAUTH_JWT_AUDIENCEdeğerlerinin üçü de ayarlandığında etkinleşir; yalnızca bazılarının ayarlanması başlangıçta hataya neden olur. CB_MCP_OAUTH_MCP_BASE_URLayrıca istemcilerin yetkilendirme sunucusunu keşfedebilmesi için RFC 9728 Korumalı Kaynak Meta Verilerini yayımlar.- Erişim, belirtecin
scope/scptalebindeki iki kapsamla denetlenir:couchbase-mcp:read(okuma araçları) vecouchbase-mcp:write(yazma araçları). Tam erişim için ikisi de gerekir. Kimlik sağlayıcınız bu etiketleri yayımlayamıyorsaCB_MCP_OAUTH_SCOPE_READ_LABEL/CB_MCP_OAUTH_SCOPE_WRITE_LABELile yeniden adlandırın. Her iki sunucu da aynı etiketleri kullanır; dolayısıyla tek bir kimlik sağlayıcı yapılandırması ikisini de kapsar.
uvx couchbase-mcp-server operational \
--connection-string='<couchbase_connection_string>' \
--username='<database_username>' \
--password='<database_password>' \
--transport=http \
--oauth-jwks-uri='https://auth.example.com/.well-known/jwks.json' \
--oauth-issuer='https://auth.example.com/' \
--oauth-audience='couchbase-mcp-server' \
--oauth-mcp-base-url='<public_base_url_of_this_server>'
Kimlik sağlayıcı kurulumu için operasyonel sunucunun ve Operational Insights sunucusunun OAuth belgelerine bakın.
Günlük Kaydı
Her sunucu varsayılan olarak info düzeyinde stderr konumuna günlük kaydı yapar.
CB_MCP_LOG_LEVEL—off,error,warning,info(yaşam döngüsü olayları ve araç çağrıları) veyadebug.CB_MCP_LOG_SINKS—stderr,fileveya her ikisi.fileile her düzey içinCB_MCP_LOG_FILEyanına bir dönen dosya yazılır (mcp_server.info.log,mcp_server.error.log, …).- Döndürme ve saklama —
CB_MCP_LOG_ROTATION_MAX_SIZE_MB(varsayılan 1 MB) veCB_MCP_LOG_RETENTION_BACKUP_COUNT(varsayılan 1) her düzey için geçerlidir; düzey başınaCB_MCP_LOG_<LEVEL>_ROTATION_MAX_SIZE_MB/CB_MCP_LOG_<LEVEL>_RETENTION_BACKUP_COUNTile geçersiz kılın. Geçersiz boyutlar, başlangıçta bir uyarı verilerek varsayılana döner.CB_MCP_LOG_MAX_BYTESkullanımdan kaldırılmıştır. - Yapılandırma anlık görüntüsü —
filehedefiyle, destek amacıyla her başlangıçta ortamın ve gizli bilgileri ayıklanmış sunucu yapılandırmasının JSON kaydımcp_server_config.log.jsonkonumuna yazılır.
# Debug logging to stderr and rotating per-level files
uvx couchbase-mcp-server operational --log-level=debug --log-sinks=stderr,file
MCP istemciniz genellikle sunucunun stderr çıktısını da yakalar — konumu için İstemci Kurulumu bölümüne bakın. Ayrıntılar: operasyonel sunucu ve Operational Insights sunucusu için günlük kaydı belgeleri.
Denetim
Denetim günlükleri kimin ne yaptığını ve buna izin verilip verilmediğini kaydeder — neyin yanlış gittiğini kaydeden operasyonel günlüklerden ayrıdır. Bir aracı için bu soruyu yanıtlayabilecek tek katman MCP sunucusudur: her istek kümeye tek bir veritabanı kullanıcısı olarak ulaşır ve kapsam reddi, salt okunur engelleme veya reddedilen onay gibi kararlar kümeye hiçbir zaman ulaşmaz.
Denetim varsayılan olarak kapalıdır. CB_MCP_AUDIT_LOG_ENABLED=true ile etkinleştirin; CB_MCP_AUDIT_LOG_SINKS=file ve CB_MCP_AUDIT_LOG_FILE_PATH ayarlanmadığı sürece stderr çıktısına yazar.
# 90 days of daily, gzipped audit files
uvx couchbase-mcp-server operational --audit-log-enabled=true \
--audit-log-sinks=file --audit-log-file-path=/var/log/cb-mcp/audit.log \
--audit-log-rotation-interval=1d --audit-log-rotation-max-size-mb=0 \
--audit-log-retention-max-backups=90
Kayıtlar, Couchbase Server ve Sync Gateway ile aynı alan söz varlığını kullanan JSON Lines biçimindedir:
{"id":61522,"name":"document write","description":"A document write operation was requested through a tool","timestamp":"2026-09-29T09:14:22.418Z","real_userid":{"domain":"oauth","user":"agent-svc-7"},"server":{"version":"1.0.2","host":"mcp-01"},"cid":"9f2c...","outcome":"success","tool_name":"upsert_document_by_id","required_scope":"write","ks":"travel-sample.inventory.airline","cb_userid":"mcp_service"}
Denetimin işleyişi
- Kimlik —
real_useridçağıranı belirtir:oauth(token konusu),local(stdio kullanıldığında işletim sistemi kullanıcısı) veyaanonymous(OAuth olmadan HTTP; başlangıçta uyarı verir). - İlişkilendirme —
cidtek bir isteğe ait tüm kayıtları gruplandırır ve SQL++client_context_idolarak gönderilir; böylece Couchbase Server'ınclientContextIddeğeriyle tam olarak eşleşir. Bilerek oturum tanımlayıcısı yoktur. - Olaylar — sabit ve numaralandırılmış bir katalog (yaşam döngüsü, başlatma, token reddi, kapsam reddi, salt okunur engelleme, reddedilen/atlanan onay ve her araç kategorisi için bir okuma/yazma çifti).
queryvesearchistisnadır: ifade odaklı ve arama yüzeylerinde bu ayrım güvenilir biçimde yapılamadığından, her biri okuma/yazma çifti yerine tek bir olay olarak kaydedilir. Vektör işlemleri bu iki kategorinin içindedir. Kataloğun tamamı pakettedescriptor.jsonolarak sunulur. Operasyonel sunucu çekirdek olaylar için0xF000(61440) bloğunu, Operational Insights ise0x10000(65536) bloğunu kullanır; ikisi de çekirdek olaylar için0xE000(57344) bloğunu paylaşır. - Filtreleme —
CB_MCP_AUDIT_LOG_DISABLED_EVENTS, sayısal kimliğe göre okuma olaylarını bastırır (ör.61490,61492). Yazma ve güvenlik olayları devre dışı bırakılamaz; tek olaylıquery(61507 veya Operational Insights'ta 65603) vesearch(61510) kategorileri de devre dışı bırakılamaz: her kategori için tek bir olay hem yazmaları hem okumaları kapsar; bu nedenle kapatılması bir değişiklik kaydının kaybolmasına yol açar. - Döndürme — boyuta göre (
CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB, varsayılan 10) ve yaşa göre (CB_MCP_AUDIT_LOG_ROTATION_INTERVAL, varsayılan1d), hangisi önce gerçekleşirse;0ikisini de kapatır. Döndürülen dosyalara zaman damgası eklenir ve dosyalar gzip ile sıkıştırılır; canlı dosyatail -fiçin düz metin olarak kalır. - İşlem başına dosyalar — ada ana makine ve pid eklenir (
audit.log→audit.<host>.<pid>.log); böylece eşzamanlı işlemler hiçbir zaman aynı dosyayı paylaşmaz. - Saklama dosya başınadır —
CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS(varsayılan 10), tek bir dosyanın yedek sayısını sınırlar. Her yeni işlem yeni bir dosya yazar ve eski dosyaları temizlemez; bu nedenle birim boyutunu buna göre ayarlayın veya eskiaudit.*.log*dosyalarını temizleyin. - Hata durumunda çalışmaya devam etme — dosyaya yazılamazsa sunucu hizmet vermeyi sürdürür ve düşürülen kayıtları sayar;
get_server_configuration_status,written/dropped/write_errorsdeğerlerini bildirir. - Araç bağımsız değişkenleri — yalnızca başlangıçta uyarı veren
CB_MCP_AUDIT_LOG_TOOL_ARGS=trueile kaydedilir. Bu sürümde gizli bilgi ayıklama yoktur; dolayısıyla tam belge gövdeleri de dahil olmak üzere bağımsız değişkenler olduğu gibi yazılır.
İstemci Kurulumu
Her istemcinin, kendi yapılandırma konumunda operasyonel veya Operational Insights hızlı başlangıç bölümünden alınmış bir sunucu yapılandırmasına ihtiyacı vardır. Aşağıdaki örneklerde operasyonel sunucu kullanılır.
Claude Desktop
- Yapılandırma dosyasını açın (MCP hızlı başlangıç kılavuzu bölümüne bakın):
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Sunucuyu
mcpServersaltına ekleyin ve Claude Desktop'ı yeniden başlatın.
Günlükler: macOS ~/Library/Logs/Claude, Windows %APPDATA%\Claude\Logs. MCP sorun giderme kılavuzuna bakın.
Cursor
- Cursor Settings > Tools & Integrations > MCP Tools bölümüne gidin (Cursor'ın MCP belgelerine bakın) veya tek tıklamayla Cursor'a yükle bağlantısını kullanın — ardından yer tutucu bağlantı dizesini ve kimlik bilgilerini değiştirin.
- Yapılandırmayı
mcpServersaltına ekleyin ve kaydedin. couchbaseöğesinin etkin olduğunu doğrulamak için MCP sunucuları listesini yenileyin.
Günlükler: alt panelde Output bölümünü açın ve Cursor MCP öğesini seçin.
Windsurf Editor
- Command Palette > Windsurf MCP Configuration Panel veya Windsurf Settings > Advanced > Cascade > Model Context Protocol (MCP) Servers bölümünü açın (Windsurf'ın MCP belgelerine bakın).
- Add Server > Add custom server öğesine tıklayın, yapılandırmayı yapıştırın ve kaydedin.
couchbaseöğesinin etkin olduğunu doğrulamak için sunucu listesini yenileyin.
VS Code
VS Code, üst düzey anahtar olarak mcpServers yerine servers kullanır. Yapılandırmayı bir çalışma alanı için .vscode/mcp.json konumuna ekleyin veya tüm çalışma alanları için MCP: Open User Configuration komutunu çalıştırın (VS Code'un MCP belgelerine bakın):
{
"servers": {
"couchbase": {
"command": "uvx",
"args": ["couchbase-mcp-server", "operational"],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password"
}
}
}
}
Dosyayı kaydetmek sunucuyu başlatır; sunucuyu yönetmek için üstündeki Running | Stop | n Tools eylemlerini kullanın.
Günlükler: MCP: List Servers komutunu çalıştırın, couchbase öğesini seçin, ardından Show Output öğesini seçin.
JetBrains IDE'leri
- AI Assistant veya Junie eklentisini yükleyin.
- Settings > Tools > AI Assistant (or Junie) > MCP Server bölümüne gidin, + öğesine tıklayın, yapılandırmayı ekleyin ve Apply öğesine tıklayın.
- Araçlarını görmek için sunucunun durumunun üzerine gelin.
Günlükler: Help > Show Log in Finder (Explorer) > mcp > couchbase.
Docker
Önceden oluşturulmuş imajlar Docker Hub üzerinde couchbase/mcp-server olarak yayımlanır ve sunucu Docker MCP Catalog içinde listelenir. Kapsayıcıyı yukarıdaki ortam değişkenleriyle yapılandırın. Etiketler, birimler ve sağlık denetimi örnekleri için Docker Hub sayfasına (DOCKER.md) bakın.
HTTP üzerinden çalıştırırken, sunucunun kapsayıcı dışından erişilebilir olması için 0.0.0.0 adresine bağlanması gerektiğini unutmayın:
docker run --rm \
-e CB_CONNECTION_STRING='<couchbase_connection_string>' \
-e CB_USERNAME='<database_user>' \
-e CB_PASSWORD='<database_password>' \
-e CB_MCP_TRANSPORT=http \
-e CB_MCP_HOST=0.0.0.0 \
-p 8000:8000 \
couchbase/mcp-server:latest operational
- Couchbase ana makinenizde çalışıyorsa bağlantı dizesi olarak
couchbase://host.docker.internalkullanın (Docker ağ iletişimi bölümüne bakın). Başka bir kapsayıcının ağına katılmak için--network=<your_network>kullanın. - Operational Insights sunucusunu çalıştırmak için
operationalyerineoperational-insightsekleyin (bağlantı noktası8001).
İmajı kaynaktan oluşturma
docker build -t mcp/couchbase-src .
./build.sh [image-name], CI ile aynı bağımsız değişkenleri kullanarak derleme yapar — GIT_COMMIT_HASH ve BUILD_DATE derleme bağımsız değişkenlerini ayarlar ve imajı latest ile <short-commit> olarak etiketler (varsayılan ad mcp/couchbase-src). Etiketlerle elle derlemek için:
docker build --build-arg GIT_COMMIT_HASH=$(git rev-parse HEAD) \
--build-arg BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ') \
-t mcp/couchbase-src .
# Check the labels
docker inspect --format='{{json .Config.Labels}}' mcp/couchbase-src:latest
Sorun Giderme
Kapsamlı kılavuzlar için operasyonel sunucunun ve Operational Insights sunucusunun sorun giderme belgelerine ve operasyonel sunucunun ve Operational Insights sunucusunun güvenlik yönergelerine bakın. Hızlı kontroller:
- Bağlantı dizesini, kullanıcı adı/parolayı veya sertifika yollarını kontrol edin.
- Capella kullanıyorsanız kümenin, sunucuyu çalıştıran makineden bağlantılara izin verdiğinden emin olun.
- Veritabanı kullanıcısının en az bir bucket'a erişebildiğinden emin olun.
- İstemci
uv/uvxöğesini bulamıyorsa mutlak yolucommandiçine yazın. - Kaynaktan çalıştırırken yapılandırmadaki depo yolunu kontrol edin ve güncellemeleri aldıktan sonra
uv synckomutunu çalıştırın. - Sunucunun gerçekten çözümlenmiş yapılandırmasını görmek için
get_server_configuration_statusçağrısını yapın ve istemcinizin günlüklerini kontrol edin (İstemci Kurulumu bölümüne bakın).
SSS
Claude Desktop'ı Couchbase'e nasıl bağlarım? Hızlı başlangıç yapılandırmasını claude_desktop_config.json içine ekleyin ve Claude Desktop'ı yeniden başlatın — İstemci Kurulumu bölümüne bakın.
Bunu Couchbase Capella ile kullanabilir miyim? Evet, operasyonel sunucuyla: aynı yapılandırma Capella ve kendi yönettiğiniz kümelerde çalışır; ancak bazı yönetim araçları yalnızca kendi yönettiğiniz kümelerde kullanılabilir (Araçlar bölümüne bakın). Operational Insights sunucusu yalnızca kendi yönettiğiniz Operational Insights kümeleri içindir.
Bir yapay zekâ aracısının veritabanıma yazmasına izin vermek güvenli mi? Varsayılan olarak hayır; yazma araçları yüklenmez ve SQL++ üzerinde değişiklik yapılması engellenir. Yazmaları etkinleştirseniz bile tek tek araçları devre dışı bırakabilir veya onay isteyebilirsiniz — ancak asıl güvenlik sınırı Couchbase kullanıcınızın RBAC izinleridir. Güvenlik Denetimleri bölümüne bakın.
SQL++ bilmem gerekiyor mu? Hayır. Sade bir dille sorun; asistan run_sql_plus_plus_query için SQL++ yazar. Ayrıca bir sorgu planını açıklayabilir veya öneriler için Index Advisor'a danışabilir.
STDIO mu, Streamable HTTP mi? Tek bir yerel istemci için STDIO kullanın. İstemciler arasında OAuth ile tek bir sunucuyu paylaşmak için Streamable HTTP kullanın. Aktarımlar bölümüne bakın.
Bu, Couchbase tarafından resmen destekleniyor mu? Evet, Couchbase AI Data Plane lisansıyla. Böyle bir lisans olmadan Couchbase mühendisleri GitHub sorunları üzerinden mümkün olan en iyi çabayı göstererek yardımcı olur. Destek Politikası bölümüne bakın.
Katkıda Bulunma
Hata düzeltmeleri, özellikler ve belgeler için katkılarınızı bekliyoruz. Bir hatayı bildirmek veya yardım istemek için GitHub sorunu açın.
Geliştirme kurulumu, lint, test, proje yapısı ve iş akışı için CONTRIBUTING.md dosyasına bakın. Başlamak için:
git clone https://github.com/couchbase/mcp-server-couchbase.git
cd mcp-server-couchbase
uv sync --extra dev
uv run pre-commit install
./scripts/lint.sh
Entegrasyon testleri canlı bir kümeye karşı çalışır. CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD ve isteğe bağlı olarak CB_MCP_TEST_BUCKET değerlerini dışa aktarın; Operational Insights testleri ayrıca CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING / _USERNAME / _PASSWORD değerlerini kullanır ve bunlar ayarlanmamışsa atlanır. Ardından şunu çalıştırın:
uv run --extra dev pytest tests/integration -v
Kullanım Verileri, LLM Riskleri ve Destek Politikası
Kullanım Verilerinin Toplanması
Bu ürün, kullanım ve performans verilerini (ürün adı ve sürümü gibi) ve tarayıcı bilgilerini (IP adresi gibi) (topluca "Kullanım Verileri") otomatik olarak toplar. Couchbase, ürünlerimizi geliştirmek ve iyileştirmek, ayrıca satış ve pazarlama programlarımıza yön vermek için Kullanım Verilerini, Couchbase'e sağlayabileceğiniz diğer verilerle (kullanıcı adınız veya e-posta adresiniz gibi) birlikte kullanır. Couchbase ürünlerinde sakladığınız hiçbir veriye erişmeyiz veya bu verileri toplamayız. Kullanım Verilerini, genel kullanım eğilimlerini anlamak ve ürünlerimizi sizin için daha kullanışlı hâle getirmek amacıyla kullanırız. Couchbase'in bilgileri nasıl topladığı, koruduğu ve işlediği hakkında daha fazla bilgi için https://www.couchbase.com/privacy-policy. adresinde görüntülenebilen Couchbase Gizlilik Politikası'na bakın.
LLM'lerle İlişkili Riskler
- Büyük dil modellerinin ve benzer teknolojilerin kullanımı, hatalı veya zararlı çıktılar üretme olasılığı da dâhil olmak üzere riskler içerir.
- Couchbase bu tür çıktıların kalitesini veya doğruluğunu incelemez ya da değerlendirmez ve bu çıktılar Couchbase'in görüşlerini yansıtmayabilir.
- Büyük dil modellerini ve ilgili teknolojileri kullanıp kullanmayacağınıza ve bunları kullanımınızı düzenleyen lisans koşullarına, kullanım şartlarına ve kuruluşunuzun politikalarına uyup uymayacağınıza karar vermek tamamen sizin sorumluluğunuzdadır.
Destek Politikası
Couchbase MCP Server açık kaynaklıdır ve Couchbase mühendisleri tarafından sürdürülür. Yardım alma yönteminiz, ürünü nasıl kullandığınıza bağlıdır:
- Topluluk kullanımı — GitHub sorunu açarak hataları bildirin, soru sorun ve özellik isteğinde bulunun. Couchbase mühendisleri depoyu izler ve yanıt süresi taahhüdü olmaksızın ellerinden geldiğince yanıt verir. Couchbase destek portalı topluluk kullanımına yardımcı olamaz.
- Kurumsal destek — Couchbase Agent Memory ve Couchbase Agent Catalog'u da kapsayan Couchbase AI Data Plane lisansıyla sunulur. Lisanslı müşteriler, alışık oldukları Couchbase Destek kanalları üzerinden yardım alabilir.
Projeyi kullandığınız ve projeye katkıda bulunduğunuz için teşekkür ederiz!