Skip to content

Design system MCP: Document Codex CLI prerequisite for MCP setup#79917

Merged
mirka merged 2 commits into
trunkfrom
docs/design-system-mcp-codex-cli-note
Jul 7, 2026
Merged

Design system MCP: Document Codex CLI prerequisite for MCP setup#79917
mirka merged 2 commits into
trunkfrom
docs/design-system-mcp-codex-cli-note

Conversation

@mirka

@mirka mirka commented Jul 6, 2026

Copy link
Copy Markdown
Member

What?

Adds a note to the design system MCP setup instructions clarifying that OpenAI Codex users need the Codex CLI installed before running codex mcp add.

Why?

It might not be obvious to a non-technical reader.

Testing Instructions

  1. Open packages/design-system-mcp/README.md.
  2. Confirm the OpenAI Codex section mentions the Codex CLI prerequisite and links to the setup guide.

@mirka mirka self-assigned this Jul 6, 2026
@mirka mirka added the [Type] Developer Documentation Documentation for developers label Jul 6, 2026
@mirka mirka changed the title Document Codex CLI prerequisite for design system MCP setup Design system MCP: Document Codex CLI prerequisite for MCP setup Jul 6, 2026
@mirka mirka marked this pull request as ready for review July 6, 2026 20:34
@mirka mirka requested a review from a team as a code owner July 6, 2026 20:34
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: mirka <0mirka00@git.wordpress.org>
Co-authored-by: aduth <aduth@git.wordpress.org>
Co-authored-by: ciampo <mciampini@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@aduth aduth left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not as familiar with the Codex family of tools, but would it also work to append "CLI" in the subheading to clarify? It feels like a similar distinction between Claude Code and Claude Desktop, and we don't document that "Claude Code must be installed first" in the section about it. Or maybe we should, just to be extra consistent between the app and CLI variants of these tools 😄

@mirka

mirka commented Jul 6, 2026

Copy link
Copy Markdown
Member Author

My understanding was that the CLI tooling provides a convenient way to add the MCP server to the Codex desktop app config as well, not just configure it for the CLI itself. Is that correct @ciampo?

@ciampo

ciampo commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

AFAIK, the Codex app doesn't add codex to the PATH. In order to have that (and run the mcp add command) a users need to install the CLI.

Users can also install an MCP server via the app's GUI by essentially filling a form.

For example, this is is what I see in the Codex app after running the CLI command — essentially, they're just two different ways to set the same settings

Screenshot 2026-07-07 at 07 34 47

@mirka

mirka commented Jul 7, 2026

Copy link
Copy Markdown
Member Author

Thanks for clarifying. It's probably reasonable to just document the CLI way, as it's most convenient and unlikely to get outdated due to app-side changes.

@mirka mirka merged commit 205832e into trunk Jul 7, 2026
47 of 49 checks passed
@mirka mirka deleted the docs/design-system-mcp-codex-cli-note branch July 7, 2026 17:41
@github-actions github-actions Bot added this to the Gutenberg 23.6 milestone Jul 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Type] Developer Documentation Documentation for developers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants