Files
Quadrapassel/docs/MCP_SETUP.md
T
Brian Holman d412e35c4e Implement CoCo 3 Quadrapassel and deliver build 01
Add gameplay, keyboard/joystick controls, disk-backed high scores and settings,
standard CMOC effects, and the approved C graphics renderer. Include the clearer
attributed font, title/credits updates, source-verified Modern and Classic (40.2)
scoring, meaningful regression fixtures, and recorded guest validation.

Deliver QUADPSL01.DSK with fresh high scores. Retain source, licenses and selected
guest evidence; exclude personal disks, private connections and build scratch.

Host rules/input/persistence/video checks and memory guards pass. Official
512 KB playtests pass the recorded checks; actual 128 KB/physical joystick
qualification and the normal-window buzzing retest remain pending.
2026-11-11 03:14:14 -07:00

3.9 KiB
Raw Blame History

MCP kickoff and connection inventory

Verified November 10, 2026 against installed official VCC Plus 3.5.5 (48). Keep private grant files and tokens outside Git. This is a connection record, not permission to inspect emulator implementation or another game's project.

Connection Live tools used Verification
Quadrapassel C project get_capabilities, read_project_inputs, refresh_project, build_project, get_build, owned-playtest tools Project A1AFAA7E-C427-4437-8D1C-EB68D8C225EF; this repository's root Makefile, files and hashes
Installed manuals/API (through the C connection) search_help, read_topic Read HSCREEN/HSET, keyboard, joystick, timer, SOUND, beep and PCLEAR topics
Archive Library (separate connection) search_archive, get_archive_citation Both succeeded; found Tandy's Color Computer 3 Extended Basic, PDF pages 152–153

At this chat's start no VCC Plus tools appeared in its tool catalog. Connections were exported through the installed app's normal native interface. Its public manual, vibe-coding-with-chatgpt/01-first-connection.html, explicitly permits ordinary STDIO MCP through /Applications/VCC Plus.app/Contents/Helpers/vcc-mcp with the two arguments --grant and the private grant filename. The unmodified installed helper is used by a small MCP client; no alternative server, private bridge or integration endpoint is used.

Archive Library has its own link button and Save Archive Search Connection… flow. Brian explicitly approved this connection on November 10. Its advertised build-48 tools return citations/locations, rather than full page text. Use the Archive Library native reader for the original page when needed. Do not infer that Archive MCP is unavailable from the C connection's tool inventory.

For future kickoff checks, distinguish configured, tools discovered, and successful request. Inventory each required connection separately before implementation or web fallback. Confirm the intended project and current revision before builds. Connection identity and advertised tools may change after a new export; discover them again, rather than inventing tool names or endpoints.

Example verified Archive reference:

  • Title: Color Computer 3 Extended Basic (Tandy).
  • Citation: sha256:26d4ca51f3477263f3e85269091104079ae88ad83c842cef0e3bc531324e7f5e:pdf_page:152.
  • Read in Archive Library: printed page 143, “Adding Pages (The PCLEAR Command)”. It describes the default four PMODE pages and reserving fewer pages.

Initial hardware-reference web lookups occurred before discovering the separate Archive connection. That was a discovery error, not a demonstrated Archive gap. Brian asked that the kickoff feedback be sent to Deploy VCC Plus Gitea; the approved concise feedback was delivered there. No emulator update is requested.

November 11 reconnection

Brian approved installed official VCC Plus 3.6.0 (51) and an idle desktop window. The same repository was opened through C Development and its private project connection renewed outside Git. A successful get_capabilities returned project 84772EFC-B651-4A98-B09E-932247575EA7, session 185C8449-CB9B-4A38-81C8-D43CDA4A3ABE, app build 51, approved Make recipe, and the expected Quadrapassel files. This connection still advertises fixed 512 KB disposable workers, MC6809/HD6309, graphics and audio captures. Archive access is separate and was not needed for this local font adaptation.

After Brian's November 11 restart, the old private grant expired. The same project connection was renewed through the supported interface. Current project 3D6A502C-E06D-46BC-9D19-191D741A16B9, revision 2, built and ran successfully on official build 51. get_machine_status read normal-session configuration; no writable disks or peripherals were removed to satisfy native-run blockers. The new candidate used only disposable playtests.