Skip to content

docs: recover byo-harness-mcp-registration.md from #752 - #895

Merged
omesser merged 2 commits into
mainfrom
cursor/recover-byo-harness-research-8729
Sep 22, 2026
Merged

omesser merged 2 commits into
mainfrom
cursor/recover-byo-harness-research-8729

Conversation

@omesser

@omesser omesser commented Sep 22, 2026 •

Copy link
Copy Markdown
Owner

Why

The initial registration research document from closed PR #752 provides historical context for BYO harness registration. The document is referenced by existing research in byo-harness-mcp-reload.md and complements it by covering initial registration (while the reload file covers reconfiguration).

This is an archival recovery, preserving research that was lost when the branch was deleted.

What changed

Recovered docs/research/byo-harness-mcp-registration.md from commit 97d7a54 in closed PR #752.

The file documents:

  • How each of the five harnesses registers an MCP server with bearer token authentication
  • What the Settings UI box needs to contain for each harness
  • The token problem and potential solutions
  • Side-by-side comparison of registration mechanisms

This is distinct from the existing byo-harness-mcp-reload.md, which covers reconfiguration and reload after URL/token changes.

How to verify

  1. Read the recovered file at docs/research/byo-harness-mcp-registration.md
  2. Compare with the existing docs/research/byo-harness-mcp-reload.md to verify they are complementary, not overlapping
  3. Note that the reload file explicitly references "spike(harness): How each Harness registers a BYO MCP server, and whether it can send a bearer token #580's initial registration research" - this is that research

Notes

Archival docs-only recovery. Recovered from #752 @ 97d7a54. Optional context: Refs #580.

— Cursor agent (Coder), on @omesser's behalf.

Open in Web Open in Cursor 

Recovers the initial registration research document from commit 97d7a54
(closed PR #752, branch docs/byo-harness-registration was deleted).

This document complements the existing byo-harness-mcp-reload.md by
covering initial registration, while the reload file covers
reconfiguration after URL/token changes.

What: Restore docs/research/byo-harness-mcp-registration.md
Why: Referenced by existing research, provides historical context for #580
How to test: Read the file and verify it complements existing research

Refs #580
Recovered from #752 @ 97d7a54

Co-authored-by: Oded Messer <odedmesser@gmail.com>

@omesser omesser left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

Architect — CLEARED with one soft @ 3d163a47

Docs-only recovery of docs/research/byo-harness-mcp-registration.md from #752 @ 97d7a54. No lineno clutter. Complements byo-harness-mcp-reload.md. #580 stays closed; Refs #580 is fine.

Soft (non-blocking but strongly preferred before merge)

Add a short archival banner at the top (5–10 lines): this is a historical probe snapshot (pre-#599 token surface; Codex then read-only; some “no CLI register” wording later corrected in-thread). Point readers to Settings BYO (#599) + docs/DEVELOPMENT.md for current product, and to byo-harness-mcp-reload.md for mid-session/reload. Do not rewrite the whole table in this PR.

Soft

  • Mark ready for review when you want (still draft).
  • Windows check was still settling at review time; docs-only.

Oded may merge after the banner (or as-is if he wants pure byte recovery).

— Cursor agent (Architect), on @omesser's behalf.

Points readers to current BYO UI, DEVELOPMENT docs, and reload research.

Co-authored-by: Oded Messer <odedmesser@gmail.com>
@omesser
omesser marked this pull request as ready for review September 22, 2026 14:38

@omesser omesser left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

Architect — CLEARED @ 1fba3334

Archival banner present; points to Settings BYO, DEVELOPMENT, and byo-harness-mcp-reload.md. Docs-only; ready for review; #580 stays closed. Soft: prefer docs/DEVELOPMENT.md in the banner path for consistency. Oded may merge.

— Cursor agent (Architect), on @omesser's behalf.

@omesser
omesser merged commit 6c5dac0 into main Sep 22, 2026
5 checks passed
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.

2 participants