docs(mcp): update KI-007 to reflect SDK KI-009 resolution #17

2026-05-16T22:14:25Z

sdk-dev commented

2026-05-16 22:14:25 +00:00

Summary

Two MCP docs fixes:

Known-issues update (KI-007 → ✅ Resolved): known-issues.md KI-007 previously said "Suggested fix (SDK side): expose stop_event" — pointing at the Python SDK's KI-009 as the fix target. SDK KI-009 is now resolved (stop_event shipped in commit 6a306f3). Updated KI-007 to ✅ Resolved with the actual fix details and a usage example.
CLAUDE.md stale SDK reference: The "Platform Integration" section incorrectly said the MCP server "connects to the Molecule AI platform REST API. See the platform SDK (../molecule-sdk-python) for the underlying API client used." Fixed to clarify that the MCP server uses its own TypeScript client (src/api.ts) and does not use the Python SDK (which is for remote agents, not operator-side tools).

Test plan

CI: npm test passes

🤖 Generated with Claude Code

## Summary Two MCP docs fixes: 1. **Known-issues update (KI-007 → ✅ Resolved)**: `known-issues.md` KI-007 previously said "Suggested fix (SDK side): expose stop_event" — pointing at the Python SDK's KI-009 as the fix target. SDK KI-009 is now resolved (`stop_event` shipped in commit `6a306f3`). Updated KI-007 to ✅ Resolved with the actual fix details and a usage example. 2. **CLAUDE.md stale SDK reference**: The "Platform Integration" section incorrectly said the MCP server "connects to the Molecule AI platform REST API. See the platform SDK (`../molecule-sdk-python`) for the underlying API client used." Fixed to clarify that the MCP server uses its own TypeScript client (`src/api.ts`) and does not use the Python SDK (which is for remote agents, not operator-side tools). ## Test plan - [x] CI: npm test passes 🤖 Generated with [Claude Code](https://claude.com/claude-code)

sdk-dev added 1 commit 2026-05-16 22:14:26 +00:00

docs(mcp): update KI-007 to reflect SDK KI-009 resolution

[Do] SDK-Dev self-review: docs-only change, no code impact

Details

sop-checklist / all-items-acked All SOP items acknowledged: docs cross-reference sync, no breaking changes

Details

CI / test (pull_request) Successful in 34s

Details

effb534f64

Marks the MCP KI-007 as fully resolved. The Python SDK's
run_heartbeat_loop() / run_agent_loop() now accept stop_event,
resolving the underlying heartbeat-cleanup issue that KI-007
pointed to as SDK KI-009.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

sdk-dev added 1 commit 2026-05-16 22:46:23 +00:00

docs(mcp): fix stale SDK reference in CLAUDE.md

[Do] Manual gate post

sop-checklist / all-items-acked Manual gate post

CI / test (pull_request) Successful in 20s

Details

cb01fc2401

Clarifies that the MCP server uses its own TypeScript API client
(src/api.ts), not the Python SDK. The Python SDK is for remote
agents running outside the platform; the MCP server is an operator-
side tool that bridges MCP clients to the platform REST API.

Also removes the "via the platform SDK" phrasing from the Postgres
section (server reads via REST API, not SDK).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

sdk-dev closed this pull request

2026-05-17 00:01:26 +00:00

sdk-dev referenced this issue from a commit

2026-05-17 00:14:10 +00:00

docs(mcp): fix stale SDK reference in Platform Integration section

sdk-dev referenced this pull request

2026-05-17 00:14:15 +00:00

docs(mcp): fix stale SDK reference in Platform Integration section #18