Skip to content

docs(messaging): document Claude Code MCP setup and reply checks - #8949

Draft
HojooonKim wants to merge 1 commit into
lidge-jun:devfrom
HojooonKim:codex/docs-mcp-client-setup
Draft

HojooonKim wants to merge 1 commit into
lidge-jun:devfrom
HojooonKim:codex/docs-mcp-client-setup

Conversation

@HojooonKim

@HojooonKim HojooonKim commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary

The messaging reference shows an MCP server entry but leaves readers to figure out where to put it and how to tell whether Codex answered. Document workspace-scoped registration for the Claude Code CLI and the local Code tab in Claude Desktop. Walk through opening an idle Codex test conversation, submitting one message, and using the same receipt to check the final reply without re-sending on timeout or an uncertain result.

Link the Spanish and Turkish references to the walkthrough. The Desktop Chat surface uses separate configuration; this walkthrough covers the CLI and Code tab. Documentation only; the existing tool and permission behavior is unchanged. Follow-up to #7999, #8053, and #8090.

Verification

  • Base at validation: upstream dev e6432dbc6. Bun 1.4.4 on macOS.
  • cd docs-site && bun install --frozen-lockfile && bun run build: passed, 811 pages and 124,235 internal links checked.
  • bun test tests/cli/cli-message-mcp.test.ts tests/codex-integration/messaging-mcp-wait.test.ts: 29 passed, 0 failed. bun run typecheck (2,652 files), bun run privacy:scan, bun run structure:check, and git diff --cached --check passed.
  • Installed the published OpenCodex 2.100.5 package in a scratch directory. ocx help message mcp showed the documented flags; the documented claude mcp add --scope local invocation followed by claude mcp get opencodex-queue returned Connected in a temporary Claude config. Direct stdio MCP tools/list returned exactly two default tools and four with --allow-reply-read.
  • Previously ran the actual Claude Code 2.1.317 CLI and Claude Desktop 5.11492.5 Code tab round trips against merged dev c320932c1 with Codex CLI 0.166.0 and disposable homes. Each sent once, used the same receipt, and observed the expected stored final answer. The Desktop Chat surface was outside those runs.
  • Repeated the full CLI round trip with published OpenCodex 2.100.5, Claude Code 2.1.328 and the documented local registration in temporary config. The CLI found the exact idle test thread, queued once, received the expected text through codex_wait_reply using the same receipt, and the Codex history contained the correlated input and final text in one completed turn. Desktop Code was verified on merged dev as noted above.
  • The full local suite was omitted for the documentation-only diff. The site build, direct client registration, and focused MCP regressions cover the changed instructions; hosted CI results are pending.

Checklist

  • Scope stays focused and avoids unrelated cleanup.
  • Docs or release notes were updated when needed.
  • Security-sensitive changes were reviewed for secrets, auth, and unsafe defaults. The example uses placeholder paths and documents the existing reply-read opt-in.

Review readiness checklist

  • Required local validation passed; commands, results, and any full-suite exception are documented.
  • I pushed my PR to a recent dev commit (at most 10 behind; a maintainer may still ask for the exact tip before merge).
  • I resolved all correct Codex and CodeRabbit findings.
  • My PR is ready for review.

@coderabbitai

coderabbitai Bot commented Nov 19, 2026

Copy link
Copy Markdown
Contributor

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@github-actions

Copy link
Copy Markdown
Contributor

✅ Deterministic PR hygiene checks passed.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Nov 19, 2026
@github-actions

github-actions Bot commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

⏳ DRAFT

  • review readiness checklist open (2/4 boxes ticked).

What to do

  • Tick all four boxes in the PR description once you're done (currently 2/4).

Review readiness checklist

  • ✅ Required local validation passed; commands, results, and any full-suite exception are documented.
  • ✅ I pushed my PR to a recent dev commit (at most 10 behind; a maintainer may still ask for the exact tip before merge).
  • ⬜ I resolved all correct Codex and CodeRabbit findings.
  • ⬜ My PR is ready for review.

2/4 boxes ticked.

This PR stays in draft until every box above is ticked.

Hygiene

✅ Deterministic PR hygiene checks passed.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant