Configuration

concept

Overview of the environment variable and command-line options available for configuring the Couchbase MCP Server.

You can configure the Couchbase MCP Server through environment variables or command line arguments set in your MCP client configuration. This allows you to customize server behavior, authentication, transport settings, and more.

Configuration Topics

Environment Variables & Command Line Arguments: Full reference of all configuration options, authentication examples, and transport settings.
Read-Only Mode: Control write access to your cluster. Enabled by default for safety.
Streamable HTTP Transport Mode: Run the server in Streamable HTTP transport mode for multi-client access.
OAuth: Secure the Streamable HTTP endpoint with OAuth 2.1 JWT token verification and scope-based authorization.
Disabling Tools: Selectively disable individual tools via configuration.
Elicitation/Confirmation for Tool Calls: Require user confirmation before executing specific tools.
Logging: Configure log level, output sinks (console/file), and file logging for supportability.
Audit Logging: Record tool calls, authorization denials, and guardrail blocks in a separate audit log.