{"record":{"id":"1d8ffec39b3f8ad3","repo":"openai/codex","slug":"required-mcp-servers-failed-to-initialize-detail","errorCode":null,"errorMessage":"required MCP servers failed to initialize: {details}","messagePattern":"required MCP servers failed to initialize: (.+?)","errorType":"exception","errorClass":"anyhow::Error","httpStatus":null,"severity":"error","filePath":"codex-rs/codex-mcp/src/connection_manager/required.rs","lineNumber":56,"sourceCode":"            }\n            failures\n        }\n        .instrument(info_span!(\n            \"session_init.required_mcp_wait\",\n            otel.name = \"session_init.required_mcp_wait\",\n            session_init.required_mcp_server_count = self.required_servers.len(),\n        ))\n        .await;\n        if failures.is_empty() {\n            return Ok(());\n        }\n\n        let details = failures\n            .iter()\n            .map(|failure| format!(\"{}: {}\", failure.server, failure.error))\n            .collect::<Vec<_>>()\n            .join(\"; \");\n        Err(anyhow!(\n            \"required MCP servers failed to initialize: {details}\"\n        ))\n    }\n}\n\nfn startup_outcome_error_message(error: StartupOutcomeError) -> String {\n    match error {\n        StartupOutcomeError::Cancelled => \"MCP startup cancelled\".to_string(),\n        StartupOutcomeError::Failed { error, .. } => error,\n    }\n}\n","sourceCodeStart":38,"sourceCodeEnd":68,"githubUrl":"https://github.com/openai/codex/blob/339751715c64496cb86246bfb3935f40e309dd3d/codex-rs/codex-mcp/src/connection_manager/required.rs#L38-L68","documentation":"Error \"required MCP servers failed to initialize: {details}\" thrown in openai/codex.","triggerScenarios":"Thrown at codex-rs/codex-mcp/src/connection_manager/required.rs:56 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"339751715c64496cb86246bfb3935f40e309dd3d","analyzedAt":"2026-08-25T05:35:09.876Z","schemaVersion":2},"datasetVersion":"2026-08-25T06:17:31.827Z"}