Struct McpServerConfig 

pub struct McpServerConfig { /* private fields */ }

One MCP server’s configuration.

Mirrors what McpAddCommand can register, so the two describe the same thing whether it is persisted or scoped to a run.

Implementations

impl McpServerConfig

pub fn stdio(command: impl Into<String>) -> Self

A server launched as a subprocess.

pub fn http(url: impl Into<String>) -> Self

A server reached over HTTP.

pub fn arg(self, value: impl Into<String>) -> Self

Append a launch argument. Ignored for an HTTP server.

pub fn env(self, key: impl Into<String>, value: impl Into<String>) -> Self

Set an environment variable for the subprocess.

pub fn bearer_token_env_var(self, env_var: impl Into<String>) -> Self

Name the environment variable holding the bearer token.

The token itself is never part of the configuration: only the name of the variable to read it from, matching mcp add --bearer-token-env-var. Ignored for a stdio server.

pub fn env_http_header( self, header: impl Into<String>, env_var: impl Into<String>, ) -> Self

Source an HTTP request header from an environment variable.

Both arguments are names: header is sent on each request and env_var is read by Codex for its value. The secret itself therefore stays out of argv and persistent configuration. Ignored for a stdio server.

pub fn required(self) -> Self

Require this server to initialize successfully.

Codex otherwise treats an unavailable MCP server as a warning and may continue without capabilities the caller expected to be present.

Trait Implementations

impl Clone for McpServerConfig

fn clone(&self) -> McpServerConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for McpServerConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for McpServerConfig

impl PartialEq for McpServerConfig

fn eq(&self, other: &McpServerConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for McpServerConfig