Couchbase
offiziellInteragieren Sie mit den in Couchbase-Clustern gespeicherten Daten mithilfe natürlicher Sprache.
Was kann man mit Couchbase MCP machen?
- Clusterdaten erkunden — Buckets, Scopes und Collections auflisten und anschließend das Schema einer Collection wie
ordersableiten. - SQL++-Abfragen ausführen — Schreibgeschützte SQL++-Abfragen für einen Bucket und Scope ausführen und Abfragepläne erläutern.
- Dokumente untersuchen — Ein Dokument anhand seiner ID abrufen oder bestimmte Unterdokumentpfade lesen, ohne das gesamte Dokument zu laden.
- Clusterzustand prüfen — Clusterzustand, laufende Dienste und Verbindungsdiagnosen melden.
- Abfrageleistung analysieren — Abfragen mit der längsten Laufzeit, der höchsten Häufigkeit oder ohne abdeckenden Index finden.
- Such- und Vektorabfragen — Volltextsuche und Vektorähnlichkeitsabfragen für konfigurierte Indizes ausführen.
Dokumentation
Couchbase MCP Server
Couchbase MCP Server ist ein selbst gehosteter MCP Server, der KI-Agenten die Verbindung zu Daten in Couchbase Servern (gehostet auf Capella oder selbst verwaltet) oder Operational Insights Enterprise und deren Nutzung ermöglicht. Er stellt Tools in Kategorien wie Clusterzustand, Datenschema, Abfragen und mehr bereit – mit Sicherheitskontrollen durch den schreibgeschützten Modus und die gezielte Deaktivierung von Tools. Er unterstützt sowohl STDIO- als auch Streamable-HTTP-Transporte mit OAuth-Funktionen.
Couchbase MCP Server wird als Python-Package-Index-Paket (PyPI) und über Docker bereitgestellt. Enterprise-Support für Couchbase MCP Server ist durch die Lizenzierung von Couchbase AI Data Plane verfügbar. Diese berechtigt außerdem zur Nutzung von Couchbase Agent Memory und Couchbase Agent Catalog sowie zum Enterprise-Support dafür.
Vollständige Dokumentation: docs.couchbase.com/mcp-server
Inhaltsverzeichnis
- Warum Couchbase MCP Server
- Server auswählen
- Operational Server
- Operational Insights Server
- Allgemeine Konfiguration
- Client einrichten
- Docker
- Fehlerbehebung
- FAQ
- Mitwirken
- Nutzungsdaten, LLM-Risiken und Support-Richtlinie
Warum Couchbase MCP Server
- Standardmäßig sicher — Schreibtools werden nicht geladen und datenverändernde Abfragen werden blockiert, sofern Sie
CB_MCP_READ_ONLY_MODE=falsenicht festlegen. Einzelne Tools können außerdem deaktiviert oder von einer Benutzerbestätigung abhängig gemacht werden. - Couchbase Server und Operational Insights — Der Operational Server verbindet sich mit Couchbase Capella oder einem selbst verwalteten Couchbase-Server-Cluster mit derselben Konfiguration. Der Operational Insights Server verbindet sich mit selbst verwalteten Operational-Insights-Clustern.
- RBAC-bewusst — Die Tool-Steuerungen geben dem LLM Orientierung; die rollenbasierte Zugriffskontrolle des Couchbase-Benutzers bleibt die maßgebliche Sicherheitsgrenze.
- Transporte für den Produktionseinsatz — STDIO für lokale Desktop-Clients oder Streamable HTTP mit optionalem OAuth 2.1 (beliebiger IdP mit JWKS-Veröffentlichung: Auth0, Okta, Keycloak, Entra, Cognito, …), Zustandsprüfungen und Audit-Protokollierung für gemeinsam genutzte Bereitstellungen. Der Operational Server kann außerdem mehrere Worker ausführen, um mehr CPU-Kerne zu nutzen.
- Beliebiger MCP-Client — Getestet mit Claude Desktop, Cursor, Windsurf, VS Code und JetBrains AI Assistant/Junie.
Nach der Verbindung können Sie beispielsweise Folgendes fragen:
- „Welche Buckets, Scopes und Collections habe ich, und wie sieht das Schema der Collection
ordersaus?“ - „Finde die 10 neuesten Dokumente in
users, für diestatus = 'active'gilt.“ - „Was sind die 5 langsamsten Abfragen der letzten Stunde, und fehlt bei einer davon ein abdeckender Index?“
- „Ist dieser Cluster gesund, und welche Dienste laufen?“
- „Füge ein neues Dokument mit diesen Feldern in
productsein: …“ (erfordertCB_MCP_READ_ONLY_MODE=false)
Server auswählen
Dieses Paket enthält zwei MCP-Server. Jeder wird mit einem eigenen Unterbefehl gestartet, verbindet sich mit einem anderen Clustertyp und verfügt über eigene Tools. Wählen Sie den Server passend zu Ihrem Cluster aus, folgen Sie dem entsprechenden Abschnitt zur Einrichtung und zu den Tools und verwenden Sie anschließend Allgemeine Konfiguration für die gemeinsamen Einstellungen. Wenn Sie beide verwenden möchten, registrieren Sie sie in Ihrem MCP-Client als separate Server.
| Operational Server | Operational Insights Server | |
|---|---|---|
| Verwendung mit | Einem Couchbase-Cluster (Capella oder selbst verwaltet) | Einem selbst verwalteten Operational-Insights-Cluster (nicht auf Capella verfügbar) |
| Unterbefehl | operational (Standard) | operational-insights |
| Verbindungszeichenfolge | couchbase:// / couchbases:// | HTTP(S)-URL, z. B. http://localhost:8095 |
| Anmeldeinformationsvariablen | CB_CONNECTION_STRING, CB_USERNAME, … | CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING, CB_OPERATIONAL_INSIGHTS_USERNAME, … |
| Tools | 52 — Clusterzustand, Schema, KV, SQL++, Indizes, Volltext- und Vektorsuche, Abfrageleistung | 13 — Schema, SQL++ (synchron und asynchron), Indizes, Exporte |
| Standard-HTTP-Port | 8000 | 8001 |
| Standard-Protokolldatei | mcp_server.log | mcp_server_operational_insights.log |
Der Unterbefehl ist für den Operational Server derzeit optional — ein einfaches
couchbase-mcp-serverstartet ihn —, aber seine Angabe sorgt für eine eindeutige Konfiguration. Optionen folgen auf den Unterbefehl:couchbase-mcp-server operational --transport=http. Prüfen Sie die installierte Version mituvx couchbase-mcp-server --version.
Operational Server
Der Server operational verbindet sich mithilfe des Python-SDKs couchbase mit einem Couchbase-Cluster auf Capella oder einem selbst verwalteten Couchbase Server.
Schnellstart für Operational
Sie benötigen einen laufenden Couchbase-Cluster — die kostenlose Capella-Stufe ist der schnellste Weg, einen einzurichten (Sie können einen Beispieldatensatz importieren) — und einen MCP-Client. Fügen Sie eine dieser Konfigurationen zu Ihrem Client hinzu (unter Client einrichten erfahren Sie, wo die einzelnen Clients ihre Konfiguration speichern). Wenn der Client bereits andere Server enthält, fügen Sie couchbase zum vorhandenen Objekt mcpServers hinzu.
Von PyPI mit uvx (erfordert uv und Python 3.11+):
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": ["couchbase-mcp-server", "operational"],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password"
}
}
}
}
Mit Docker (erfordert nur 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"
]
}
}
}
Aus dem Quellcode
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/ ist der Pfad zu Ihrem Klon — den abschließenden Schrägstrich beibehalten. Führen Sie nach dem Abrufen von Aktualisierungen uv sync aus, um die Abhängigkeiten zu aktualisieren.
Verbindung und Authentifizierung für Operational
Verwenden Sie entweder einen Benutzernamen und ein Passwort oder ein Clientzertifikat (mTLS). Wenn beides festgelegt ist, wird das Zertifikat verwendet.
| Umgebungsvariable | CLI-Argument | Beschreibung |
|---|---|---|
CB_CONNECTION_STRING | --connection-string | Verbindungszeichenfolge zum Cluster. Erforderlich |
CB_USERNAME / CB_PASSWORD | --username / --password | Basisauthentifizierung |
CB_CLIENT_CERT_PATH / CB_CLIENT_KEY_PATH | --client-cert-path / --client-key-path | mTLS-Authentifizierung |
CB_CA_CERT_PATH | --ca-cert-path | Stammzertifikat für ein selbst signiertes/nicht vertrauenswürdiges Serverzertifikat (für Capella nicht erforderlich) |
mTLS-Beispiel
{
"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-Tools
Schreibtools (mit ✏️ gekennzeichnet) werden im standardmäßig aktivierten schreibgeschützten Modus nicht geladen. Mit 🖥️ gekennzeichnete Tools sind nur für selbst verwaltete Installationen verfügbar — sie verwenden Admin-REST-Endpunkte, die Capella nicht bereitstellt, oder (discover_tool_input_values) liefern lediglich Referenzdaten für ein solches Tool — und erfordern daher Couchbase Server 7.6+ in einer selbst verwalteten Installation. Sie werden bei Capella-Verbindungen nicht registriert.
Cluster-Einrichtung und -Zustand
| Tool | Beschreibung |
|---|---|
get_server_configuration_status | Serverstatus und -konfiguration ohne Verbindung zum Cluster: schreibgeschützter Modus, deaktivierte/bestätigungspflichtige Tools, OAuth, Protokollierung und Audit-Zähler |
test_cluster_connection | Cluster-Anmeldedaten durch Verbindung zum Cluster überprüfen |
get_cluster_health_and_services | Clusterzustand und laufende Dienste, optional gefiltert über service_types |
get_client_connectivity_report | Zwischengespeicherte Verbindungsdiagnosen des SDK ohne aktive Netzwerkprüfung |
get_cluster_metrics 🖥️ | Clusterstatistiken über einen historischen Zeitraum (stats-range-Endpunkt) |
get_cluster_tasks 🖥️ | Aktuell laufende Aufgaben — Rebalance, Komprimierung, XDCR, Indexerstellung. Erfordert ro_admin |
get_cluster_health_snapshot 🖥️ | Zustand pro Knoten: Diensttopologie, Mitgliedschaft, Orchestrator und eine zusammengefasste Zustandsübersicht. Erfordert ro_admin |
get_bucket_config 🖥️ | Konfiguration und Live-Status eines oder aller Buckets — Kontingente, Eviction, Replikate, Dauerhaftigkeit, Speicher, Komprimierung. Erfordert ro_admin |
get_cluster_system_events 🖥️ | Systemereignisprotokoll (Konfigurationsänderungen, Failover, Rebalances, Neustarts), zeitlich begrenzt mit since_time. Erfordert Full Admin oder Cluster Admin |
discover_tool_input_values 🖥️ | Exakte Eingabewerte nachschlagen, die andere Tools benötigen (z. B. alle Metriknamen für get_cluster_metrics). Funktioniert offline |
Datenmodell und Schemaermittlung
| Tool | Beschreibung |
|---|---|
get_buckets_in_cluster | Alle Buckets im Cluster auflisten |
get_scopes_in_bucket | Alle Scopes in einem Bucket auflisten |
get_collections_in_scope | Alle Collections in einem Scope auflisten (erfordert den Query-Dienst) |
get_scopes_and_collections_in_bucket | Alle Scopes und Collections in einem Bucket auflisten |
get_schema_for_collection | Struktur einer Collection ableiten |
create_scope ✏️ | Einen Scope in einem Bucket erstellen (Server 7.6+ und Capella) |
create_collection ✏️ | Eine Collection in einem vorhandenen Scope erstellen (Server 7.6+ und Capella) |
delete_scope ✏️ | Einen Scope und alle zugehörigen Collections löschen — dauerhaft |
delete_collection ✏️ | Eine Collection und alle zugehörigen Dokumente löschen — dauerhaft |
Dokumentoperationen (KV)
| Tool | Beschreibung |
|---|---|
get_document_by_id | Ein Dokument anhand seiner ID abrufen |
lookup_subdocument | Bestimmte Pfade, Existenzprüfungen oder Anzahlen lesen, ohne das gesamte Dokument abzurufen |
upsert_document_by_id ✏️ | Ein Dokument anhand seiner ID per Upsert speichern |
insert_document_by_id ✏️ | Ein neues Dokument einfügen (schlägt fehl, wenn es bereits existiert) |
replace_document_by_id ✏️ | Ein vorhandenes Dokument ersetzen (schlägt fehl, wenn es nicht existiert) |
delete_document_by_id ✏️ | Ein Dokument anhand seiner ID löschen |
mutate_subdocument ✏️ | Pfade in einem vorhandenen Dokument ändern (Upsert, Einfügen, Ersetzen, Entfernen, Array-Operationen, Zähler) |
Abfragen und Indizierung
| Tool | Beschreibung |
|---|---|
run_sql_plus_plus_query | Eine SQL++-Abfrage ausführen, die auf einen Bucket und Scope beschränkt ist — Collection-Namen direkt verwenden (SELECT * FROM users). Datenverändernde Anweisungen werden im schreibgeschützten Modus blockiert |
explain_sql_plus_plus_query | Einen EXPLAIN-Plan erstellen und auswerten: Metadaten, extrahierter Plan und Ergebnisse |
get_index_advisor_recommendations | Empfehlungen des Index Advisors für eine SQL++-Abfrage |
list_indexes | Indizes mit Definitionen auflisten, filterbar nach Bucket/Scope/Collection/Name; Vektorindizes kennzeichnen (is_vector, vector_type) |
get_index_stats 🖥️ | Größe, Fragmentierung, Scan-Verkehr und Verzögerung pro Index und Knoten — erkennt Engpässe und ungenutzte Indizes |
create_query_index ✏️ | Einen skalaren, Hyperscale-Vektor- oder zusammengesetzten Vektor-GSI-Index erstellen (index_type). Standardmäßig zurückgestellt — anschließend build_index ausführen |
create_index ✏️ | Veraltet — verwenden Sie create_query_index. In Version 2.0 entfernt |
build_index ✏️ | Alle zurückgestellten Indizes einer Collection erstellen |
drop_index ✏️ | Einen GSI-Index (skalar oder Vektor) löschen |
Volltextsuche (FTS)
Erfordert Couchbase Server 7.6+ und den Search-Dienst. Sowohl Scope-Indizes als auch Cluster-Indizes (Legacy) werden unterstützt: Für Scope-Indizes bucket_name und scope_name gemeinsam übergeben oder beide weglassen.
| Tool | Beschreibung |
|---|---|
list_search_indexes | Search-Indizes auflisten — auf Clusterebene, pro Bucket oder pro Scope |
get_search_index_definition | Vollständige Definition eines Search-Index (Mappings, Analyzer, Planparameter) |
run_search | Beliebige Nicht-Vektor-FTS-Abfrage anhand ihres rohen JSON-Bodys ausführen; explain=true gibt den Ausführungsplan zurück |
upsert_search_index ✏️ | Einen Search-Index erstellen oder aktualisieren, einschließlich Vektorfeld-Mappings. Aktualisierungen lösen einen vollständigen Neuaufbau aus — übergib den aktuellen Wert von uuid, um gleichzeitige Änderungen nicht zu überschreiben |
drop_search_index ✏️ | Einen Search-Index löschen — dauerhaft |
Vektorsuche
Beide Tools betten einfachen Abfragetext mit dem unter Embedding Providers konfigurierten Modell ein. Verfügbar auf selbstverwaltetem Couchbase Server und Capella.
| Tool | Beschreibung |
|---|---|
run_vector_query | Ähnlichkeitssuche über einen GSI-Vektorindex (Server 8.0+) mit APPROX_VECTOR_DISTANCE(). Der Index wird automatisch ausgewählt; unterstützt einen SQL++-Vorfilter where und Hyperscale-Tuning (num_probes, rerank, top_n_scan). Gibt vollständige Dokumente zurück |
run_vector_search | Vektorsuche über den Search Service (Server 7.6+) anhand eines benannten Index. scalar_query macht sie hybrid; prefilter schränkt zuerst die Kandidaten ein. Gibt die im Index gespeicherten Felder pro Treffer zurück |
Analyse der Abfrageleistung
| Tool | Beschreibung |
|---|---|
get_longest_running_queries | Abfragen mit der längsten durchschnittlichen Dienstzeit |
get_most_frequent_queries | Am häufigsten ausgeführte Abfragen |
get_queries_with_largest_response_sizes | Abfragen mit den größten Antwortgrößen |
get_queries_with_large_result_count | Abfragen mit den meisten Ergebnissen |
get_queries_using_primary_index | Abfragen, die einen Primärindex verwenden |
get_queries_not_using_covering_index | Abfragen, die keinen abdeckenden Index verwenden |
get_queries_not_selective | Abfragen, deren Scans — Sekundärindex, Primärindex oder sequenziell — deutlich mehr Dokumente zurückgeben als das Endergebnis |
Zustand des Query Service 🖥️
Diese Tools rufen bei jeder Abfrage die eigene Admin-REST-API des Query Service auf jedem Query-Knoten auf.
| Tool | Beschreibung |
|---|---|
get_cluster_query_vitals | Zustand der Query Engine: Anfragerate, aktive/eingereihte Anfragen, Arbeitsspeicher, GC, Betriebszeit. Erfordert ro_admin |
get_active_queries | Abfragen, die gerade auf allen Query-Knoten ausgeführt werden. Erfordert ro_admin |
delete_active_query ✏️ | Eine laufende Abfrage anhand der Request-ID abbrechen. Erfordert Full Admin oder Cluster Admin |
Auf Capella automatisch deaktivierte Tools
Die 🖥️-Tools greifen über Admin-REST-Endpunkte auf Couchbase zu, die Capella nicht bereitstellt (die einzige Ausnahme, discover_tool_input_values, wird zurückgehalten, da sie nur ein Tool bereitstellt, das diese Endpunkte benötigt). Wenn alle Hosts in CB_CONNECTION_STRING mit .cloud.couchbase.com enden, registriert der Server diese Tools nicht und führt sie zusammen mit deinen eigenen deaktivierten Tools in get_server_configuration_status und im Startprotokoll auf. SDK-basierte Tools wie get_cluster_health_and_services und get_client_connectivity_report bleiben verfügbar.
| Tool | Benötigter Endpunkt |
|---|---|
get_cluster_metrics | Management-REST (/pools/default/stats/range) |
get_cluster_tasks | Management-REST (/pools/default/tasks) |
get_bucket_config | Management-REST (/pools/default/buckets[/<name>]) |
get_cluster_health_snapshot | Management-REST sowie knotenbezogene Endpunkte |
get_cluster_system_events | Management-REST (/events) |
get_index_stats | Index-Service-REST (jeweils /api/v1/stats des Indexers) |
get_cluster_query_vitals | Query-Service-REST (/admin/vitals) |
get_active_queries | Query-Service-REST (/admin/active_requests) |
delete_active_query | Query-Service-REST (DELETE /admin/active_requests/{id}) |
discover_tool_input_values | Keine (funktioniert offline), stellt aber nur get_cluster_metrics bereit, das Capella nicht bietet |
Embedding Providers
run_vector_query und run_vector_search betten Abfragetext mit dem in CB_MCP_EMBEDDING_MODEL_PROVIDER festgelegten Anbieter ein. Dies ist optional: Ohne diese Einstellung startet der Server normal und beide Tools bleiben registriert, aber bei ihrem Aufruf wird ein Fehler ausgegeben, der erklärt, was festgelegt werden muss.
CB_MCP_EMBEDDING_MODEL_PROVIDER | Erforderlich | Optional | Hinweise |
|---|---|---|---|
capella | CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL, CB_MCP_EMBEDDING_MODEL_ENDPOINT | — | Capella Model Service. CB_MCP_EMBEDDING_MODEL_ENDPOINT ist die eigene URL deiner Bereitstellung (z. B. https://<id>.ai.couchbase.com) unter Capellas AI Data Plane > Models |
openai | CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL | CB_MCP_EMBEDDING_MODEL_ENDPOINT | Lege den Endpunkt fest, um einen lokalen OpenAI-kompatiblen Server zu verwenden (Ollama, vLLM, LM Studio) |
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-Embedding-Modelle (z. B. amazon.titan-embed-text-v2:0) — der Anbieter sendet Titans inputText-Anfrageformat, daher werden andere Bedrock-Embedding-Modelle wie Cohere Embed noch nicht unterstützt. Lass die Anmeldedaten weg, um die standardmäßige AWS-Chain zu verwenden. Erfordert zusätzlich: 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-..."
}
Alle Optionen
Alle Umgebungsvariablen und CLI-Flags für den operational-Server
Der Operational Insights-Server akzeptiert dieselben Optionen, außer dass er eigene Verbindungseinstellungen und keine CB_MCP_EMBEDDING_MODEL_*-Optionen hat.
| Umgebungsvariable | CLI-Argument | Beschreibung | Standardwert |
|---|---|---|---|
CB_CONNECTION_STRING | --connection-string | Verbindungszeichenfolge zum Couchbase-Cluster | Erforderlich |
CB_USERNAME | --username | Benutzername mit Zugriff auf die erforderlichen Buckets für die Basisauthentifizierung | Erforderlich (oder Clientzertifikat und Schlüssel für mTLS erforderlich) |
CB_PASSWORD | --password | Passwort für die Basisauthentifizierung | Erforderlich (oder Clientzertifikat und Schlüssel für mTLS erforderlich) |
CB_CLIENT_CERT_PATH | --client-cert-path | Pfad zur Clientzertifikatdatei für die mTLS-Authentifizierung | Erforderlich bei Verwendung von mTLS (oder Benutzername und Passwort erforderlich) |
CB_CLIENT_KEY_PATH | --client-key-path | Pfad zur Client-Schlüsseldatei für die mTLS-Authentifizierung | Erforderlich bei Verwendung von mTLS (oder Benutzername und Passwort erforderlich) |
CB_CA_CERT_PATH | --ca-cert-path | Pfad zum Server-Stammzertifikat für TLS, wenn der Server mit einem selbstsignierten/nicht vertrauenswürdigen Zertifikat konfiguriert ist. Bei einer Verbindung zu Capella ist dies nicht erforderlich | |
CB_MCP_READ_ONLY_MODE | --read-only-mode | Verhindert alle Datenänderungen (KV, Abfragen, Verwaltung von Scopes/Collections, Indexverwaltung und FTS-Indexverwaltung). Wenn aktiviert, werden Schreibwerkzeuge nicht geladen. | true |
CB_MCP_TRANSPORT | --transport | Transportmodus: stdio, http | stdio |
CB_MCP_HOST | --host | Host für den HTTP-Transportmodus | 127.0.0.1 |
CB_MCP_PORT | --port | Port für den HTTP-Transportmodus | 8000 |
CB_MCP_WORKERS | --workers | Anzahl der Server-Worker-Prozesse für den Transport http. Werte über 1 führen zum zustandslosen HTTP-Modus (siehe Mehrere Worker) | 1 |
CB_MCP_STATELESS_HTTP | --stateless-http | Verarbeitet jede HTTP-Anfrage ohne sitzungsbezogenen Zustand. Wird nur mit http berücksichtigt; kann nicht mit bestätigungspflichtigen Werkzeugen kombiniert werden (siehe Mehrere Worker) | true bei mehr als 1 Worker, andernfalls false |
CB_MCP_DISABLED_TOOLS | --disabled-tools | Zu deaktivierende Werkzeuge (siehe Werkzeuge deaktivieren) | Keine |
CB_MCP_CONFIRMATION_REQUIRED_TOOLS | --confirmation-required-tools | Werkzeuge, für deren Ausführung eine ausdrückliche Benutzerbestätigung über MCP-Elicitation erforderlich ist (siehe Bestätigung erforderlich) | Keine |
CB_MCP_LOG_LEVEL | --log-level | Protokollierungsstufe für den MCP-Server: off, debug, info, warning, error (siehe Protokollierung) | info |
CB_MCP_LOG_SINKS | --log-sinks | Durch Kommas getrennte Protokollziele: stderr, file oder beides (siehe Protokollierung) | stderr |
CB_MCP_LOG_FILE | --log-file | Basispfad für Protokolldateien je Stufe (nur verwendet, wenn der Sink file aktiviert ist) | mcp_server.log |
CB_MCP_LOG_ROTATION_MAX_SIZE_MB | --log-rotation-max-size-mb | Globale maximale Größe in MB pro Protokolldatei vor der Rotation; gilt für alle Stufen, sofern nicht überschrieben. 0 — oder ein nicht verwendbarer Wert, etwa ein negativer Wert, nan oder inf — ist ungültig und wird mit einer Warnung beim Start auf den Standardwert zurückgesetzt | 1 (1 MB) |
CB_MCP_LOG_MAX_BYTES | --log-max-bytes | Veraltet — verwenden Sie CB_MCP_LOG_ROTATION_MAX_SIZE_MB (MB). Globale Rotationsgröße in Bytes, aus Gründen der Abwärtskompatibilität weiterhin berücksichtigt; wird ignoriert, wenn auch CB_MCP_LOG_ROTATION_MAX_SIZE_MB gesetzt ist | Nicht gesetzt |
CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB | --log-error-rotation-max-size-mb | Rotationsgröße in MB für die ERROR-Protokolldatei; überschreibt CB_MCP_LOG_ROTATION_MAX_SIZE_MB für ERROR | Übernimmt CB_MCP_LOG_ROTATION_MAX_SIZE_MB |
CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB | --log-warning-rotation-max-size-mb | Rotationsgröße in MB für die WARNING-Protokolldatei; überschreibt CB_MCP_LOG_ROTATION_MAX_SIZE_MB für WARNING | Übernimmt CB_MCP_LOG_ROTATION_MAX_SIZE_MB |
CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB | --log-info-rotation-max-size-mb | Rotationsgröße in MB für die INFO-Protokolldatei; überschreibt CB_MCP_LOG_ROTATION_MAX_SIZE_MB für INFO | Übernimmt CB_MCP_LOG_ROTATION_MAX_SIZE_MB |
CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB | --log-debug-rotation-max-size-mb | Rotationsgröße in MB für die DEBUG-Protokolldatei; überschreibt CB_MCP_LOG_ROTATION_MAX_SIZE_MB für DEBUG | Übernimmt CB_MCP_LOG_ROTATION_MAX_SIZE_MB |
CB_MCP_LOG_RETENTION_BACKUP_COUNT | --log-retention-backup-count | Anzahl der rotierten Sicherungsdateien pro Protokolldatei und Stufe (ohne die aktuelle Datei); gilt für alle Stufen, sofern nicht überschrieben. 0 behält nur die aktuelle Datei bei (siehe Protokollierung) | 1 |
CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT | --log-error-retention-backup-count | Anzahl der rotierten Sicherungsdateien für die ERROR-Protokolldatei; überschreibt die globale Anzahl für ERROR | Übernimmt CB_MCP_LOG_RETENTION_BACKUP_COUNT |
CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT | --log-warning-retention-backup-count | Anzahl der rotierten Sicherungsdateien für die WARNING-Protokolldatei; überschreibt die globale Anzahl für WARNING | Übernimmt CB_MCP_LOG_RETENTION_BACKUP_COUNT |
CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT | --log-info-retention-backup-count | Anzahl der rotierten Sicherungsdateien für die INFO-Protokolldatei; überschreibt die globale Anzahl für INFO | Übernimmt CB_MCP_LOG_RETENTION_BACKUP_COUNT |
CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT | --log-debug-retention-backup-count | Anzahl der rotierten Sicherungsdateien für die DEBUG-Protokolldatei; überschreibt die globale Anzahl für DEBUG | Übernimmt CB_MCP_LOG_RETENTION_BACKUP_COUNT |
CB_MCP_OAUTH_JWT_JWKS_URI | --oauth-jwks-uri | JWKS-Endpunkt des Identitätsanbieters zur Überprüfung von Bearer-JWTs. Aktiviert OAuth, wenn zusammen mit Aussteller und Zielgruppe gesetzt (siehe OAuth 2.1-Autorisierung) | Keine |
CB_MCP_OAUTH_JWT_ISSUER | --oauth-issuer | Erwarteter JWT-Claim iss. Erforderlich, um OAuth zu aktivieren | Keine |
CB_MCP_OAUTH_JWT_AUDIENCE | --oauth-audience | Erwarteter JWT-Claim aud. Erforderlich, um OAuth zu aktivieren | Keine |
CB_MCP_OAUTH_JWT_ALGORITHM | --oauth-algorithm | JWT-Signaturalgorithmus: einer von RS256/384/512, ES256/384/512, PS256/384/512 | RS256 |
CB_MCP_OAUTH_MCP_BASE_URL | --oauth-mcp-base-url | Öffentliche Basis-URL dieses Servers. Wenn gesetzt, werden RFC 9728 Protected Resource Metadata veröffentlicht, damit PRM-fähige Clients den IdP ermitteln können | Keine |
CB_MCP_OAUTH_SCOPE_READ_LABEL | --oauth-scope-read-label | Überschreibt die OAuth-Scope-Bezeichnung, die als Lesezugriff behandelt wird (in PRM angekündigt und mit dem Claim scope/scp des Tokens abgeglichen). Verwenden Sie diese Option, wenn Ihr IdP die kanonische Form nicht ausgeben kann | couchbase-mcp:read |
CB_MCP_OAUTH_SCOPE_WRITE_LABEL | --oauth-scope-write-label | Überschreibt die OAuth-Scope-Bezeichnung, die als Schreibzugriff behandelt wird; gleiche Semantik wie bei der Lesezugriffsbezeichnung | couchbase-mcp:write |
CB_MCP_AUDIT_LOG_ENABLED | --audit-log-enabled | Aktiviert die Audit-Protokollierung — ein separater Sink neben den Betriebsprotokollen CB_MCP_LOG_*, mit stabilem Schema und eigener Aufbewahrungsdauer (siehe Auditierung) | false |
CB_MCP_AUDIT_LOG_SINKS | --audit-log-sinks | Durch Kommas getrennte Audit-Ziele: console, file oder beides. console schreibt nach stderr — niemals nach stdout, das bei stdio das JSON-RPC-Protokoll überträgt | console |
CB_MCP_AUDIT_LOG_FILE_PATH | --audit-log-file-path | Pfad zur Audit-Protokolldatei. Erforderlich, wenn file zu den Sinks gehört; Hostname und Prozess-ID werden vor der Erweiterung eingefügt (audit.log → audit.<host>.<pid>.log) | Keine |
CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB | --audit-log-rotation-max-size-mb | Maximale Größe in MB, die die aktuelle Audit-Datei vor der Rotation erreichen darf. 0 deaktiviert die größenbasierte Rotation | 10 (10 MB) |
CB_MCP_AUDIT_LOG_ROTATION_INTERVAL | --audit-log-rotation-interval | Alter, den die aktuelle Audit-Datei vor der Rotation erreichen darf, als <value><unit>, wobei die Einheit d (24 Stunden) oder w (7 Tage) ist — z. B. 1d, 30d, 8w. 0 deaktiviert die intervallbasierte Rotation | 1d |
CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS | --audit-log-retention-max-backups | Anzahl der aufbewahrten rotierten Sicherungsdateien pro Audit-Datei, ohne die aktuelle Datei. Sicherungsdateien werden mit gzip komprimiert. 0 behält keine bei. Dies begrenzt eine Datei, nicht das Verzeichnis — siehe Auditierung | 10 |
CB_MCP_AUDIT_LOG_TOOL_ARGS | --audit-log-tool-args | Zeichnet Werkzeugargumentwerte im Audit-Protokoll auf. Standardmäßig deaktiviert — in dieser Version gibt es keine Schwärzung. Bei Aktivierung werden Argumente daher unverändert aufgezeichnet, einschließlich vollständiger Dokumentinhalte | false |
CB_MCP_AUDIT_LOG_DISABLED_EVENTS | --audit-log-disabled-events | Zu unterdrückende Audit-Ereignisse: durch Kommas getrennte numerische Ereignis-IDs (z. B. 61490,61492) oder eine Datei mit einer ID pro Zeile. Nur filterbare Ereignisse können unterdrückt werden | Keine |
CB_MCP_EMBEDDING_MODEL_PROVIDER | --embedding-model-provider | Embedding-Anbieter für run_vector_query / run_vector_search: einer von capella, openai, cohere, voyage, bedrock. Wenn nicht gesetzt, wird der Embedding-Schritt beider Werkzeuge deaktiviert, bis ein Anbieter konfiguriert ist — siehe Konfiguration des Embedding-Anbieters | Keine |
CB_MCP_EMBEDDING_MODEL | --embedding-model | Modellname/-ID des konfigurierten Embedding-Anbieters | Keine |
CB_MCP_EMBEDDING_MODEL_API_KEY | --embedding-model-api-key | API-Schlüssel des konfigurierten Anbieters. Wird von bedrock nicht verwendet (nutzt stattdessen die AWS-Anmeldedatenkette / CB_MCP_EMBEDDING_MODEL_AWS_*) | Keine |
CB_MCP_EMBEDDING_MODEL_ENDPOINT | --embedding-model-endpoint | Überschreibung der Basis-URL (ein OpenAI-kompatibler lokaler Server oder die eigene URL einer Capella Model Service-Bereitstellung — erforderlich bei CB_MCP_EMBEDDING_MODEL_PROVIDER=capella) | Keine |
CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID | --embedding-model-aws-access-key-id | AWS-Zugriffsschlüssel-ID, nur für den Anbieter bedrock. Nicht angeben, um die standardmäßige AWS-Anmeldedatenkette zu verwenden | Keine |
CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY | --embedding-model-aws-secret-access-key | Geheimer AWS-Zugriffsschlüssel, nur für den Anbieter bedrock | Keine |
CB_MCP_EMBEDDING_MODEL_AWS_REGION | --embedding-model-aws-region | AWS-Region, nur für den Anbieter bedrock. Wenn nicht gesetzt, wird auf die Regionsauflösung des AWS SDK zurückgegriffen | Keine |
Operational Insights Server
Der Server operational-insights stellt eine Verbindung zu selbstverwalteten Operational Insights-Clustern her. Operational Insights ist eine Echtzeit-Analyse-Datenbank (RT-OLAP) für Echtzeitanwendungen und operative Intelligenz. Der Server ist für Capella nicht verfügbar. Er verwendet das SDK couchbase-operational-insights. Er wird als eigener Prozess ausgeführt, getrennt vom Operational Server.
[!IMPORTANT]
CB_OPERATIONAL_INSIGHTS_CONNECTION_STRINGist eine HTTP(S)-URL, keinecouchbase://-Verbindungszeichenfolge — z. B.http://localhost:8095oderhttps://<host>:18095über TLS. Dies ist die häufigste Fehlkonfiguration.
Schnellstart für Operational Insights
Von PyPI mit 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"
}
}
}
}
Mit 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"
]
}
}
}
Verwenden Sie für den Quellcode die Operational-Quellkonfiguration mit operational-insights als letztem Argument und den oben genannten Variablen.
Verbindung und Authentifizierung für Operational Insights
| Umgebungsvariable | CLI-Argument | Beschreibung |
|---|---|---|
CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING | --connection-string | Endpunkt-URL (HTTP/HTTPS). Erforderlich |
CB_OPERATIONAL_INSIGHTS_USERNAME | --username | Benutzername |
CB_OPERATIONAL_INSIGHTS_PASSWORD | --password | Passwort |
CB_OPERATIONAL_INSIGHTS_CA_CERT_PATH | --ca-cert-path | Stammzertifikat (PEM) für ein selbstsigniertes/nicht vertrauenswürdiges Serverzertifikat |
CB_OPERATIONAL_INSIGHTS_CLIENT_CERT_PATH | --client-cert-path | Clientzertifikat für mTLS — PEM (mit Schlüssel) oder ein PKCS#12-Bundle (.p12/.pfx, ohne Schlüssel). Erfordert eine https://-URL; überschreibt Benutzername/Passwort |
CB_OPERATIONAL_INSIGHTS_CLIENT_KEY_PATH | --client-key-path | Privater Schlüssel (PEM) für das Clientzertifikat. Für PKCS#12 nicht setzen |
CB_OPERATIONAL_INSIGHTS_CLIENT_CERT_PASSWORD | --client-cert-password | Passwort für einen verschlüsselten Schlüssel oder ein PKCS#12-Bundle |
CB_MCP_OPERATIONAL_INSIGHTS_QUERY_RESULT_MAX_SIZE | --operational-insights-query-result-max-size | Maximale Größe des Abfrageergebnisses in Bytes. Nicht gesetzt bedeutet keine Begrenzung. Wenn gesetzt, wird das Lesen beim Erreichen des Budgets beendet und die Antwort meldet truncated: true; eine Zeile, die das Budget überschreiten würde, wird nicht zurückgegeben. Werte über 4 MiB (4194304) werden auf 4 MiB begrenzt; beim Start wird eine Warnung auf stderr ausgegeben |
CB_MCP_OPERATIONAL_INSIGHTS_ASYNC_QUERY_RESULT_TIMEOUT | --operational-insights-async-query-result-timeout | Timeout in Sekunden für jede asynchrone Abfrageanforderung: Starten der Abfrage, Prüfen ihres Status, Abrufen der Ergebnisse, Verwerfen und Abbrechen. Bei einem Abruf gilt er für den gesamten Download, sodass das Lesen eines länger dauernden Ergebnisses fehlschlägt. Erhöhen Sie den Wert bei großen Ergebnissen oder langsamen Verbindungen. Positive Ganzzahl, Standardwert 30, Maximum 600. Größere Werte werden auf 600 begrenzt und lösen eine Warnung aus; jeder andere ungültige Wert wird als Warnung protokolliert und 30 wird verwendet |
Die gesamte gemeinsame Konfiguration gilt, mit folgenden Abweichungen vom operativen Server:
- Der Standardport ist
8001und die Standardprotokolldatei istmcp_server_operational_insights.log, sodass beide Server parallel ausgeführt werden können. - Es wird nur ein Worker unterstützt (
CB_MCP_WORKERS=1), da asynchrone Abfrage-Handles im Prozessspeicher liegen. - Es gibt keine
CB_MCP_EMBEDDING_MODEL_*-Optionen.
Operational-Insights-Tools
Allen Namen außer get_server_configuration_status wird operational_insights_ vorangestellt, sodass beide Server ohne Namenskonflikte bei einem Client registriert werden können. Das Schreibtool (mit ✏️ markiert) wird nicht geladen, solange der Nur-Lese-Modus aktiviert ist; dies ist die Standardeinstellung.
Serverstatus
| Tool | Beschreibung |
|---|---|
get_server_configuration_status | Dasselbe Tool wie auf dem operativen Server |
Datenmodell- und Schemaerkennung
| Tool | Beschreibung |
|---|---|
operational_insights_get_databases_in_cluster | Datenbanken auflisten |
operational_insights_get_scopes_in_database | Scopes in einer Datenbank auflisten |
operational_insights_get_collections_in_scope | Collections (Datasets) in einem Scope auflisten |
operational_insights_get_schema_for_collection | Das JSON-Schema einer Collection durch Stichproben ermitteln |
Abfragen und Indizes
| Tool | Beschreibung |
|---|---|
operational_insights_list_indexes | Sekundärindizes aus System.Metadata.Index auflisten |
operational_insights_explain_query | Eine SQL++-Anweisung mit EXPLAIN analysieren, ohne sie auszuführen |
operational_insights_run_query_sync | SQL++ ausführen und Zeilen bis zur Ergebnisgrößenbegrenzung zurückgeben; alternativ exportieren. Der Nur-Lese-Modus wird serverseitig durchgesetzt |
operational_insights_run_query_async | Eine lang laufende Abfrage starten und ein query_handle zurückgeben, ohne auf Zeilen zu warten; auch für große Exporte bevorzugt. Der Nur-Lese-Modus wird serverseitig durchgesetzt |
operational_insights_get_async_query_results | Eine asynchrone Abfrage abfragen; gibt Zeilen (oder das Exportziel) zurück, sobald sie bereit sind |
operational_insights_discard_async_query_results | Die Ergebnisse einer abgeschlossenen asynchronen Abfrage freigeben |
operational_insights_cancel_async_query | Eine noch laufende asynchrone Abfrage stoppen (im Nur-Lese-Modus zulässig) |
operational_insights_create_index ✏️ | Einen Sekundärindex über CREATE INDEX erstellen |
Asynchrone Abfragen folgen einem Ablauf aus Starten → Abfragen → Verwerfen oder Abbrechen: operational_insights_run_query_async gibt ein query_handle zurück, operational_insights_get_async_query_results wird bis zur Bereitschaft abgefragt, anschließend gibt operational_insights_discard_async_query_results die Ergebnisse frei oder operational_insights_cancel_async_query stoppt eine noch laufende Abfrage.
Große Ergebnisse exportieren
Anstatt Zeilen zurückzugeben, können operational_insights_run_query_sync und operational_insights_run_query_async die Anweisung in COPY ... TO einschließen und die Zeilen in einen externen Objektspeicher schreiben. Übergeben Sie alle drei Werte copy_to_link (einen vorhandenen Link, erstellt mit CREATE LINK ... TYPE S3), copy_to_bucket und copy_to_path, sowie optional copy_to_format (json, der Standardwert, oder parquet). Das Tool gibt dann eine Bestätigung ohne Zeilen zurück:
{
"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. ..."
}
- Ein unvollständiges Ziel wird abgelehnt, statt stillschweigend Zeilen zurückzugeben.
- Das synchrone Tool wartet auf den vollständigen Upload; bei großen Exporten ist das asynchrone Tool vorzuziehen.
- Exporte sind im Nur-Lese-Modus gesperrt (sie schreiben in externen Speicher) und benötigen daher
CB_MCP_READ_ONLY_MODE=falseoder ein Token mitcouchbase-mcp:write. csvwird nicht angeboten, da dafür ein explizites Ausgabeschema erforderlich ist, das sich nicht aus einem beliebigenSELECTableiten lässt.
Gemeinsame Konfiguration
Diese Einstellungen funktionieren bei beiden Servern gleich. Jede Option kann als Umgebungsvariable oder als CLI-Flag nach dem Unterbefehl festgelegt werden.
Sicherheitskontrollen
Befolgen Sie diese Sicherheitsprinzipien:
- Gewähren Sie dem Datenbankbenutzer die geringstmöglichen Berechtigungen — RBAC ist die maßgebliche Sicherheitsgrenze (siehe unten).
- Stellen Sie dem Agenten nur die benötigten Tools bereit und deaktivieren Sie die übrigen — jedes geladene Tool kann vom LLM aufgerufen werden. Verwenden Sie den Nur-Lese-Modus und
CB_MCP_DISABLED_TOOLS, um die Toolliste auf das Nötigste zu beschränken. - Verlangen Sie für beibehaltene sensible Tools eine Bestätigung — siehe Bestätigung anfordern.
Die folgenden Kontrollen bilden drei Ebenen, von der umfassendsten bis zur engsten. Verwenden Sie sie gemeinsam — beachten Sie jedoch, dass keine davon RBAC ersetzt.
[!IMPORTANT] Die RBAC-Berechtigungen des Datenbankbenutzers sind die maßgebliche Sicherheitskontrolle. Beispielsweise verhindert das Deaktivieren von
upsert_document_by_idunddelete_document_by_idnicht, dassrun_sql_plus_plus_queryINSERT/UPDATE/DELETE/MERGEausführt — nur der Nur-Lese-Modus oder fehlende RBAC-Berechtigungen verhindern dies. Gewähren Sie dem Datenbankbenutzer des Servers nur die benötigten Berechtigungen.
Nur-Lese-Modus
CB_MCP_READ_ONLY_MODE (Standardwert true) ist der zentrale Schalter für Schreibvorgänge:
true— die in der Toolliste des jeweiligen Servers mit ✏️ markierten Schreibtools werden nicht geladen, und Abfragen, die Daten oder Strukturen ändern, werden blockiert.false— Schreibtools werden geladen und ändernde Abfragen sind zulässig.
Tools deaktivieren
CB_MCP_DISABLED_TOOLS entfernt Tools vollständig aus der Erkennung. Es akzeptiert eine durch Kommas getrennte Liste oder einen Dateipfad zu einer Datei mit einem Toolnamen pro Zeile (# leitet einen Kommentar ein):
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
Auf Capella deaktiviert der operative Server außerdem automatisch einige Admin-Tools.
Bestätigung anfordern (Elicitation)
CB_MCP_CONFIRMATION_REQUIRED_TOOLS fordert den Benutzer vor der Ausführung eines aufgeführten Tools zur Bestätigung auf und verwendet dafür MCP-Elicitation. Es akzeptiert dieselben durch Kommas getrennten Listen- oder Dateiformate wie die Liste deaktivierter Tools:
CB_MCP_CONFIRMATION_REQUIRED_TOOLS="delete_document_by_id,replace_document_by_id"
- Wenn der Client Elicitation unterstützt, wird der Benutzer vor der Ausführung des Tools gefragt.
- Wenn nicht, wird das Tool aus Gründen der Abwärtskompatibilität ohne Bestätigung ausgeführt.
- Für eine Bestätigung ist eine MCP-Sitzung erforderlich; sie kann daher nicht mit zustandslosem HTTP kombiniert werden (
CB_MCP_STATELESS_HTTP=trueoderCB_MCP_WORKERSgrößer als 1). Der Server verweigert den Start mit dieser Kombination. Hinter einem Load Balancer erfordert die Bestätigung Sticky Sessions — siehe Load Balancer.
Transports
| Transport | Verwendung | Endpunkt |
|---|---|---|
stdio (Standard) | Ein lokaler Client, der den Server als Unterprozess startet | — |
http | Mehrere Clients, die einen Server gemeinsam nutzen; unterstützt OAuth und Zustandsprüfungen sowie Worker auf dem operativen Server | http://<host>:<port>/mcp |
Legen Sie den Transport mit CB_MCP_TRANSPORT, die Bind-Adresse mit CB_MCP_HOST (Standardwert 127.0.0.1) und den Port mit CB_MCP_PORT fest (bei Nichtangabe der Standardport des jeweiligen Servers). Ohne OAuth ist der HTTP-Endpunkt nicht authentifiziert.
uvx couchbase-mcp-server operational \
--connection-string='<couchbase_connection_string>' \
--username='<database_username>' \
--password='<database_password>' \
--transport=http
Richten Sie Ihren Client anschließend auf die URL aus:
{
"mcpServers": {
"couchbase-http": {
"url": "http://localhost:8000/mcp"
}
}
}
Mehrere Worker
Ein Prozess nutzt höchstens etwa einen CPU-Kern. --workers N (CB_MCP_WORKERS) führt N Prozesse hinter demselben Host und Port aus; die Anzahl verfügbarer Kerne ist ein guter Ausgangspunkt. Worker werden nur vom operativen Server unterstützt. Bei mehr als einem Worker gilt:
- Der Transport
httpist erforderlich, und der Server läuft im zustandslosen HTTP-Modus, da die Anfragen eines Clients verschiedene Worker erreichen können. Sie können--stateless-http=trueauch bei einem einzelnen Worker festlegen, beispielsweise hinter einem Load Balancer ohne Sticky Sessions. - Tools, die eine Bestätigung erfordern, können nicht verwendet werden.
- Jeder Prozess schreibt eigene Protokolldateien mit Hostname und Prozess-ID im Namen (
mcp_server.<host>.<pid>.info.log) — einen Satz für den Supervisor und je einen pro Worker.
Load Balancer
Sie können mehrere Serverinstanzen hinter einem Load Balancer ausführen. Jede Instanz hält ihre MCP-Sitzungen im eigenen Speicher; daher bestimmt die Load-Balancer-Konfiguration, was funktioniert:
| Load Balancer | Servereinstellung | Tools, die eine Bestätigung erfordern |
|---|---|---|
Sticky Sessions, Weiterleitung anhand des Anforderungsheaders Mcp-Session-Id | Ein Worker, zustandsbehaftet (Standard) | Unterstützt |
| Keine Sticky Sessions | --stateless-http=true | Nicht unterstützt — der Server verweigert den Start, wenn sie konfiguriert sind |
- Ohne Sticky Sessions weist eine zustandsbehaftete Instanz jede Anfrage zurück, deren Sitzung auf einer anderen Instanz erstellt wurde. Verwenden Sie in diesem Fall den zustandslosen Modus.
- Leiten Sie anhand des Headers
Mcp-Session-Idweiter, nicht anhand von Cookies. Viele MCP-Clients speichern keine Cookies. - Wird eine Instanz neu gestartet oder erfolgt ein Failover, gehen ihre Sitzungen und alle ausstehenden Bestätigungsaufforderungen verloren. Der Client muss eine neue Sitzung starten.
- Asynchrone Operational-Insights-Abfragen halten ihre
query_handleim Speicher der Instanz, die die Abfrage gestartet hat, auch im zustandslosen Modus. Abfragen, Verwerfen oder Abbrechen der Abfrage auf einer anderen Instanz gibtUnknown query_handlezurück. Verwenden Sie diese Tools mit einer einzelnen Instanz oder mit Sticky Sessions, damit alle Aufrufe die Instanz erreichen, die die Abfrage gestartet hat. Im zustandslosen Modus wird keinMcp-Session-Idgesendet; daher ist ein anderer Affinitätsschlüssel erforderlich, etwa die Client-IP-Adresse.
Zustandsprüfung
Im HTTP-Modus gibt GET /health am MCP-Port {"status": "ok", "server": "<server>"} zurück. Dies ist eine Liveness-Prüfung: Sie stellt keine Verbindung zum Cluster her (ein Clusterausfall führt also nicht zum Neustart gesunder Container), benötigt auch bei aktiviertem OAuth keine Authentifizierung und wird von jedem Worker bereitgestellt. Beispiele für Prüfungen finden Sie unter Docker.
OAuth-2.1-Autorisierung
Mit --transport=http kann jeder der beiden Server als OAuth-2.1-Ressourcenserver fungieren und Bearer-JWTs anhand der JWKS Ihres Identitätsanbieters validieren. Dies funktioniert mit jedem OAuth-2.1-/OIDC-Anbieter, der eine JWKS veröffentlicht, und stellt weder Tokens aus noch verwaltet es Benutzer. OAuth-Einstellungen werden unter stdio ignoriert.
- OAuth wird nur aktiviert, wenn alle drei Werte
CB_MCP_OAUTH_JWT_JWKS_URI,CB_MCP_OAUTH_JWT_ISSUERundCB_MCP_OAUTH_JWT_AUDIENCEgesetzt sind; werden nur einige davon gesetzt, schlägt der Start fehl. CB_MCP_OAUTH_MCP_BASE_URLveröffentlicht zusätzlich RFC-9728-Metadaten für geschützte Ressourcen, damit Clients den Autorisierungsserver ermitteln können.- Der Zugriff wird durch zwei Scopes im Claim
scope/scpdes Tokens gesteuert:couchbase-mcp:read(Lese-Tools) undcouchbase-mcp:write(Schreib-Tools). Vollzugriff erfordert beide. Benennen Sie sie mitCB_MCP_OAUTH_SCOPE_READ_LABEL/CB_MCP_OAUTH_SCOPE_WRITE_LABELum, falls Ihr IdP diese Bezeichnungen nicht ausgeben kann. Beide Server verwenden dieselben Bezeichnungen, sodass eine IdP-Konfiguration für beide genügt.
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>'
Informationen zur IdP-Einrichtung finden Sie in der OAuth-Dokumentation für den operativen Server und den Operational-Insights-Server.
Protokollierung
Jeder Server protokolliert standardmäßig in stderr mit der Protokollebene info.
CB_MCP_LOG_LEVEL—off,error,warning,info(Lebenszyklusereignisse und Tool-Aufrufe) oderdebug.CB_MCP_LOG_SINKS—stderr,fileoder beides. Mitfilewird nebenCB_MCP_LOG_FILEeine rotierende Datei pro Ebene geschrieben (mcp_server.info.log,mcp_server.error.log, …).- Rotation und Aufbewahrung —
CB_MCP_LOG_ROTATION_MAX_SIZE_MB(Standard: 1 MB) undCB_MCP_LOG_RETENTION_BACKUP_COUNT(Standard: 1) gelten für jede Ebene; mitCB_MCP_LOG_<LEVEL>_ROTATION_MAX_SIZE_MB/CB_MCP_LOG_<LEVEL>_RETENTION_BACKUP_COUNTkönnen sie pro Ebene überschrieben werden. Ungültige Größen werden mit einer Warnung beim Start auf den Standardwert zurückgesetzt.CB_MCP_LOG_MAX_BYTESist veraltet. - Konfigurations-Snapshot — mit dem Sink
filewird bei jedem Start ein JSON-Datensatz mit der Umgebung und der bereinigten Serverkonfiguration zu Supportzwecken nachmcp_server_config.log.jsongeschrieben.
# Debug logging to stderr and rotating per-level files
uvx couchbase-mcp-server operational --log-level=debug --log-sinks=stderr,file
Ihr MCP-Client erfasst normalerweise auch die stderr-Ausgabe des Servers — siehe Client-Einrichtung für den Speicherort. Details finden Sie in der Logging-Dokumentation für den operativen Server und den Operational Insights-Server.
Audit-Protokollierung
Die Audit-Protokollierung erfasst wer was getan hat und ob es erlaubt war — getrennt von den Betriebsprotokollen, die festhalten, was schiefgelaufen ist. Der MCP-Server ist die einzige Ebene, die diese Frage für einen Agenten beantworten kann: Jede Anfrage erreicht den Cluster als einzelner Datenbankbenutzer, und Entscheidungen wie eine verweigerte Bereichsberechtigung, eine Schreibschutzsperre oder eine abgelehnte Bestätigung erreichen den Cluster überhaupt nicht.
Die Audit-Protokollierung ist standardmäßig deaktiviert. Aktivieren Sie sie mit CB_MCP_AUDIT_LOG_ENABLED=true; sie schreibt nach stderr, sofern Sie nicht CB_MCP_AUDIT_LOG_SINKS=file und CB_MCP_AUDIT_LOG_FILE_PATH festlegen.
# 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
Die Datensätze sind JSON Lines und verwenden dieselben Feldbezeichnungen wie Couchbase Server und 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"}
Funktionsweise der Audit-Protokollierung
- Identität —
real_useridist der Aufrufer:oauth(das Token-Subjekt),local(der Betriebssystembenutzer bei stdio) oderanonymous(HTTP ohne OAuth; dabei wird beim Start eine Warnung ausgegeben). - Korrelation —
cidgruppiert alle Datensätze einer Anfrage und wird als SQL++-Wertclient_context_idgesendet, sodass er exakt mitclientContextIdvon Couchbase Server verknüpft werden kann. Es gibt bewusst keine Sitzungskennung. - Ereignisse — ein fester, nummerierter Katalog (Lebenszyklus, Initialisierung, Token abgelehnt, Bereichsberechtigung verweigert, Schreibschutzsperre, Bestätigung abgelehnt/übersprungen sowie je ein Lese-/Schreibpaar pro Toolkategorie).
queryundsearchsind Ausnahmen: Jedes wird als einzelnes Ereignis statt als Lese-/Schreibpaar erfasst, da sich die Unterscheidung bei anweisungsbasierten und Suchoberflächen nicht zuverlässig treffen ließ. Vektoroperationen gehören zu diesen beiden Kategorien. Der vollständige Katalog ist im Paket alsdescriptor.jsonenthalten. Der operative Server verwendet den Block0xF000(61440), Operational Insights0x10000(65536); beide verwenden für Kernereignisse den gemeinsamen Block0xE000(57344). - Filterung —
CB_MCP_AUDIT_LOG_DISABLED_EVENTSunterdrückt Leseereignisse anhand ihrer numerischen ID (z. B.61490,61492). Schreib- und Sicherheitsereignisse können nicht deaktiviert werden. Dasselbe gilt für die Einzelereigniskategorienquery(61507 oder 65603 bei Operational Insights) undsearch(61510): Ein Ereignis deckt sowohl Schreib- als auch Lesevorgänge der jeweiligen Kategorie ab. Bei einer Deaktivierung ginge daher ein Änderungsdatensatz verloren. - Rotation — nach Größe (
CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB, Standard: 10) und Alter (CB_MCP_AUDIT_LOG_ROTATION_INTERVAL, Standard:1d), je nachdem, was zuerst eintritt;0deaktiviert beides. Rotierte Dateien erhalten einen Zeitstempel und werden mit gzip komprimiert; die aktuelle Datei bleibt fürtail -funkomprimierter Text. - Dateien pro Prozess — Host und PID werden in den Namen eingefügt (
audit.log→audit.<host>.<pid>.log), sodass gleichzeitige Prozesse nie dieselbe Datei verwenden. - Aufbewahrung pro Datei —
CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS(Standard: 10) begrenzt die Sicherungen einer einzelnen Datei. Jeder neue Prozess schreibt eine neue Datei, und alte Dateien werden nicht bereinigt. Bemessen Sie daher das Volume entsprechend oder löschen Sie alteaudit.*.log*-Dateien regelmäßig. - Fail-open — kann nicht in die Datei geschrieben werden, läuft der Server weiter und zählt verworfene Datensätze;
get_server_configuration_statusmeldetwritten/dropped/write_errors. - Tool-Argumente — werden nur mit
CB_MCP_AUDIT_LOG_TOOL_ARGS=trueerfasst; beim Start wird eine Warnung ausgegeben. In dieser Version gibt es keine Bereinigung, daher werden Argumente, einschließlich vollständiger Dokumentinhalte, unverändert geschrieben.
Client-Einrichtung
Jeder Client benötigt eine Serverkonfiguration aus der Kurzanleitung für den operativen Server oder den Operational Insights-Server an seinem jeweiligen Konfigurationsspeicherort. Die folgenden Beispiele verwenden den operativen Server.
Claude Desktop
- Öffnen Sie die Konfigurationsdatei (siehe MCP-Schnellstartanleitung):
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Fügen Sie den Server unter
mcpServershinzu und starten Sie Claude Desktop neu.
Protokolle: macOS ~/Library/Logs/Claude, Windows %APPDATA%\Claude\Logs. Siehe den MCP-Leitfaden zur Fehlerbehebung.
Cursor
- Öffnen Sie Cursor Settings > Tools & Integrations > MCP Tools (siehe Cursor-MCP-Dokumentation) oder verwenden Sie den Ein-Klick-Link In Cursor installieren — ersetzen Sie anschließend die Platzhalter-Verbindungszeichenfolge und Anmeldedaten.
- Fügen Sie die Konfiguration unter
mcpServershinzu und speichern Sie sie. - Aktualisieren Sie die Liste der MCP-Server, um zu prüfen, ob
couchbaseaktiviert ist.
Protokolle: Öffnen Sie im unteren Bereich Output und wählen Sie Cursor MCP aus.
Windsurf Editor
- Öffnen Sie Command Palette > Windsurf MCP Configuration Panel oder Windsurf Settings > Advanced > Cascade > Model Context Protocol (MCP) Servers (siehe Windsurf-MCP-Dokumentation).
- Klicken Sie auf Add Server > Add custom server, fügen Sie die Konfiguration ein und speichern Sie sie.
- Aktualisieren Sie die Serverliste, um zu prüfen, ob
couchbaseaktiviert ist.
VS Code
VS Code verwendet servers statt mcpServers als Schlüssel der obersten Ebene. Legen Sie die Konfiguration für einen Arbeitsbereich in .vscode/mcp.json ab oder führen Sie für alle Arbeitsbereiche MCP: Open User Configuration aus (siehe VS-Code-MCP-Dokumentation):
{
"servers": {
"couchbase": {
"command": "uvx",
"args": ["couchbase-mcp-server", "operational"],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password"
}
}
}
}
Beim Speichern der Datei wird der Server gestartet. Verwenden Sie die darüber angezeigten Aktionen Running | Stop | n Tools, um ihn zu verwalten.
Protokolle: Führen Sie MCP: List Servers aus, wählen Sie couchbase und dann Show Output.
JetBrains-IDEs
- Installieren Sie das Plugin AI Assistant oder Junie.
- Öffnen Sie Settings > Tools > AI Assistant (or Junie) > MCP Server, klicken Sie auf +, fügen Sie die Konfiguration hinzu und klicken Sie auf Apply.
- Bewegen Sie den Mauszeiger über den Serverstatus, um dessen Tools anzuzeigen.
Protokolle: Help > Show Log in Finder (Explorer) > mcp > couchbase.
Docker
Vorgefertigte Images werden auf Docker Hub als couchbase/mcp-server veröffentlicht. Der Server ist außerdem im Docker MCP Catalog aufgeführt. Konfigurieren Sie den Container mit denselben Umgebungsvariablen wie oben. Informationen zu Tags, Volumes und Beispielen für Health Checks finden Sie auf der Docker-Hub-Seite (DOCKER.md).
Bei der Ausführung über HTTP muss der Server an 0.0.0.0 gebunden sein, damit er von außerhalb des Containers erreichbar ist:
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
- Wenn Couchbase auf Ihrem Hostcomputer läuft, verwenden Sie
couchbase://host.docker.internalals Verbindungszeichenfolge (siehe Docker-Netzwerk). Verwenden Sie--network=<your_network>, um dem Netzwerk eines anderen Containers beizutreten. - Hängen Sie
operational-insightsstattoperationalan, um den Operational Insights-Server auszuführen (Port8001).
Image aus dem Quellcode erstellen
docker build -t mcp/couchbase-src .
./build.sh [image-name] erstellt das Image mit denselben Argumenten wie CI — es setzt die Build-Argumente GIT_COMMIT_HASH und BUILD_DATE und versieht das Image mit den Tags latest und <short-commit> (Standardname mcp/couchbase-src). So erstellen Sie das Image manuell mit den Labels:
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
Fehlerbehebung
Ausführliche Anleitungen finden Sie in der Fehlerbehebungsdokumentation für den operativen Server und den Operational Insights-Server sowie in den Sicherheitsrichtlinien für den operativen Server und den Operational Insights-Server. Schnelle Prüfungen:
- Prüfen Sie die Verbindungszeichenfolge, den Benutzernamen und das Passwort oder die Zertifikatpfade.
- Stellen Sie bei Capella sicher, dass der Cluster Verbindungen zulässt von dem Computer aus, auf dem der Server läuft.
- Stellen Sie sicher, dass der Datenbankbenutzer auf mindestens einen Bucket zugreifen kann.
- Wenn der Client
uv/uvxnicht findet, geben Sie incommandden absoluten Pfad an. - Prüfen Sie bei der Ausführung aus dem Quellcode den Repository-Pfad in der Konfiguration und führen Sie nach dem Abrufen von Aktualisierungen
uv syncaus. - Rufen Sie
get_server_configuration_statusauf, um die tatsächlich vom Server aufgelöste Konfiguration anzuzeigen, und prüfen Sie die Protokolle Ihres Clients (siehe Client-Einrichtung).
FAQ
Wie verbinde ich Claude Desktop mit Couchbase? Fügen Sie die Konfiguration aus der Kurzanleitung zu claude_desktop_config.json hinzu und starten Sie Claude Desktop neu — siehe Client-Einrichtung.
Kann ich das mit Couchbase Capella verwenden? Ja, mit dem operativen Server: Dieselbe Konfiguration funktioniert mit Capella und selbstverwalteten Clustern, einige Admin-Tools sind jedoch nur auf selbstverwalteten Clustern verfügbar (siehe Tools). Der Operational Insights-Server ist ausschließlich für selbstverwaltete Operational Insights-Cluster vorgesehen.
Ist es sicher, einem KI-Agenten Schreibzugriff auf meine Datenbank zu gewähren? Standardmäßig nicht: Es werden keine Schreib-Tools geladen und Änderungen an SQL++ sind gesperrt. Wenn Sie Schreibzugriffe aktivieren, können Sie weiterhin einzelne Tools deaktivieren oder eine Bestätigung verlangen — die RBAC-Berechtigungen Ihres Couchbase-Benutzers bleiben jedoch die eigentliche Sicherheitsgrenze. Siehe Sicherheitskontrollen.
Muss ich SQL++ kennen? Nein. Stellen Sie Ihre Frage in einfacher Sprache, und der Assistent schreibt die SQL++-Abfrage für run_sql_plus_plus_query. Er kann auch einen Abfrageplan erklären oder den Index Advisor um Empfehlungen bitten.
STDIO oder Streamable HTTP? STDIO für einen einzelnen lokalen Client. Streamable HTTP, um einen Server mit OAuth für mehrere Clients freizugeben. Siehe Transporte.
Wird dies offiziell von Couchbase unterstützt? Ja, mit einer Couchbase AI Data Plane-Lizenz. Ohne eine solche Lizenz helfen Couchbase-Ingenieure nach bestem Bemühen über GitHub-Issues. Siehe Support-Richtlinie.
Mitwirken
Beiträge sind willkommen — Fehlerbehebungen, Funktionen und Dokumentation. Um einen Fehler zu melden oder Hilfe anzufordern, erstellen Sie ein GitHub-Issue.
Unter CONTRIBUTING.md finden Sie Informationen zur Entwicklungsumgebung, zu Linting und Tests, zur Projektstruktur und zum Workflow. Erste Schritte:
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
Integrationstests werden mit einem aktiven Cluster ausgeführt. Exportieren Sie CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD und optional CB_MCP_TEST_BUCKET; für die Operational Insights-Tests werden außerdem CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING / _USERNAME / _PASSWORD verwendet. Sie werden übersprungen, wenn diese Variablen nicht gesetzt sind. Führen Sie anschließend Folgendes aus:
uv run --extra dev pytest tests/integration -v
Nutzungsdaten, LLM-Risiken und Support-Richtlinie
Erfassung von Nutzungsdaten
Dieses Produkt erfasst automatisch Nutzungs- und Leistungsdaten (z. B. Produktname und Version) sowie Browserinformationen (z. B. IP-Adresse) (zusammen „Nutzungsdaten“). Couchbase verwendet Nutzungsdaten zusammen mit anderen Daten, die Sie Couchbase möglicherweise bereitstellen (z. B. Ihren Benutzernamen oder Ihre E-Mail-Adresse), um unsere Produkte weiterzuentwickeln und zu verbessern sowie unsere Vertriebs- und Marketingprogramme zu unterstützen. Wir greifen nicht auf Daten zu, die Sie in Couchbase-Produkten speichern, und erfassen diese auch nicht. Wir verwenden Nutzungsdaten, um aggregierte Nutzungsmuster zu verstehen und unsere Produkte für Sie nützlicher zu machen. Weitere Informationen dazu, wie Couchbase Informationen erfasst, schützt und verarbeitet, finden Sie in der Couchbase-Datenschutzerklärung unter https://www.couchbase.com/privacy-policy.
Risiken im Zusammenhang mit LLMs
- Die Verwendung großer Sprachmodelle und ähnlicher Technologien birgt Risiken, darunter die Möglichkeit ungenauer oder schädlicher Ausgaben.
- Couchbase überprüft oder bewertet weder die Qualität noch die Genauigkeit solcher Ausgaben, und diese geben möglicherweise nicht die Ansichten von Couchbase wieder.
- Sie sind allein dafür verantwortlich, zu entscheiden, ob Sie große Sprachmodelle und verwandte Technologien verwenden, und die für Ihre Nutzung geltenden Lizenzbedingungen, Nutzungsbedingungen und Richtlinien Ihrer Organisation einzuhalten.
Support-Richtlinie
Der Couchbase MCP Server ist Open Source und wird von Couchbase-Ingenieuren betreut. Wie Sie Hilfe erhalten, hängt davon ab, wie Sie ihn verwenden:
- Community-Nutzung — Melden Sie Fehler, stellen Sie Fragen und fordern Sie Funktionen an, indem Sie ein GitHub-Issue eröffnen. Couchbase-Ingenieure beobachten das Repository und antworten nach bestem Bemühen, ohne verbindliche Reaktionszeit. Das Couchbase-Supportportal kann bei der Community-Nutzung nicht helfen.
- Enterprise-Support — verfügbar durch die Lizenzierung von Couchbase AI Data Plane, die auch Couchbase Agent Memory und Couchbase Agent Catalog umfasst. Lizenzierte Kunden erhalten Hilfe über ihre üblichen Couchbase-Supportkanäle.
Vielen Dank, dass Sie das Projekt nutzen und dazu beitragen!