import changes from upstream

docs/EXAMPLES.md

@@ -122,15 +122,15 @@ List of work items for Stories backlog. But then go thru and find all the securi
 
 📽️ [Azure DevOps MCP Server: Triage Work](https://youtu.be/gCI_pPS76C8)
 
-### Adding and Updating Work Items Using the `format` Paramater
+### Adding and Updating Work Items Using the `format` Parameter
 
-You can use the `format` paramater to indicate markdown formatting for large text fields. It is now available on the following tools:
+You can use the `format` parameter to indicate markdown formatting for large text fields. It is now available on the following tools:
 
 - **wit_update_work_items_batch**
 - **wit_add_child_work_items**
 - **wit_create_work_item**
 
-> 🚩 HTML is the default unless `Markdown` is explicity set.
+> 🚩 HTML is the default unless `Markdown` is explicitly set.
 
 ```text
 Update work item 12345 with a new description and use Markdown text. Use Markdown format param. Use bulk update.

docs/FAQ.md

@@ -28,6 +28,6 @@ Unfortunately, personal accounts are not supported. To maintain a higher level o
 
 ![image of login error for personal accounts](./media/personal-accounts-error.png)
 
-## When will a remote Azure DevOps MCP Server be availble?
+## When will a remote Azure DevOps MCP Server be available?
 
 We receive this question frequently. The good news is that work is currently underway. Development began in early January 2026. Once we can provide a reliable timeline, we will publish it on the public [Azure DevOps roadmap](https://learn.microsoft.com/en-us/azure/devops/release-notes/features-timeline).

docs/GETTINGSTARTED.md

@@ -7,6 +7,7 @@ This guide will help you get started with the Azure DevOps MCP Server in differe
 - [Getting started with Visual Studio Code & GitHub Copilot](#️-visual-studio-code--github-copilot)
 - [Getting started with Visual Studio 2022 & GitHub Copilot](#%EF%B8%8F-visual-studio-2022--github-copilot)
 - [Getting started with GitHub Copilot CLI](#-using-mcp-server-with-github-copilot-cli)
+- [Getting started with Codex](#-using-mcp-server-with-codex)
 - [Getting started with Claude Code](#-using-mcp-server-with-claude-code)
 - [Getting started with Claude Desktop](#️-using-mcp-server-with-claude-desktop)
 - [Getting started with Cursor](#-using-mcp-server-with-cursor)
@@ -356,6 +357,49 @@ Replace `{Contoso}` with your Azure DevOps organization name.
 
 For more information, see the [Copilot CLI documentation](https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli).
 
+### 🤖 Using MCP Server with Codex
+
+Codex can run the Azure DevOps MCP Server as a local stdio MCP server from either the Codex CLI or IDE extension. The configuration is shared through `~/.codex/config.toml`.
+
+#### Interactive authentication
+
+For local development, start with the default interactive authentication flow:
+
+```bash
+codex mcp add azure-devops -- npx -y @azure-devops/mcp Contoso
+```
+
+Replace `Contoso` with your Azure DevOps organization name.
+
+Verify that Codex can see the server:
+
+```bash
+codex mcp list
+```
+
+On first use of an Azure DevOps tool, the MCP server opens a browser window for Microsoft account sign-in. Use an account that has access to the selected Azure DevOps organization.
+
+#### Azure CLI authentication
+
+If your workstation already uses Azure CLI sign-in, authenticate first and configure the MCP server with `azcli`:
+
+```bash
+az login
+codex mcp add azure-devops -- npx -y @azure-devops/mcp Contoso --authentication azcli
+```
+
+#### Manual `config.toml` configuration
+
+You can also edit `~/.codex/config.toml` directly:
+
+```toml
+[mcp_servers.azure-devops]
+command = "npx"
+args = ["-y", "@azure-devops/mcp", "Contoso"]
+```
+
+Restart Codex after editing the config manually, then ask for a simple read-only operation such as `List ADO projects`.
+
 ### 🤖 Using MCP Server with Claude Code
 
 See https://docs.anthropic.com/en/docs/claude-code/mcp for general guidance on adding MCP Server to Claude Code experience.