Skip to content

Windows Codex App still fails to load native computer-use-mcp tool (invalid type: map, expected variant identifier) #16574

@MAE5blog

Description

@MAE5blog

What version of the Codex App are you using (From “About Codex” dialog)?

Windows app package: OpenAI.Codex_26.325.3894.0_x64__2p2nqsd0c76g0

The packaged Codex binary inside the app reports:

codex-cli 0.118.0-alpha.2

What subscription do you have?

No response

What platform is your computer?

Windows x64

What issue are you seeing?

Codex can see a native MCP server entry for computer-use, and the server itself starts successfully, but the MCP tool is silently unavailable to the model because Codex fails while converting the MCP tool schema into an OpenAI tool.

The exact error is:

Failed to convert "mcp__computer_use__computer" MCP tool to OpenAI tool: Error("invalid type: map, expected variant identifier", line: 0, column: 0)

As a result, the native computer-use-mcp tool cannot be used directly from Codex App on Windows, even though the underlying MCP server is healthy.

What steps can reproduce the bug?

  1. On Windows, configure a local stdio MCP server in ~/.codex/config.toml like this:
[mcp_servers.computer-use]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Users\Administrator\.codex\skills\computer-use-bridge\.runtime\node_modules\computer-use-mcp\dist\main.js']
cwd = 'C:\Users\Administrator\.codex\skills\computer-use-bridge\.runtime'
startup_timeout_sec = 30.0
  1. Verify the server is visible to Codex:
codex mcp list
codex mcp get computer-use
  1. Run a real invocation through the Codex App packaged binary (I copied the app’s resources\codex.exe to a temp path to execute it directly).

  2. Ask Codex to use the native MCP computer-use tool directly, for example:

Use the native MCP computer-use tool directly one time to read the current cursor position. Do not use shell commands or any bridge scripts.
  1. Observe that the server starts and shows as ready, but the tool is unavailable because Codex logs the schema conversion error.

What is the expected behavior?

If the MCP server starts successfully and exposes a valid tool, Codex should load that tool and make it available to the model for direct use.

Additional information

Notes from local verification:

  • The same machine can use the underlying computer-use-mcp server successfully through a shell bridge, so the server itself is not broken.
  • computer-use-mcp version is 1.7.0.
  • The server exposes a single tool named computer.
  • The failure reproduces not only with the Windows app packaged binary (0.118.0-alpha.2), but also with an older separately installed npm CLI (0.115.0).
  • Relevant log lines from the Windows app packaged binary run:
mcp: computer-use ready
Failed to convert "mcp__computer_use__computer" MCP tool to OpenAI tool: Error("invalid type: map, expected variant identifier", line: 0, column: 0)
Native MCP computer-use tool is unavailable in this session

For reference, computer-use-mcp tools/list returns an input schema like this:

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "key",
        "type",
        "mouse_move",
        "left_click",
        "left_click_drag",
        "right_click",
        "middle_click",
        "double_click",
        "scroll",
        "get_screenshot",
        "get_cursor_position"
      ]
    },
    "coordinate": {
      "type": "array",
      "items": [
        { "type": "number" },
        { "type": "number" }
      ]
    },
    "text": {
      "type": "string"
    }
  },
  "required": ["action"],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

This may be helpful if the failure is related to tuple-style items, MCP execution metadata, or another schema adaptation edge case.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingmcpIssues related to the use of model context protocol (MCP) serverswindows-osIssues related to Codex on Windows systems

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions