Parent
#328. Related: #230, #232. Takes over the Claude Code test from #231.
What to build
docs/mcp/README.md tells people how to connect docs.plus to an AI app. Each untested section carries a PENDING-HOST-TEST marker. A person connects each AI app to production, follows its section word for word, and runs every tool once. Each step that does not match the app gets corrected.
Tool smoke run
In each AI app:
create_document makes a scratch pad with two ## headings.
- Open one heading's chat in docs.plus once.
find_documents finds the pad by title.
get_outline lists both headings.
read_document reads one section.
append_to_document adds a line at the end.
edit_blocks inserts one paragraph after block 2 of a section, and replace_text changes one word in that section. The heading stays, and no media is removed.
- In Claude Code,
read_document with a section_id returns the section text, not only metadata (see "Return the document and chat text where Claude Code reads it").
list_chat_rooms lists the open chat.
read_chat_thread reads it.
post_chat_message posts in it. The post shows in that chat in docs.plus.
Then follow §Disconnect. The app leaves Apps with access.
Acceptance criteria
Agent brief
Type: HITL. A person with claude.ai, ChatGPT with Developer mode, and Claude Code runs the tests. An agent then makes the doc edits from the posted results.
Rules: .cursor/skills/tech-writer/SKILL.md §Simplified English; CONTEXT.md §MCP connector.
Verify: grep -n "PENDING-HOST-TEST" docs/mcp/README.md lists only untested or failed sections. bunx prettier --check docs/mcp/README.md passes.
Out of scope
Parent
#328. Related: #230, #232. Takes over the Claude Code test from #231.
What to build
docs/mcp/README.mdtells people how to connect docs.plus to an AI app. Each untested section carries aPENDING-HOST-TESTmarker. A person connects each AI app to production, follows its section word for word, and runs every tool once. Each step that does not match the app gets corrected.Tool smoke run
In each AI app:
create_documentmakes a scratch pad with two##headings.find_documentsfinds the pad by title.get_outlinelists both headings.read_documentreads one section.append_to_documentadds a line at the end.edit_blocksinserts one paragraph after block 2 of a section, andreplace_textchanges one word in that section. The heading stays, and no media is removed.read_documentwith asection_idreturns the section text, not only metadata (see "Return the document and chat text where Claude Code reads it").list_chat_roomslists the open chat.read_chat_threadreads it.post_chat_messageposts in it. The post shows in that chat in docs.plus.Then follow §Disconnect. The app leaves Apps with access.
Acceptance criteria
http://localhost:<port>as an app on this computer.docs/mcp/README.md, with the app's current label text.apps/hocuspocus.server/API.md§Supported hosts states the Claude Code result.Agent brief
Type: HITL. A person with claude.ai, ChatGPT with Developer mode, and Claude Code runs the tests. An agent then makes the doc edits from the posted results.
Rules:
.cursor/skills/tech-writer/SKILL.md§Simplified English;CONTEXT.md§MCP connector.Verify:
grep -n "PENDING-HOST-TEST" docs/mcp/README.mdlists only untested or failed sections.bunx prettier --check docs/mcp/README.mdpasses.Out of scope