Couchbase

chính thức

Tương tác với dữ liệu được lưu trữ trong các cụm Couchbase bằng ngôn ngữ tự nhiên.

Bạn có thể làm gì với Couchbase MCP?

  • Khám phá dữ liệu cụm — Liệt kê các bucket, scope và collection, sau đó suy luận lược đồ của một collection như orders.
  • Chạy truy vấn SQL++ — Thực thi các truy vấn SQL++ chỉ đọc trên một bucket và scope, đồng thời giải thích kế hoạch truy vấn.
  • Kiểm tra tài liệu — Lấy tài liệu theo ID hoặc đọc các đường dẫn subdocument cụ thể mà không cần tải toàn bộ tài liệu.
  • Kiểm tra tình trạng cụm — Báo cáo tình trạng cụm, các dịch vụ đang chạy và chẩn đoán kết nối.
  • Phân tích hiệu năng truy vấn — Tìm các truy vấn chạy lâu nhất, thường xuyên nhất hoặc không sử dụng chỉ mục bao phủ.
  • Truy vấn tìm kiếm và vector — Chạy tìm kiếm toàn văn và truy vấn độ tương đồng vector trên các chỉ mục đã cấu hình.

Tài liệu

Couchbase MCP Server

Couchbase MCP Server là một Server MCP tự lưu trữ, cho phép các tác nhân AI kết nối và tương tác với dữ liệu trong Couchbase Servers (dù được lưu trữ trên Capella hay tự quản lý) hoặc Operational Insights Enterprise. Server cung cấp các công cụ thuộc nhiều danh mục, bao gồm Tình trạng cụm, Lược đồ dữ liệu, Truy vấn và nhiều danh mục khác — cùng các biện pháp kiểm soát an toàn thông qua chế độ chỉ đọc và khả năng vô hiệu hóa công cụ chi tiết. Server hỗ trợ cả phương thức truyền tải STDIO và Streamable HTTP, cùng các khả năng OAuth.

Couchbase MCP Server được phân phối dưới dạng gói Python Package Index (PyPI) và qua Docker. Có thể nhận hỗ trợ doanh nghiệp cho Couchbase MCP Server bằng cách cấp phép Couchbase AI Data Plane; giấy phép này cũng cho phép sử dụng và nhận hỗ trợ doanh nghiệp cho Couchbase Agent Memory và Couchbase Agent Catalog.

Docs License Python 3.11+ PyPI version Install in Cursor Verified on MseeP Trust Score

Tài liệu đầy đủ: docs.couchbase.com/mcp-server

Couchbase Server MCP server

Mục lục

Lý do chọn Couchbase MCP Server

  • An toàn theo mặc định — các công cụ ghi không được tải và các truy vấn sửa đổi dữ liệu bị chặn trừ khi bạn đặt CB_MCP_READ_ONLY_MODE=false; bạn cũng có thể vô hiệu hóa từng công cụ hoặc yêu cầu người dùng xác nhận trước khi sử dụng.
  • Couchbase Server và Operational Insights — operational server kết nối với Couchbase Capella hoặc cụm Couchbase Server tự quản lý bằng cùng một cấu hình; Operational Insights server kết nối với các cụm Operational Insights tự quản lý.
  • Nhận biết RBAC — các biện pháp kiểm soát công cụ hướng dẫn LLM; quyền kiểm soát truy cập dựa trên vai trò của người dùng Couchbase vẫn là ranh giới bảo mật có thẩm quyền.
  • Phương thức truyền tải sẵn sàng cho môi trường production — STDIO dành cho client máy tính để bàn cục bộ, hoặc Streamable HTTP với OAuth 2.1 tùy chọn (mọi IdP công bố JWKS: Auth0, Okta, Keycloak, Entra, Cognito, …), kiểm tra tình trạng và ghi nhật ký kiểm tra cho các triển khai dùng chung. Operational server cũng có thể chạy nhiều worker để sử dụng thêm lõi CPU.
  • Mọi MCP client — đã được kiểm thử với Claude Desktop, Cursor, Windsurf, VS Code và JetBrains AI Assistant/Junie.

Sau khi kết nối, bạn có thể hỏi những câu như:

  • "Tôi có những bucket, scope và collection nào, và lược đồ của collection orders là gì?"
  • "Tìm 10 tài liệu mới nhất trong users mà status = 'active'."
  • "5 truy vấn chậm nhất trong giờ qua là gì, và có truy vấn nào thiếu covering index không?"
  • "Cụm này có khỏe mạnh không, và những dịch vụ nào đang chạy?"
  • "Chèn một tài liệu mới vào products với các trường sau: …" (cần CB_MCP_READ_ONLY_MODE=false)

Chọn một Server

Gói này cung cấp hai MCP server. Mỗi server được khởi chạy bằng một subcommand riêng, kết nối với một loại cụm khác nhau và có bộ công cụ riêng. Hãy chọn server phù hợp với cụm của bạn, làm theo phần hướng dẫn tương ứng để thiết lập và sử dụng công cụ, sau đó tham khảo Cấu hình chung để biết các thiết lập dùng chung. Để sử dụng cả hai, hãy đăng ký từng server riêng biệt trong MCP client.

Operational serverOperational Insights server
Sử dụng vớiCụm Couchbase (Capella hoặc tự quản lý)Cụm Operational Insights tự quản lý (không có trên Capella)
Subcommandoperational (mặc định)operational-insights
Chuỗi kết nốicouchbase:// / couchbases://URL HTTP(S), ví dụ: http://localhost:8095
Biến thông tin xác thựcCB_CONNECTION_STRING, CB_USERNAME, …CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING, CB_OPERATIONAL_INSIGHTS_USERNAME, …
Công cụ52 — tình trạng cụm, lược đồ, KV, SQL++, chỉ mục, tìm kiếm toàn văn và vector, hiệu năng truy vấn13 — lược đồ, SQL++ (đồng bộ và bất đồng bộ), chỉ mục, xuất dữ liệu
Cổng HTTP mặc định80008001
Tệp nhật ký mặc địnhmcp_server.logmcp_server_operational_insights.log

Hiện tại, subcommand không bắt buộc đối với operational server — chỉ cần chạy couchbase-mcp-server là khởi chạy server — nhưng ghi rõ subcommand giúp cấu hình của bạn không bị mơ hồ. Các tùy chọn phải đặt sau subcommand: couchbase-mcp-server operational --transport=http. Kiểm tra phiên bản đã cài bằng uvx couchbase-mcp-server --version.

Operational Server

Server operational kết nối với cụm Couchbase trên Capella hoặc Couchbase Server tự quản lý, sử dụng couchbase Python SDK.

Bắt đầu nhanh với Operational

Bạn cần một cụm Couchbase đang chạy — gói miễn phí Capella là cách nhanh nhất để có một cụm (bạn có thể nhập tập dữ liệu mẫu) — và một MCP client. Thêm một trong các cấu hình sau vào client của bạn (xem Thiết lập client để biết vị trí tệp cấu hình của từng client). Nếu client đã có các server khác, hãy thêm couchbase vào đối tượng mcpServers hiện có.

Từ PyPI bằng uvx (cần uv và Python 3.11 trở lên):

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server", "operational"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password"
      }
    }
  }
}

Dùng Docker (chỉ cần Docker):

{
  "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"
      ]
    }
  }
}
Từ mã nguồn
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/ là đường dẫn đến bản sao kho mã của bạn — giữ nguyên dấu gạch chéo ở cuối. Sau khi tải các bản cập nhật, chạy uv sync để cập nhật các phần phụ thuộc.

Kết nối và xác thực với Operational

Sử dụng một trong hai phương thức: tên người dùng và mật khẩu hoặc chứng chỉ client (mTLS). Nếu đặt cả hai, chứng chỉ sẽ được sử dụng.

Biến môi trườngĐối số CLIMô tả
CB_CONNECTION_STRING--connection-stringChuỗi kết nối đến cụm. Bắt buộc
CB_USERNAME / CB_PASSWORD--username / --passwordXác thực cơ bản
CB_CLIENT_CERT_PATH / CB_CLIENT_KEY_PATH--client-cert-path / --client-key-pathXác thực mTLS
CB_CA_CERT_PATH--ca-cert-pathChứng chỉ gốc cho chứng chỉ máy chủ tự ký/không đáng tin cậy (không cần thiết với Capella)
Ví dụ mTLS
{
  "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"
      }
    }
  }
}

Công cụ của Operational

Các công cụ ghi (được đánh dấu ✏️) không được tải khi chế độ chỉ đọc đang bật; đây là chế độ mặc định. Các công cụ được đánh dấu 🖥️ chỉ dành cho môi trường tự quản lý — chúng sử dụng các endpoint REST quản trị mà Capella không cung cấp, hoặc (discover_tool_input_values) chỉ cung cấp dữ liệu tham chiếu cho một công cụ có sử dụng endpoint đó — vì vậy chúng cần Couchbase Server 7.6+ tự quản lý và không được đăng ký trên các kết nối Capella.

Thiết lập và tình trạng cụm

Công cụMô tả
get_server_configuration_statusTrạng thái và cấu hình server mà không cần kết nối với cụm: chế độ chỉ đọc, công cụ bị vô hiệu hóa/cần xác nhận, OAuth, ghi nhật ký và bộ đếm kiểm tra
test_cluster_connectionKiểm tra thông tin xác thực của cụm bằng cách kết nối với cụm
get_cluster_health_and_servicesTình trạng cụm và các dịch vụ đang chạy, có thể lọc bằng service_types
get_client_connectivity_reportThông tin chẩn đoán kết nối được SDK lưu trong bộ nhớ đệm, không chủ động thăm dò mạng
get_cluster_metrics 🖥️Thống kê cụm trong một khoảng thời gian lịch sử (endpoint stats-range)
get_cluster_tasks 🖥️Các tác vụ đang chạy — cân bằng lại, nén, XDCR, tạo chỉ mục. Cần ro_admin
get_cluster_health_snapshot 🖥️Tình trạng từng node: cấu trúc liên kết dịch vụ, trạng thái thành viên, node điều phối và tổng hợp tình trạng. Cần ro_admin
get_bucket_config 🖥️Cấu hình và trạng thái trực tiếp của một bucket (hoặc tất cả bucket) — hạn mức, chính sách loại bỏ, bản sao, độ bền, lưu trữ, nén. Cần ro_admin
get_cluster_system_events 🖥️Nhật ký sự kiện hệ thống (thay đổi cấu hình, chuyển đổi dự phòng, cân bằng lại, khởi động lại), giới hạn theo khoảng thời gian bằng since_time. Cần Full Admin hoặc Cluster Admin
discover_tool_input_values 🖥️Tra cứu các giá trị đầu vào chính xác mà công cụ khác cần (ví dụ: mọi tên chỉ số cho get_cluster_metrics). Hoạt động ngoại tuyến

Khám phá mô hình dữ liệu và lược đồ

Công cụMô tả
get_buckets_in_clusterLiệt kê tất cả bucket trong cụm
get_scopes_in_bucketLiệt kê tất cả scope trong một bucket
get_collections_in_scopeLiệt kê tất cả collection trong một scope (cần dịch vụ Query)
get_scopes_and_collections_in_bucketLiệt kê tất cả scope và collection trong một bucket
get_schema_for_collectionSuy luận cấu trúc của một collection
create_scope ✏️Tạo scope trong một bucket (Server 7.6+ và Capella)
create_collection ✏️Tạo collection trong một scope hiện có (Server 7.6+ và Capella)
delete_scope ✏️Xóa scope và tất cả collection trong scope đó — không thể khôi phục
delete_collection ✏️Xóa collection và tất cả tài liệu trong collection đó — không thể khôi phục

Thao tác tài liệu (KV)

Công cụMô tả
get_document_by_idLấy tài liệu theo ID
lookup_subdocumentĐọc các đường dẫn cụ thể, kiểm tra sự tồn tại hoặc đếm mà không cần tải toàn bộ tài liệu
upsert_document_by_id ✏️Upsert tài liệu theo ID
insert_document_by_id ✏️Chèn tài liệu mới (thất bại nếu tài liệu đã tồn tại)
replace_document_by_id ✏️Thay thế tài liệu hiện có (thất bại nếu tài liệu không tồn tại)
delete_document_by_id ✏️Xóa tài liệu theo ID
mutate_subdocument ✏️Sửa đổi các đường dẫn trong tài liệu hiện có (upsert, chèn, thay thế, xóa, thao tác mảng, bộ đếm)

Truy vấn và lập chỉ mục

Công cụMô tả
run_sql_plus_plus_queryChạy truy vấn SQL++ trong phạm vi một bucket và scope — sử dụng trực tiếp tên collection (SELECT * FROM users). Các câu lệnh sửa đổi dữ liệu bị chặn trong chế độ chỉ đọc
explain_sql_plus_plus_queryTạo và đánh giá kế hoạch EXPLAIN: siêu dữ liệu, kế hoạch được trích xuất và các phát hiện
get_index_advisor_recommendationsĐề xuất từ Index Advisor cho truy vấn SQL++
list_indexesLiệt kê chỉ mục cùng định nghĩa, có thể lọc theo bucket/scope/collection/tên; đánh dấu chỉ mục vector (is_vector, vector_type)
get_index_stats 🖥️Kích thước, mức phân mảnh, lưu lượng quét và độ trễ của từng chỉ mục trên từng node — giúp phát hiện áp lực và chỉ mục không được sử dụng
create_query_index ✏️Tạo chỉ mục GSI scalar, vector Hyperscale hoặc vector Composite (index_type). Mặc định được hoãn — tiếp theo hãy chạy build_index
create_index ✏️Không còn được khuyến nghị — hãy dùng create_query_index. Đã bị xóa trong phiên bản 2.0
build_index ✏️Tạo tất cả chỉ mục đang chờ trên một collection
drop_index ✏️Xóa chỉ mục GSI (scalar hoặc vector)

Tìm kiếm toàn văn (FTS)

Cần Couchbase Server 7.6+ và dịch vụ Search. Hỗ trợ cả chỉ mục cấp scope và chỉ mục cấp cụm (kiểu cũ): truyền đồng thời bucket_name và scope_name cho chỉ mục cấp scope, hoặc bỏ qua cả hai.

Công cụMô tả
list_search_indexesLiệt kê các chỉ mục Search — cấp cụm, theo bucket hoặc theo scope
get_search_index_definitionĐịnh nghĩa đầy đủ của một chỉ mục Search (ánh xạ, bộ phân tích, tham số kế hoạch)
run_searchChạy bất kỳ truy vấn FTS không vector nào từ phần thân JSON thô; explain=true trả về kế hoạch thực thi
upsert_search_index ✏️Tạo hoặc cập nhật chỉ mục Search, bao gồm ánh xạ trường vector. Các bản cập nhật kích hoạt quá trình dựng lại toàn bộ — truyền uuid hiện tại để tránh ghi đè các thay đổi đồng thời
drop_search_index ✏️Xóa chỉ mục Search — không thể khôi phục

Tìm kiếm vector

Cả hai công cụ đều nhúng văn bản truy vấn thuần bằng mô hình được cấu hình trong Embedding Providers. Khả dụng trên Couchbase Server tự quản lý và Capella.

Công cụMô tả
run_vector_queryTìm kiếm độ tương đồng trên chỉ mục vector GSI (Server 8.0+) thông qua APPROX_VECTOR_DISTANCE(). Chỉ mục được tự động chọn; hỗ trợ bộ lọc trước SQL++ where và tinh chỉnh Hyperscale (num_probes, rerank, top_n_scan). Trả về toàn bộ tài liệu
run_vector_searchTìm kiếm vector bằng dịch vụ Search (Server 7.6+) trên một chỉ mục được đặt tên. scalar_query biến tìm kiếm thành tìm kiếm kết hợp; prefilter thu hẹp các ứng viên trước. Trả về các trường được lưu trong chỉ mục cho mỗi kết quả

Phân tích hiệu năng truy vấn

Công cụMô tả
get_longest_running_queriesCác truy vấn chạy lâu nhất theo thời gian dịch vụ trung bình
get_most_frequent_queriesCác truy vấn được thực thi thường xuyên nhất
get_queries_with_largest_response_sizesCác truy vấn có kích thước phản hồi lớn nhất
get_queries_with_large_result_countCác truy vấn có số lượng kết quả lớn nhất
get_queries_using_primary_indexCác truy vấn sử dụng chỉ mục chính
get_queries_not_using_covering_indexCác truy vấn không sử dụng chỉ mục bao phủ
get_queries_not_selectiveCác truy vấn có lượt quét — chỉ mục phụ, chỉ mục chính hoặc tuần tự — trả về nhiều tài liệu hơn đáng kể so với kết quả cuối cùng

Tình trạng dịch vụ Query 🖥️

Các công cụ này gọi API REST quản trị riêng của dịch vụ Query trên mỗi nút truy vấn.

Công cụMô tả
get_cluster_query_vitalsTình trạng bộ máy truy vấn: tốc độ yêu cầu, yêu cầu đang hoạt động/đang xếp hàng, bộ nhớ, GC, thời gian hoạt động. Cần ro_admin
get_active_queriesCác truy vấn đang thực thi trên tất cả nút truy vấn. Cần ro_admin
delete_active_query ✏️Hủy truy vấn đang chạy bằng ID yêu cầu. Cần Full Admin hoặc Cluster Admin

Các công cụ tự động bị vô hiệu hóa trên Capella

Các công cụ 🖥️ truy cập Couchbase thông qua các điểm cuối REST quản trị mà Capella không cung cấp (ngoại lệ duy nhất là discover_tool_input_values, bị ẩn vì công cụ này chỉ phục vụ một công cụ cần đến chúng). Khi mọi máy chủ trong CB_CONNECTION_STRING đều kết thúc bằng .cloud.couchbase.com, máy chủ sẽ không đăng ký các công cụ này và liệt kê chúng cùng với các công cụ bị vô hiệu hóa của bạn trong get_server_configuration_status và nhật ký khởi động. Các công cụ dựa trên SDK như get_cluster_health_and_services và get_client_connectivity_report vẫn khả dụng.

Công cụĐiểm cuối cần thiết
get_cluster_metricsREST quản lý (/pools/default/stats/range)
get_cluster_tasksREST quản lý (/pools/default/tasks)
get_bucket_configREST quản lý (/pools/default/buckets[/<name>])
get_cluster_health_snapshotREST quản lý, cùng các điểm cuối theo từng nút
get_cluster_system_eventsREST quản lý (/events)
get_index_statsREST của Index Service (/api/v1/stats của mỗi indexer)
get_cluster_query_vitalsREST của dịch vụ Query (/admin/vitals)
get_active_queriesREST của dịch vụ Query (/admin/active_requests)
delete_active_queryREST của dịch vụ Query (DELETE /admin/active_requests/{id})
discover_tool_input_valuesKhông có (hoạt động ngoại tuyến), nhưng chỉ phục vụ get_cluster_metrics, tính năng mà Capella không có

Nhà cung cấp embedding

run_vector_query và run_vector_search nhúng văn bản truy vấn bằng nhà cung cấp được đặt trong CB_MCP_EMBEDDING_MODEL_PROVIDER. Đây là tùy chọn: nếu không thiết lập, máy chủ vẫn khởi động bình thường và cả hai công cụ vẫn được đăng ký, nhưng khi gọi chúng sẽ trả về lỗi giải thích cần thiết lập gì.

CB_MCP_EMBEDDING_MODEL_PROVIDERBắt buộcTùy chọnGhi chú
capellaCB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL, CB_MCP_EMBEDDING_MODEL_ENDPOINT—Capella Model Service. CB_MCP_EMBEDDING_MODEL_ENDPOINT là URL riêng của bản triển khai của bạn (ví dụ: https://<id>.ai.couchbase.com) từ Capella's AI Data Plane > Models
openaiCB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODELCB_MCP_EMBEDDING_MODEL_ENDPOINTĐặt điểm cuối để sử dụng máy chủ cục bộ tương thích với OpenAI (Ollama, vLLM, LM Studio)
cohereCB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODELCB_MCP_EMBEDDING_MODEL_ENDPOINT
voyageCB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODELCB_MCP_EMBEDDING_MODEL_ENDPOINT
bedrockCB_MCP_EMBEDDING_MODELCB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY, CB_MCP_EMBEDDING_MODEL_AWS_REGIONCác mô hình embedding Amazon Titan (ví dụ: amazon.titan-embed-text-v2:0) — nhà cung cấp gửi yêu cầu theo cấu trúc inputText của Titan, vì vậy hiện chưa hỗ trợ các mô hình embedding Bedrock khác như Cohere Embed. Bỏ qua thông tin xác thực để sử dụng chuỗi AWS mặc định. Cần thêm: 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ất cả tùy chọn

Mọi biến môi trường và cờ CLI dành cho máy chủ operational server

Máy chủ Operational Insights chấp nhận các tùy chọn tương tự, ngoại trừ việc máy chủ này có cài đặt kết nối riêng và không có tùy chọn CB_MCP_EMBEDDING_MODEL_*.

Biến môi trườngĐối số CLIMô tảMặc định
CB_CONNECTION_STRING--connection-stringChuỗi kết nối đến cụm CouchbaseBắt buộc
CB_USERNAME--usernameTên người dùng có quyền truy cập vào các bucket cần thiết để xác thực cơ bảnBắt buộc (hoặc cần Chứng chỉ và Khóa máy khách cho mTLS)
CB_PASSWORD--passwordMật khẩu dùng cho xác thực cơ bảnBắt buộc (hoặc cần Chứng chỉ và Khóa máy khách cho mTLS)
CB_CLIENT_CERT_PATH--client-cert-pathĐường dẫn đến tệp chứng chỉ máy khách dùng cho xác thực mTLSBắt buộc nếu dùng mTLS (hoặc cần Tên người dùng và Mật khẩu)
CB_CLIENT_KEY_PATH--client-key-pathĐường dẫn đến tệp khóa máy khách dùng cho xác thực mTLSBắt buộc nếu dùng mTLS (hoặc cần Tên người dùng và Mật khẩu)
CB_CA_CERT_PATH--ca-cert-pathĐường dẫn đến chứng chỉ gốc của máy chủ dùng cho TLS nếu máy chủ được cấu hình bằng chứng chỉ tự ký/không đáng tin cậy. Không cần thiết nếu bạn kết nối với Capella
CB_MCP_READ_ONLY_MODE--read-only-modeNgăn mọi sửa đổi dữ liệu (KV, Query, quản lý scope/collection, quản lý chỉ mục và quản lý chỉ mục FTS). Khi bật, các công cụ ghi sẽ không được tải.true
CB_MCP_TRANSPORT--transportChế độ truyền tải: stdio, httpstdio
CB_MCP_HOST--hostMáy chủ lưu trữ cho chế độ truyền tải HTTP127.0.0.1
CB_MCP_PORT--portCổng cho chế độ truyền tải HTTP8000
CB_MCP_WORKERS--workersSố lượng tiến trình worker của máy chủ cho chế độ truyền tải http. Giá trị lớn hơn 1 chạy ở chế độ HTTP không trạng thái (xem Nhiều worker)1
CB_MCP_STATELESS_HTTP--stateless-httpXử lý từng yêu cầu HTTP mà không duy trì trạng thái theo phiên. Chỉ có hiệu lực với http; không thể kết hợp với các công cụ yêu cầu xác nhận (xem Nhiều worker)true khi số worker > 1, nếu không thì false
CB_MCP_DISABLED_TOOLS--disabled-toolsCác công cụ cần tắt (xem Tắt công cụ)Không có
CB_MCP_CONFIRMATION_REQUIRED_TOOLS--confirmation-required-toolsCác công cụ yêu cầu người dùng xác nhận rõ ràng trước khi thực thi thông qua MCP elicitation (xem Yêu cầu xác nhận)Không có
CB_MCP_LOG_LEVEL--log-levelCấp độ ghi nhật ký cho máy chủ MCP: off, debug, info, warning, error (xem Ghi nhật ký)info
CB_MCP_LOG_SINKS--log-sinksCác đích ghi nhật ký, phân tách bằng dấu phẩy: stderr, file hoặc cả hai (xem Ghi nhật ký)stderr
CB_MCP_LOG_FILE--log-fileĐường dẫn cơ sở cho các tệp nhật ký theo từng cấp độ (chỉ dùng khi bật sink file)mcp_server.log
CB_MCP_LOG_ROTATION_MAX_SIZE_MB--log-rotation-max-size-mbKích thước tối đa toàn cục tính bằng MB cho mỗi tệp nhật ký trước khi xoay vòng; được áp dụng cho mọi cấp độ trừ khi có ghi đè. 0 — hoặc giá trị không hợp lệ, chẳng hạn số âm, nan hoặc inf — đều không hợp lệ và sẽ dùng giá trị mặc định kèm cảnh báo khi khởi động1 (1 MB)
CB_MCP_LOG_MAX_BYTES--log-max-bytesKhông dùng nữa — hãy dùng CB_MCP_LOG_ROTATION_MAX_SIZE_MB (MB). Kích thước xoay vòng toàn cục tính bằng byte, vẫn được hỗ trợ để tương thích ngược; bị bỏ qua khi đồng thời đặt CB_MCP_LOG_ROTATION_MAX_SIZE_MBChưa đặt
CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB--log-error-rotation-max-size-mbKích thước xoay vòng tính bằng MB cho tệp nhật ký ERROR; ghi đè CB_MCP_LOG_ROTATION_MAX_SIZE_MB đối với ERRORKế thừa CB_MCP_LOG_ROTATION_MAX_SIZE_MB
CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB--log-warning-rotation-max-size-mbKích thước xoay vòng tính bằng MB cho tệp nhật ký WARNING; ghi đè CB_MCP_LOG_ROTATION_MAX_SIZE_MB đối với WARNINGKế thừa CB_MCP_LOG_ROTATION_MAX_SIZE_MB
CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB--log-info-rotation-max-size-mbKích thước xoay vòng tính bằng MB cho tệp nhật ký INFO; ghi đè CB_MCP_LOG_ROTATION_MAX_SIZE_MB đối với INFOKế thừa CB_MCP_LOG_ROTATION_MAX_SIZE_MB
CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB--log-debug-rotation-max-size-mbKích thước xoay vòng tính bằng MB cho tệp nhật ký DEBUG; ghi đè CB_MCP_LOG_ROTATION_MAX_SIZE_MB đối với DEBUGKế thừa CB_MCP_LOG_ROTATION_MAX_SIZE_MB
CB_MCP_LOG_RETENTION_BACKUP_COUNT--log-retention-backup-countSố lượng tệp sao lưu đã xoay vòng được giữ lại cho mỗi tệp nhật ký theo cấp độ (không tính tệp hiện hành), áp dụng cho mọi cấp độ trừ khi có ghi đè. 0 chỉ giữ lại tệp hiện hành (xem Ghi nhật ký)1
CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT--log-error-retention-backup-countSố lượng tệp sao lưu đã xoay vòng được giữ lại cho tệp nhật ký ERROR; ghi đè số lượng toàn cục đối với ERRORKế thừa CB_MCP_LOG_RETENTION_BACKUP_COUNT
CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT--log-warning-retention-backup-countSố lượng tệp sao lưu đã xoay vòng được giữ lại cho tệp nhật ký WARNING; ghi đè số lượng toàn cục đối với WARNINGKế thừa CB_MCP_LOG_RETENTION_BACKUP_COUNT
CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT--log-info-retention-backup-countSố lượng tệp sao lưu đã xoay vòng được giữ lại cho tệp nhật ký INFO; ghi đè số lượng toàn cục đối với INFOKế thừa CB_MCP_LOG_RETENTION_BACKUP_COUNT
CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT--log-debug-retention-backup-countSố lượng tệp sao lưu đã xoay vòng được giữ lại cho tệp nhật ký DEBUG; ghi đè số lượng toàn cục đối với DEBUGKế thừa CB_MCP_LOG_RETENTION_BACKUP_COUNT
CB_MCP_OAUTH_JWT_JWKS_URI--oauth-jwks-uriĐiểm cuối JWKS của nhà cung cấp danh tính dùng để xác minh JWT bearer. Bật OAuth khi được đặt cùng với issuer và audience (xem Ủy quyền OAuth 2.1)Không có
CB_MCP_OAUTH_JWT_ISSUER--oauth-issuerClaim JWT iss dự kiến. Bắt buộc để bật OAuthKhông có
CB_MCP_OAUTH_JWT_AUDIENCE--oauth-audienceClaim JWT aud dự kiến. Bắt buộc để bật OAuthKhông có
CB_MCP_OAUTH_JWT_ALGORITHM--oauth-algorithmThuật toán ký JWT: một trong các giá trị RS256/384/512, ES256/384/512, PS256/384/512RS256
CB_MCP_OAUTH_MCP_BASE_URL--oauth-mcp-base-urlURL cơ sở công khai của máy chủ này. Khi được đặt, máy chủ công bố Protected Resource Metadata theo RFC 9728 để các máy khách hỗ trợ PRM có thể tìm thấy IdPKhông có
CB_MCP_OAUTH_SCOPE_READ_LABEL--oauth-scope-read-labelGhi đè nhãn phạm vi OAuth được xem là quyền truy cập 'read' (được quảng bá trong PRM và đối chiếu với claim scope/scp của token). Dùng khi IdP của bạn không thể phát ra dạng chuẩncouchbase-mcp:read
CB_MCP_OAUTH_SCOPE_WRITE_LABEL--oauth-scope-write-labelGhi đè nhãn phạm vi OAuth được xem là quyền truy cập 'write'; có cùng ngữ nghĩa với nhãn readcouchbase-mcp:write
CB_MCP_AUDIT_LOG_ENABLED--audit-log-enabledBật ghi nhật ký kiểm toán — một sink riêng biệt với nhật ký vận hành CB_MCP_LOG_*, có lược đồ ổn định và chính sách lưu giữ riêng (xem Kiểm toán)false
CB_MCP_AUDIT_LOG_SINKS--audit-log-sinksCác đích kiểm toán, phân tách bằng dấu phẩy: console, file hoặc cả hai. console ghi vào stderr — không bao giờ ghi vào stdout, nơi truyền giao thức JSON-RPC khi dùng stdioconsole
CB_MCP_AUDIT_LOG_FILE_PATH--audit-log-file-pathĐường dẫn đến tệp nhật ký kiểm toán. Bắt buộc khi file nằm trong các sink; tên máy chủ và mã tiến trình được chèn trước phần mở rộng (audit.log → audit.<host>.<pid>.log)Không có
CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB--audit-log-rotation-max-size-mbKích thước tối đa tính bằng MB mà tệp kiểm toán hiện hành có thể đạt tới trước khi xoay vòng. 0 tắt tính năng xoay vòng theo kích thước10 (10 MB)
CB_MCP_AUDIT_LOG_ROTATION_INTERVAL--audit-log-rotation-intervalThời gian tồn tại tối đa của tệp kiểm toán hiện hành trước khi xoay vòng, theo định dạng <value><unit>, trong đó đơn vị là d (24 giờ) hoặc w (7 ngày) — ví dụ: 1d, 30d, 8w. 0 tắt tính năng xoay vòng theo khoảng thời gian1d
CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS--audit-log-retention-max-backupsSố lượng bản sao lưu đã xoay vòng được giữ lại cho mỗi tệp kiểm toán, không tính tệp hiện hành. Các bản sao lưu được nén bằng gzip. 0 không giữ lại bản sao lưu nào. Giới hạn này áp dụng cho một tệp, không phải thư mục — xem Kiểm toán10
CB_MCP_AUDIT_LOG_TOOL_ARGS--audit-log-tool-argsGhi lại giá trị đối số của công cụ trong nhật ký kiểm toán. Mặc định tắt — bản phát hành này không có chức năng che dữ liệu, vì vậy khi bật, các đối số sẽ được ghi nguyên văn, bao gồm toàn bộ nội dung tài liệufalse
CB_MCP_AUDIT_LOG_DISABLED_EVENTS--audit-log-disabled-eventsCác sự kiện kiểm toán cần loại bỏ: mã sự kiện dạng số, phân tách bằng dấu phẩy (ví dụ: 61490,61492), hoặc một tệp có mỗi dòng chứa một mã. Chỉ có thể loại bỏ các sự kiện hỗ trợ lọcKhông có
CB_MCP_EMBEDDING_MODEL_PROVIDER--embedding-model-providerNhà cung cấp embedding cho run_vector_query / run_vector_search: một trong các giá trị capella, openai, cohere, voyage, bedrock. Nếu chưa đặt, bước embedding của cả hai công cụ sẽ bị tắt cho đến khi được cấu hình — xem Cấu hình nhà cung cấp embeddingKhông có
CB_MCP_EMBEDDING_MODEL--embedding-modelTên/mã định danh mô hình cho nhà cung cấp embedding đã cấu hìnhKhông có
CB_MCP_EMBEDDING_MODEL_API_KEY--embedding-model-api-keyKhóa API cho nhà cung cấp đã cấu hình. Không được bedrock sử dụng (thay vào đó dùng chuỗi thông tin xác thực AWS / CB_MCP_EMBEDDING_MODEL_AWS_*)Không có
CB_MCP_EMBEDDING_MODEL_ENDPOINT--embedding-model-endpointGhi đè URL cơ sở (máy chủ cục bộ tương thích OpenAI hoặc URL riêng của một bản triển khai Capella Model Service — bắt buộc khi dùng CB_MCP_EMBEDDING_MODEL_PROVIDER=capella)Không có
CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID--embedding-model-aws-access-key-idID khóa truy cập AWS, chỉ dành cho nhà cung cấp bedrock. Bỏ qua để dùng chuỗi thông tin xác thực AWS mặc địnhKhông có
CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY--embedding-model-aws-secret-access-keyKhóa bí mật truy cập AWS, chỉ dành cho nhà cung cấp bedrockKhông có
CB_MCP_EMBEDDING_MODEL_AWS_REGION--embedding-model-aws-regionKhu vực AWS, chỉ dành cho nhà cung cấp bedrock. Nếu chưa đặt, sẽ dùng cơ chế phân giải khu vực riêng của AWS SDKKhông có

Máy chủ Operational Insights

Máy chủ operational-insights kết nối với các cụm Operational Insights tự quản lý. Operational Insights là cơ sở dữ liệu phân tích thời gian thực (RT-OLAP) dành cho ứng dụng thời gian thực và phân tích vận hành. Máy chủ này không khả dụng cho Capella. Máy chủ sử dụng SDK couchbase-operational-insights. Máy chủ chạy dưới dạng tiến trình riêng, tách biệt với máy chủ vận hành.

[!IMPORTANT] CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING là URL HTTP(S), không phải chuỗi kết nối couchbase:// — ví dụ: http://localhost:8095, hoặc https://<host>:18095 qua TLS. Đây là lỗi cấu hình phổ biến nhất.

Bắt đầu nhanh với Operational Insights

Từ PyPI bằng uvx:

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

Với Docker:

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

Để chạy từ mã nguồn, hãy dùng cấu hình mã nguồn vận hành, với operational-insights làm đối số cuối cùng và các biến ở trên.

Kết nối và xác thực Operational Insights

Biến môi trườngĐối số CLIMô tả
CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING--connection-stringURL endpoint (HTTP/HTTPS). Bắt buộc
CB_OPERATIONAL_INSIGHTS_USERNAME--usernameTên người dùng
CB_OPERATIONAL_INSIGHTS_PASSWORD--passwordMật khẩu
CB_OPERATIONAL_INSIGHTS_CA_CERT_PATH--ca-cert-pathChứng chỉ gốc (PEM) cho chứng chỉ máy chủ tự ký/không đáng tin cậy
CB_OPERATIONAL_INSIGHTS_CLIENT_CERT_PATH--client-cert-pathChứng chỉ máy khách cho mTLS — PEM (kèm khóa) hoặc gói PKCS#12 (.p12/.pfx, không có khóa). Yêu cầu URL https://; ghi đè tên người dùng/mật khẩu
CB_OPERATIONAL_INSIGHTS_CLIENT_KEY_PATH--client-key-pathKhóa riêng (PEM) cho chứng chỉ máy khách. Để trống nếu dùng PKCS#12
CB_OPERATIONAL_INSIGHTS_CLIENT_CERT_PASSWORD--client-cert-passwordMật khẩu cho khóa được mã hóa hoặc gói PKCS#12
CB_MCP_OPERATIONAL_INSIGHTS_QUERY_RESULT_MAX_SIZE--operational-insights-query-result-max-sizeKích thước kết quả truy vấn tối đa tính bằng byte. Để trống nghĩa là không giới hạn. Khi được đặt, quá trình đọc dừng ở mức ngân sách và phản hồi báo truncated: true; hàng khiến vượt quá giới hạn sẽ không được trả về. Giá trị trên 4 MiB (4194304) được giới hạn ở 4 MiB, kèm cảnh báo trên stderr khi khởi động
CB_MCP_OPERATIONAL_INSIGHTS_ASYNC_QUERY_RESULT_TIMEOUT--operational-insights-async-query-result-timeoutThời gian chờ tính bằng giây cho mỗi yêu cầu truy vấn bất đồng bộ: bắt đầu truy vấn, kiểm tra trạng thái, lấy kết quả, loại bỏ và hủy. Với thao tác lấy kết quả, thời gian này áp dụng cho toàn bộ quá trình tải xuống, vì vậy kết quả mất nhiều thời gian hơn mức này để đọc sẽ gây lỗi. Tăng giá trị này cho kết quả lớn hoặc kết nối chậm. Số nguyên dương, mặc định là 30, tối đa 600. Giá trị lớn hơn được giới hạn ở 600 kèm cảnh báo; mọi giá trị không hợp lệ khác đều được ghi nhật ký dưới dạng cảnh báo và sử dụng 30

Mọi cấu hình chung đều áp dụng, với những điểm khác biệt sau so với máy chủ vận hành:

  • Cổng mặc định là 8001 và tệp nhật ký mặc định là mcp_server_operational_insights.log, để cả hai máy chủ có thể chạy song song.
  • Chỉ hỗ trợ một worker (CB_MCP_WORKERS=1), vì các handle truy vấn bất đồng bộ nằm trong bộ nhớ tiến trình.
  • Máy chủ này không có các tùy chọn CB_MCP_EMBEDDING_MODEL_*.

Công cụ Operational Insights

Tên của tất cả công cụ, ngoại trừ get_server_configuration_status, đều có tiền tố operational_insights_, để có thể đăng ký cả hai máy chủ trong cùng một client mà không bị trùng lặp. Công cụ ghi (được đánh dấu ✏️) không được tải khi chế độ chỉ đọc đang bật; đây là chế độ mặc định.

Trạng thái máy chủ

Công cụMô tả
get_server_configuration_statusCùng công cụ như trên máy chủ vận hành

Khám phá mô hình dữ liệu và lược đồ

Công cụMô tả
operational_insights_get_databases_in_clusterLiệt kê cơ sở dữ liệu
operational_insights_get_scopes_in_databaseLiệt kê các scope trong cơ sở dữ liệu
operational_insights_get_collections_in_scopeLiệt kê các collection (tập dữ liệu) trong một scope
operational_insights_get_schema_for_collectionSuy luận lược đồ JSON của collection bằng cách lấy mẫu

Truy vấn và chỉ mục

Công cụMô tả
operational_insights_list_indexesLiệt kê các chỉ mục phụ từ System.Metadata.Index
operational_insights_explain_queryChạy EXPLAIN cho câu lệnh SQL++ mà không thực thi
operational_insights_run_query_syncChạy SQL++ và trả về các hàng, tối đa bằng giới hạn kích thước kết quả; thay vào đó có thể xuất. Chế độ chỉ đọc được thực thi ở phía máy chủ
operational_insights_run_query_asyncBắt đầu truy vấn chạy lâu và trả về query_handle mà không chờ các hàng; cũng được ưu tiên cho các lần xuất lớn. Chế độ chỉ đọc được thực thi ở phía máy chủ
operational_insights_get_async_query_resultsThăm dò truy vấn bất đồng bộ; trả về các hàng (hoặc đích xuất) khi sẵn sàng
operational_insights_discard_async_query_resultsGiải phóng kết quả của truy vấn bất đồng bộ đã hoàn tất
operational_insights_cancel_async_queryDừng truy vấn bất đồng bộ vẫn đang chạy (được phép trong chế độ chỉ đọc)
operational_insights_create_index ✏️Tạo chỉ mục phụ thông qua CREATE INDEX

Truy vấn bất đồng bộ tuân theo quy trình bắt đầu → thăm dò → loại bỏ hoặc hủy: operational_insights_run_query_async trả về query_handle, operational_insights_get_async_query_results được thăm dò cho đến khi sẵn sàng, sau đó operational_insights_discard_async_query_results giải phóng kết quả, hoặc operational_insights_cancel_async_query dừng truy vấn vẫn đang chạy.

Xuất kết quả lớn

Thay vì trả về các hàng, operational_insights_run_query_sync và operational_insights_run_query_async có thể bọc câu lệnh trong COPY ... TO và ghi các hàng vào bộ lưu trữ đối tượng bên ngoài. Truyền đủ cả ba giá trị copy_to_link (một liên kết hiện có được tạo bằng CREATE LINK ... TYPE S3), copy_to_bucket và copy_to_path, cùng với copy_to_format nếu muốn (json, mặc định, hoặc parquet). Sau đó, công cụ trả về xác nhận mà không có hàng:

{
  "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. ..."
}
  • Đích không đầy đủ sẽ bị từ chối thay vì âm thầm trả về các hàng.
  • Công cụ đồng bộ chờ toàn bộ quá trình tải lên; nên dùng công cụ bất đồng bộ cho các lần xuất lớn.
  • Không thể xuất trong chế độ chỉ đọc (vì thao tác này ghi vào bộ lưu trữ bên ngoài), do đó cần CB_MCP_READ_ONLY_MODE=false hoặc token có couchbase-mcp:write.
  • Không cung cấp csv, vì công cụ này cần lược đồ đầu ra tường minh mà không thể suy luận từ một SELECT bất kỳ.

Cấu hình chung

Các thiết lập này hoạt động giống nhau trên cả hai máy chủ. Có thể đặt mỗi tùy chọn dưới dạng biến môi trường hoặc cờ CLI sau lệnh con.

Kiểm soát an toàn

Tuân theo các nguyên tắc bảo mật sau:

  • Cấp cho người dùng cơ sở dữ liệu quyền tối thiểu cần thiết — RBAC là ranh giới kiểm soát có thẩm quyền (xem bên dưới).
  • Chỉ cung cấp những công cụ mà tác nhân cần và tắt các công cụ còn lại — mọi công cụ được tải đều có thể được LLM gọi. Dùng chế độ chỉ đọc và CB_MCP_DISABLED_TOOLS để giữ danh sách công cụ ở mức tối thiểu.
  • Yêu cầu xác nhận đối với các công cụ nhạy cảm mà bạn giữ lại — xem Yêu cầu xác nhận.

Các biện pháp kiểm soát dưới đây tạo thành ba lớp, từ phạm vi rộng nhất đến hẹp nhất. Hãy kết hợp chúng — nhưng nhớ rằng không biện pháp nào thay thế được RBAC.

[!IMPORTANT] Quyền RBAC của người dùng cơ sở dữ liệu là biện pháp kiểm soát bảo mật có thẩm quyền. Ví dụ, việc tắt upsert_document_by_id và delete_document_by_id không ngăn run_sql_plus_plus_query chạy INSERT/UPDATE/DELETE/MERGE — chỉ chế độ chỉ đọc hoặc việc thiếu quyền RBAC mới ngăn được. Chỉ cấp cho người dùng cơ sở dữ liệu của máy chủ những quyền cần thiết.

Chế độ chỉ đọc

CB_MCP_READ_ONLY_MODE (mặc định là true) là công tắc duy nhất để kiểm soát thao tác ghi:

  • true — các công cụ ghi được đánh dấu ✏️ trong danh sách công cụ của từng máy chủ không được tải, và các truy vấn sửa đổi dữ liệu hoặc cấu trúc sẽ bị chặn.
  • false — các công cụ ghi được tải và cho phép truy vấn sửa đổi.

Tắt công cụ

CB_MCP_DISABLED_TOOLS loại bỏ hoàn toàn các công cụ khỏi danh sách khám phá. Tùy chọn này chấp nhận danh sách phân tách bằng dấu phẩy hoặc đường dẫn đến tệp có một tên công cụ trên mỗi dòng (# bắt đầu một chú thích):

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

Trên Capella, máy chủ vận hành cũng tự động tắt một số công cụ quản trị.

Yêu cầu xác nhận (elicitation)

CB_MCP_CONFIRMATION_REQUIRED_TOOLS yêu cầu người dùng xác nhận trước khi chạy công cụ được liệt kê, bằng MCP elicitation. Tùy chọn này chấp nhận cùng định dạng danh sách phân tách bằng dấu phẩy hoặc tệp như danh sách công cụ bị tắt:

CB_MCP_CONFIRMATION_REQUIRED_TOOLS="delete_document_by_id,replace_document_by_id"
  • Nếu client hỗ trợ elicitation, người dùng sẽ được nhắc xác nhận trước khi công cụ chạy.
  • Nếu không, công cụ sẽ chạy mà không cần xác nhận để tương thích ngược.
  • Xác nhận cần có phiên MCP, vì vậy không thể kết hợp với HTTP không trạng thái (CB_MCP_STATELESS_HTTP=true hoặc CB_MCP_WORKERS lớn hơn 1). Máy chủ sẽ từ chối khởi động với tổ hợp này. Khi chạy sau bộ cân bằng tải, xác nhận cần các phiên cố định — xem Bộ cân bằng tải.

Giao thức truyền tải

Giao thức truyền tảiDùng choEndpoint
stdio (mặc định)Một client cục bộ khởi chạy máy chủ dưới dạng tiến trình con—
httpNhiều client dùng chung một máy chủ; hỗ trợ OAuth, kiểm tra tình trạng và worker trên máy chủ vận hànhhttp://<host>:<port>/mcp

Đặt giao thức truyền tải bằng CB_MCP_TRANSPORT, địa chỉ bind bằng CB_MCP_HOST (mặc định là 127.0.0.1) và cổng bằng CB_MCP_PORT (cổng mặc định của từng máy chủ nếu không đặt). Nếu không có OAuth, endpoint HTTP không yêu cầu xác thực.

uvx couchbase-mcp-server operational \
  --connection-string='<couchbase_connection_string>' \
  --username='<database_username>' \
  --password='<database_password>' \
  --transport=http

Sau đó, trỏ client của bạn đến URL:

{
  "mcpServers": {
    "couchbase-http": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Nhiều worker

Một tiến trình sử dụng tối đa khoảng một lõi CPU. --workers N (CB_MCP_WORKERS) chạy N tiến trình trên cùng một máy chủ và cổng; số lõi khả dụng là điểm khởi đầu phù hợp. Chỉ máy chủ vận hành hỗ trợ worker. Khi có nhiều hơn một worker:

  • Bắt buộc dùng giao thức truyền tải http, và máy chủ chạy ở chế độ HTTP không trạng thái vì các yêu cầu của client có thể được chuyển đến các worker khác nhau. Bạn cũng có thể đặt --stateless-http=true trên một worker duy nhất, chẳng hạn khi chạy sau bộ cân bằng tải không có phiên cố định.
  • Không thể dùng các công cụ yêu cầu xác nhận.
  • Mỗi tiến trình ghi các tệp nhật ký riêng, được đặt tên theo máy chủ và ID tiến trình (mcp_server.<host>.<pid>.info.log) — một bộ cho tiến trình giám sát và một bộ cho mỗi worker.

Bộ cân bằng tải

Bạn có thể chạy nhiều phiên bản máy chủ phía sau một bộ cân bằng tải. Mỗi phiên bản lưu các phiên MCP trong bộ nhớ riêng, vì vậy thiết lập bộ cân bằng tải sẽ quyết định những gì có thể hoạt động:

Bộ cân bằng tảiThiết lập máy chủCông cụ yêu cầu xác nhận
Phiên cố định, định tuyến theo header yêu cầu Mcp-Session-IdMột worker, có trạng thái (mặc định)Được hỗ trợ
Không có phiên cố định--stateless-http=trueKhông được hỗ trợ — máy chủ từ chối khởi động nếu các công cụ này được cấu hình
  • Khi không có phiên cố định, một phiên bản có trạng thái sẽ từ chối mọi yêu cầu có phiên được tạo trên phiên bản khác. Trong trường hợp đó, hãy dùng chế độ không trạng thái.
  • Định tuyến theo header Mcp-Session-Id, không dùng cookie. Nhiều client MCP không lưu cookie.
  • Nếu một phiên bản khởi động lại hoặc chuyển đổi dự phòng, các phiên và mọi lời nhắc xác nhận đang chờ của phiên bản đó sẽ bị mất. Client phải bắt đầu phiên mới.
  • Các truy vấn bất đồng bộ của Operational Insights lưu query_handle trong bộ nhớ của phiên bản đã bắt đầu truy vấn, kể cả ở chế độ không trạng thái. Việc thăm dò, loại bỏ hoặc hủy truy vấn trên một phiên bản khác sẽ trả về Unknown query_handle. Hãy dùng các công cụ này với một phiên bản duy nhất hoặc với phiên cố định để mọi lệnh gọi đều đến phiên bản đã bắt đầu truy vấn. Chế độ không trạng thái không gửi Mcp-Session-Id, vì vậy cần một khóa liên kết khác, chẳng hạn địa chỉ IP của client.

Kiểm tra tình trạng

Ở chế độ HTTP, GET /health trả về {"status": "ok", "server": "<server>"} trên cổng MCP. Đây là kiểm tra khả năng hoạt động: không kết nối đến cụm (vì vậy sự cố cụm sẽ không khiến các container khỏe mạnh bị khởi động lại), không cần xác thực ngay cả khi bật OAuth và được phục vụ bởi mọi worker. Xem Docker để biết ví dụ về probe.

Ủy quyền OAuth 2.1

Với --transport=http, mỗi máy chủ có thể hoạt động như một máy chủ tài nguyên OAuth 2.1, xác thực JWT bearer dựa trên JWKS của nhà cung cấp danh tính. Cơ chế này hoạt động với mọi nhà cung cấp OAuth 2.1/OIDC công bố JWKS và không cấp token hay quản lý người dùng. Các thiết lập OAuth bị bỏ qua trên stdio.

  • OAuth chỉ được bật khi cả ba giá trị CB_MCP_OAUTH_JWT_JWKS_URI, CB_MCP_OAUTH_JWT_ISSUER và CB_MCP_OAUTH_JWT_AUDIENCE đều được đặt; nếu chỉ đặt một số giá trị, máy chủ sẽ không khởi động.
  • CB_MCP_OAUTH_MCP_BASE_URL cũng công bố Protected Resource Metadata theo RFC 9728 để client có thể tìm máy chủ ủy quyền.
  • Quyền truy cập được kiểm soát bằng hai scope trong claim scope/scp của token: couchbase-mcp:read (công cụ đọc) và couchbase-mcp:write (công cụ ghi). Để có toàn quyền truy cập, cần cả hai. Đổi tên chúng bằng CB_MCP_OAUTH_SCOPE_READ_LABEL / CB_MCP_OAUTH_SCOPE_WRITE_LABEL nếu IdP của bạn không thể phát ra các nhãn này. Cả hai máy chủ dùng chung các nhãn, vì vậy một cấu hình IdP áp dụng cho cả hai.
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>'

Xem tài liệu OAuth cho máy chủ vận hành và máy chủ Operational Insights để biết cách thiết lập IdP.

Ghi nhật ký

Theo mặc định, mỗi máy chủ ghi nhật ký vào stderr ở cấp độ info.

  • CB_MCP_LOG_LEVEL — off, error, warning, info (sự kiện vòng đời và lệnh gọi công cụ) hoặc debug.
  • CB_MCP_LOG_SINKS — stderr, file, hoặc cả hai. Với file, một tệp xoay vòng cho mỗi cấp độ được ghi bên cạnh CB_MCP_LOG_FILE (mcp_server.info.log, mcp_server.error.log, …).
  • Xoay vòng và lưu giữ — CB_MCP_LOG_ROTATION_MAX_SIZE_MB (mặc định 1 MB) và CB_MCP_LOG_RETENTION_BACKUP_COUNT (mặc định 1) áp dụng cho mọi cấp độ; ghi đè theo từng cấp độ bằng CB_MCP_LOG_<LEVEL>_ROTATION_MAX_SIZE_MB / CB_MCP_LOG_<LEVEL>_RETENTION_BACKUP_COUNT. Kích thước không hợp lệ sẽ dùng giá trị mặc định và đưa ra cảnh báo khi khởi động. CB_MCP_LOG_MAX_BYTES đã lỗi thời.
  • Ảnh chụp cấu hình — với sink file, một bản ghi JSON về môi trường và cấu hình máy chủ đã được biên tập sẽ được ghi vào mcp_server_config.log.json mỗi khi khởi động để hỗ trợ xử lý sự cố.
# Debug logging to stderr and rotating per-level files
uvx couchbase-mcp-server operational --log-level=debug --log-sinks=stderr,file

Ứng dụng MCP của bạn thường cũng thu thập stderr của máy chủ — xem Thiết lập ứng dụng khách để biết vị trí. Chi tiết: tài liệu ghi nhật ký cho máy chủ vận hành và máy chủ Operational Insights.

Kiểm tra nhật ký

Ghi nhật ký kiểm tra lưu lại ai đã làm gì và việc đó có được cho phép hay không — tách biệt với nhật ký vận hành, vốn ghi lại những gì đã xảy ra lỗi. Máy chủ MCP là lớp duy nhất có thể trả lời câu hỏi này đối với một tác nhân: mọi yêu cầu đều đến cụm dưới dạng một người dùng cơ sở dữ liệu duy nhất, còn các quyết định như từ chối phạm vi, chặn chỉ đọc hoặc từ chối xác nhận thì không bao giờ đến được cụm.

Ghi nhật ký kiểm tra mặc định tắt. Bật bằng CB_MCP_AUDIT_LOG_ENABLED=true; nhật ký được ghi vào stderr, trừ khi bạn đặt CB_MCP_AUDIT_LOG_SINKS=file và CB_MCP_AUDIT_LOG_FILE_PATH.

# 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

Các bản ghi dùng định dạng JSON Lines với cùng hệ thống trường như Couchbase Server và Sync Gateway:

{"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"}
Cách thức hoạt động của ghi nhật ký kiểm tra
  • Danh tính — real_userid là bên gọi: oauth (chủ thể của token), local (người dùng hệ điều hành, trên stdio) hoặc anonymous (HTTP không có OAuth, sẽ đưa ra cảnh báo khi khởi động).
  • Tương quan — cid nhóm mọi bản ghi từ một yêu cầu và được gửi dưới dạng client_context_id của SQL++, nhờ đó khớp chính xác với clientContextId của Couchbase Server. Cố ý không có mã định danh phiên.
  • Sự kiện — danh mục cố định, được đánh số (vòng đời, khởi tạo, token bị từ chối, phạm vi bị từ chối, chặn chỉ đọc, xác nhận bị từ chối/bỏ qua và một cặp đọc/ghi cho mỗi danh mục công cụ). query và search là ngoại lệ: mỗi mục được ghi thành một sự kiện duy nhất thay vì một cặp đọc/ghi, vì không thể phân biệt một cách đáng tin cậy đối với các bề mặt dựa trên câu lệnh và tìm kiếm. Các thao tác vector thuộc hai danh mục đó. Danh mục đầy đủ được đóng gói dưới dạng descriptor.json. Máy chủ vận hành dùng khối 0xF000 (61440), Operational Insights dùng 0x10000 (65536), và cả hai dùng chung 0xE000 (57344) cho các sự kiện cốt lõi.
  • Lọc — CB_MCP_AUDIT_LOG_DISABLED_EVENTS loại bỏ các sự kiện đọc theo mã số (ví dụ: 61490,61492). Không thể tắt các sự kiện ghi và bảo mật, cũng như các danh mục chỉ có một sự kiện query (61507, hoặc 65603 trên Operational Insights) và search (61510): mỗi sự kiện bao quát cả thao tác ghi lẫn đọc của danh mục đó, nên tắt sự kiện sẽ làm mất bản ghi về thao tác thay đổi.
  • Xoay vòng — theo kích thước (CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB, mặc định 10) và thời gian (CB_MCP_AUDIT_LOG_ROTATION_INTERVAL, mặc định 1d), tùy điều kiện nào đến trước; 0 sẽ tắt một trong hai. Các tệp đã xoay vòng được gắn dấu thời gian và nén bằng gzip; tệp hiện hành vẫn là văn bản thuần để tail -f.
  • Tệp riêng cho từng tiến trình — máy chủ và pid được chèn vào tên (audit.log → audit.<host>.<pid>.log), vì vậy các tiến trình chạy đồng thời không bao giờ dùng chung một tệp.
  • Lưu giữ theo từng tệp — CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS (mặc định 10) giới hạn số bản sao lưu của một tệp. Mỗi tiến trình mới ghi vào một tệp mới và không xóa các tệp cũ, vì vậy hãy cấp dung lượng phù hợp cho ổ đĩa hoặc dọn các tệp audit.*.log* cũ.
  • Tiếp tục hoạt động khi lỗi — nếu không thể ghi tệp, máy chủ vẫn tiếp tục phục vụ và đếm số bản ghi bị mất; get_server_configuration_status báo cáo written / dropped / write_errors.
  • Đối số công cụ — chỉ được ghi khi có CB_MCP_AUDIT_LOG_TOOL_ARGS=true, tùy chọn này sẽ đưa ra cảnh báo khi khởi động. Bản phát hành này không có chức năng biên tập, vì vậy các đối số, bao gồm toàn bộ nội dung tài liệu, được ghi nguyên văn.

Thiết lập ứng dụng khách

Mỗi ứng dụng khách cần cấu hình máy chủ từ hướng dẫn bắt đầu nhanh của máy chủ vận hành hoặc máy chủ Operational Insights tại vị trí cấu hình riêng. Các ví dụ dưới đây dùng máy chủ vận hành.

Claude Desktop
  1. Mở tệp cấu hình (xem hướng dẫn bắt đầu nhanh MCP):
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Thêm máy chủ bên dưới mcpServers rồi khởi động lại Claude Desktop.

Nhật ký: macOS ~/Library/Logs/Claude, Windows %APPDATA%\Claude\Logs. Xem hướng dẫn khắc phục sự cố MCP.

Cursor
  1. Vào Cursor Settings > Tools & Integrations > MCP Tools (xem tài liệu MCP của Cursor), hoặc dùng liên kết Cài đặt trong Cursor chỉ bằng một cú nhấp — sau đó thay chuỗi kết nối và thông tin xác thực mẫu.
  2. Thêm cấu hình bên dưới mcpServers rồi lưu.
  3. Làm mới danh sách máy chủ MCP để kiểm tra couchbase đã được bật.

Nhật ký: trong bảng điều khiển phía dưới, mở Output và chọn Cursor MCP.

Windsurf Editor
  1. Mở Command Palette > Windsurf MCP Configuration Panel, hoặc Windsurf Settings > Advanced > Cascade > Model Context Protocol (MCP) Servers (xem tài liệu MCP của Windsurf).
  2. Nhấp Add Server > Add custom server, dán cấu hình rồi lưu.
  3. Làm mới danh sách máy chủ để kiểm tra couchbase đã được bật.
VS Code

VS Code dùng servers làm khóa cấp cao nhất thay vì mcpServers. Đặt cấu hình trong .vscode/mcp.json cho một không gian làm việc, hoặc chạy MCP: Open User Configuration để áp dụng cho mọi không gian làm việc (xem tài liệu MCP của VS Code):

{
  "servers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server", "operational"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password"
      }
    }
  }
}

Lưu tệp sẽ khởi động máy chủ; dùng các thao tác Running | Stop | n Tools phía trên để quản lý máy chủ.

Nhật ký: chạy MCP: List Servers, chọn couchbase, rồi chọn Show Output.

JetBrains IDEs
  1. Cài plugin AI Assistant hoặc Junie.
  2. Vào Settings > Tools > AI Assistant (or Junie) > MCP Server, nhấp +, thêm cấu hình rồi nhấp Apply.
  3. Di chuột lên trạng thái máy chủ để xem các công cụ của máy chủ.

Nhật ký: Help > Show Log in Finder (Explorer) > mcp > couchbase.

Docker

Các image dựng sẵn được phát hành lên Docker Hub dưới tên couchbase/mcp-server, và máy chủ được liệt kê trong Docker MCP Catalog. Cấu hình container bằng các biến môi trường như trên. Xem trang Docker Hub (DOCKER.md) để biết ví dụ về tag, volume và kiểm tra tình trạng hoạt động.

Chạy qua HTTP — lưu ý máy chủ phải bind vào 0.0.0.0 để có thể truy cập từ bên ngoài container:

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
  • Nếu Couchbase chạy trên máy chủ của bạn, hãy dùng couchbase://host.docker.internal làm chuỗi kết nối (xem kết nối mạng Docker). Dùng --network=<your_network> để tham gia mạng của một container khác.
  • Thêm operational-insights thay cho operational để chạy máy chủ Operational Insights (cổng 8001).
Dựng image từ mã nguồn
docker build -t mcp/couchbase-src .

./build.sh [image-name] dựng image với cùng các đối số như CI — lệnh này đặt các đối số dựng GIT_COMMIT_HASH và BUILD_DATE, đồng thời gắn tag cho image là latest và <short-commit> (tên mặc định mcp/couchbase-src). Để tự dựng với các nhãn:

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

Khắc phục sự cố

Để xem hướng dẫn đầy đủ, hãy tham khảo tài liệu khắc phục sự cố cho máy chủ vận hành và máy chủ Operational Insights, cùng hướng dẫn bảo mật cho máy chủ vận hành và máy chủ Operational Insights. Các bước kiểm tra nhanh:

  • Kiểm tra chuỗi kết nối, tên người dùng/mật khẩu hoặc đường dẫn chứng chỉ.
  • Với Capella, hãy đảm bảo cụm cho phép kết nối từ máy đang chạy máy chủ.
  • Đảm bảo người dùng cơ sở dữ liệu có thể truy cập ít nhất một bucket.
  • Nếu ứng dụng khách không tìm thấy uv/uvx, hãy đặt đường dẫn tuyệt đối trong command.
  • Khi chạy từ mã nguồn, hãy kiểm tra đường dẫn kho lưu trữ trong cấu hình và chạy uv sync sau khi kéo các bản cập nhật.
  • Gọi get_server_configuration_status để xem cấu hình mà máy chủ thực sự đã phân giải, đồng thời kiểm tra nhật ký của ứng dụng khách (xem Thiết lập ứng dụng khách).

Câu hỏi thường gặp

Làm cách nào để kết nối Claude Desktop với Couchbase? Thêm cấu hình bắt đầu nhanh vào claude_desktop_config.json rồi khởi động lại Claude Desktop — xem Thiết lập ứng dụng khách.

Tôi có thể dùng ứng dụng này với Couchbase Capella không? Có, với máy chủ vận hành: cùng một cấu hình dùng được cho Capella và các cụm tự quản lý, dù một số công cụ quản trị chỉ có trên các cụm tự quản lý (xem Công cụ). Máy chủ Operational Insights chỉ dành cho các cụm Operational Insights tự quản lý.

Cho phép tác nhân AI ghi vào cơ sở dữ liệu có an toàn không? Theo mặc định là không: không có công cụ ghi nào được tải và các câu lệnh SQL++ sửa đổi bị chặn. Nếu bật chức năng ghi, bạn vẫn có thể tắt từng công cụ hoặc yêu cầu xác nhận — nhưng quyền RBAC của người dùng Couchbase vẫn là ranh giới bảo mật thực sự. Xem Kiểm soát an toàn.

Tôi có cần biết SQL++ không? Không. Hãy hỏi bằng ngôn ngữ thông thường, trợ lý sẽ viết SQL++ cho run_sql_plus_plus_query. Trợ lý cũng có thể giải thích kế hoạch truy vấn hoặc yêu cầu Index Advisor đưa ra đề xuất.

STDIO hay Streamable HTTP? Dùng STDIO cho một ứng dụng khách cục bộ. Dùng Streamable HTTP để chia sẻ một máy chủ giữa nhiều ứng dụng khách, với OAuth. Xem Giao thức truyền tải.

Couchbase có chính thức hỗ trợ ứng dụng này không? Có, nếu có giấy phép Couchbase AI Data Plane. Nếu không có giấy phép, các kỹ sư Couchbase sẽ hỗ trợ theo khả năng thông qua các vấn đề trên GitHub. Xem Chính sách hỗ trợ.

Đóng góp

Chúng tôi hoan nghênh các đóng góp — sửa lỗi, tính năng và tài liệu. Để báo lỗi hoặc yêu cầu trợ giúp, hãy mở vấn đề trên GitHub.

Xem CONTRIBUTING.md để biết cách thiết lập môi trường phát triển, lint, kiểm thử, cấu trúc dự án và quy trình làm việc. Bắt đầu như sau:

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

Kiểm thử tích hợp chạy trên một cụm đang hoạt động. Xuất CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD và tùy chọn CB_MCP_TEST_BUCKET; các bài kiểm thử Operational Insights cũng dùng CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING / _USERNAME / _PASSWORD và sẽ bị bỏ qua nếu các biến này chưa được đặt. Sau đó chạy:

uv run --extra dev pytest tests/integration -v

Dữ liệu sử dụng, rủi ro LLM và chính sách hỗ trợ

Thu thập dữ liệu sử dụng

Sản phẩm này tự động thu thập dữ liệu về mức sử dụng và hiệu suất (chẳng hạn như tên và phiên bản sản phẩm) cùng thông tin trình duyệt (chẳng hạn như địa chỉ IP) (gọi chung là "Dữ liệu sử dụng"). Couchbase sử dụng Dữ liệu sử dụng cùng với các dữ liệu khác mà bạn có thể cung cấp cho Couchbase (chẳng hạn như tên người dùng hoặc địa chỉ email) để phát triển và cải thiện sản phẩm, đồng thời hỗ trợ các chương trình bán hàng và tiếp thị. Chúng tôi không truy cập hoặc thu thập bất kỳ dữ liệu nào bạn lưu trữ trong các sản phẩm Couchbase. Chúng tôi sử dụng Dữ liệu sử dụng để hiểu các kiểu sử dụng tổng thể và giúp sản phẩm hữu ích hơn cho bạn. Để biết thêm thông tin về cách Couchbase thu thập, bảo vệ và xử lý thông tin, vui lòng tham khảo Chính sách quyền riêng tư của Couchbase tại https://www.couchbase.com/privacy-policy.

Rủi ro liên quan đến LLM

  • Việc sử dụng các mô hình ngôn ngữ lớn và công nghệ tương tự tiềm ẩn rủi ro, bao gồm khả năng tạo ra kết quả không chính xác hoặc có hại.
  • Couchbase không xem xét hoặc đánh giá chất lượng hay độ chính xác của những kết quả đó, và chúng có thể không phản ánh quan điểm của Couchbase.
  • Bạn hoàn toàn chịu trách nhiệm quyết định có sử dụng mô hình ngôn ngữ lớn và công nghệ liên quan hay không, cũng như tuân thủ mọi điều khoản cấp phép, điều khoản sử dụng và chính sách của tổ chức chi phối việc sử dụng các công nghệ này.

Chính sách hỗ trợ

Couchbase MCP Server là mã nguồn mở và được các kỹ sư Couchbase duy trì. Cách bạn nhận trợ giúp tùy thuộc vào cách bạn sử dụng sản phẩm:

  • Sử dụng cộng đồng — báo cáo lỗi, đặt câu hỏi và yêu cầu tính năng bằng cách mở vấn đề trên GitHub. Các kỹ sư Couchbase theo dõi kho lưu trữ và phản hồi trong khả năng tốt nhất, nhưng không cam kết thời gian phản hồi. Cổng hỗ trợ Couchbase không thể trợ giúp cho việc sử dụng cộng đồng.
  • Hỗ trợ doanh nghiệp — có sẵn khi cấp phép Couchbase AI Data Plane, gói này cũng bao gồm Couchbase Agent Memory và Couchbase Agent Catalog. Khách hàng có giấy phép nhận hỗ trợ thông qua các kênh Couchbase Support thông thường.

Cảm ơn bạn đã sử dụng và đóng góp cho dự án!