Skip to content

P1-T3: Improve MCP settings examples in README to present broker setup first#122

Merged
SoundBlaster merged 10 commits intomainfrom
codex/feature/P1-T3-readme-broker-first-mcp-settings
Mar 1, 2026
Merged

P1-T3: Improve MCP settings examples in README to present broker setup first#122
SoundBlaster merged 10 commits intomainfrom
codex/feature/P1-T3-readme-broker-first-mcp-settings

Conversation

@SoundBlaster
Copy link
Owner

Description

Reorders and expands the MCP configuration examples in README.md so broker-based setup appears first for all three supported agents (Cursor, Claude Code, Codex CLI). Adds explicit broker mode / direct mode labels to all variant headings for clarity. No source code was changed.

Closes / implements: P1-T3 — Improve MCP settings examples in README to present broker setup first

Type of Change

  • Bug fix
  • New feature
  • Documentation update
  • Refactoring
  • CI/CD improvement

Quality Gates

Before submitting, ensure all quality gates pass:

make check

Or run individually:

  • make test - All tests pass with ≥90% coverage
  • make lint - No linting errors
  • make format - Code is properly formatted
  • make typecheck - Type checking passes
  • make doccheck - Documentation is synced with DocC (if docs changed)

Note: This PR contains only README.md documentation changes. No Python source files were modified, so make test, make lint, make format, and make typecheck are not applicable. CI will confirm.

Documentation Sync

docs/ file DocC file
README.md mcpbridge-wrapper.docc/mcpbridge-wrapper.md
  • Documentation changes are synced with DocC catalog (or N/A) — DocC counterpart (mcpbridge-wrapper.docc/mcpbridge-wrapper.md) does not exist in this repo; N/A.

Testing

  • Added/updated tests for new functionality
  • All tests pass locally
  • Manually tested the changes — diff reviewed in SPECS/ARCHIVE/P1-T3_Improve_MCP_settings_examples_in_README_to_present_broker_setup_first/P1-T3_Validation_Report.md

Checklist

  • Code follows the project's style guidelines
  • Self-review completed
  • Comments added for complex code
  • Documentation updated (if needed)
  • No new warnings generated
  • PR title is descriptive

@chatgpt-codex-connector
Copy link

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

SoundBlaster and others added 3 commits March 1, 2026 02:34
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add local development (venv, direct mode) sections to DocC for Cursor,
  Claude Code, and Codex CLI to match README content
- Add missing manual installation with Web UI sections to Claude Code and
  Codex CLI in DocC
- Fix manual installation paths in DocC to use ~/bin/ (matching README)
- Apply consistent direct-mode label to Zed agent venv headings in README

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add broker-spawn as the recommended (first) config in the Cursor Quick
Setup section of README and DocC. Rename "Broker Mode (Optional)" to
"Broker Mode" to match the promoted recommendation. Retain direct mode
as a labelled alternative.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@SoundBlaster SoundBlaster merged commit 5d7b936 into main Mar 1, 2026
10 checks passed
@SoundBlaster SoundBlaster deleted the codex/feature/P1-T3-readme-broker-first-mcp-settings branch March 1, 2026 01:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant