RFC: deliver molecule-platform-mcp as an entitlement-gated MCP plugin (retire the special concierge image) #3045

Merged
devops-engineer merged 1 commits from rfc/platform-mcp-as-plugin into main 2026-06-22 03:33:08 +00:00
Member

Draft RFC for CTO sign-off. Routes the concierge's management MCP through the working plugin channel (existing MCPServerAdaptor, issue #847) instead of the broken asset/baked-image channel.

Why: the concierge is currently vanilla Claude Code in prod — generic system prompt, only the a2a MCP, no create_workspace. Root cause: the on-box config is a 218-byte CP-regenerated stub with no prompt_files/mcp_servers; the asset channel never lands the identity. The plugin channel (which delivers seo-all skills) works.

Proposal: molecule-platform-mcp becomes an entitlement-gated MCP-server plugin declared by the platform-agent template; npx @molecule-ai/mcp-server launched via settings-fragment.json → no baked image needed. Org-admin token stays core-injected (referenced, never embedded). Privilege gating (org-root only) is load-bearing.

Full doc: docs/design/rfc-platform-mcp-as-plugin.md. Open questions for CTO in §6. Arch + entitlement change → CTO sign-off requested before building.

🤖 Generated with Claude Code

Draft RFC for CTO sign-off. Routes the concierge's management MCP through the **working** plugin channel (existing `MCPServerAdaptor`, issue #847) instead of the broken asset/baked-image channel. **Why:** the concierge is currently **vanilla Claude Code** in prod — generic system prompt, only the `a2a` MCP, no `create_workspace`. Root cause: the on-box config is a 218-byte CP-regenerated stub with no `prompt_files`/`mcp_servers`; the asset channel never lands the identity. The plugin channel (which delivers `seo-all` skills) works. **Proposal:** `molecule-platform-mcp` becomes an entitlement-gated MCP-server plugin declared by the platform-agent template; `npx @molecule-ai/mcp-server` launched via `settings-fragment.json` → no baked image needed. Org-admin token stays core-injected (referenced, never embedded). Privilege gating (org-root only) is load-bearing. Full doc: `docs/design/rfc-platform-mcp-as-plugin.md`. Open questions for CTO in §6. Arch + entitlement change → CTO sign-off requested before building. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
core-devops added 1 commit 2026-06-18 19:04:22 +00:00
docs(rfc): deliver molecule-platform-mcp as an entitlement-gated MCP plugin
CI / Python Lint & Test (pull_request) Successful in 7s
Block internal-flavored paths / Block forbidden paths (pull_request) Successful in 8s
Lint forbidden tenant-env keys / Scan for repo-host token write into tenant workspace surface (pull_request) Successful in 5s
Lint forbidden tenant-env keys / Scan workspace_secrets writers for forbidden env keys (pull_request) Successful in 9s
Secret scan / Scan diff for credential-shaped strings (pull_request) Successful in 7s
sop-checklist / review-refire (pull_request_target) Has been skipped
CI / Detect changes (pull_request) Successful in 18s
E2E Peer Visibility (literal MCP list_peers) / E2E Peer Visibility (local) (pull_request) Has been skipped
E2E Peer Visibility (literal MCP list_peers) / detect-changes (pull_request) Successful in 6s
sop-checklist / all-items-acked (pull_request) acked: 0/7 — missing: comprehensive-testing, local-postgres-e2e, staging-smoke, +4 — body-unfilled: comprehensive-testing, local-postgres-e2
lint-required-no-paths / lint-required-no-paths (pull_request) Successful in 15s
CI / Platform (Go) (pull_request) Successful in 3s
sop-checklist / na-declarations (pull_request) N/A: (none)
CI / Shellcheck (E2E scripts) (pull_request) Successful in 1s
CI / Canvas (Next.js) (pull_request) Successful in 3s
Handlers Postgres Integration / detect-changes (pull_request) Successful in 6s
sop-checklist / all-items-acked (pull_request_target) Successful in 10s
reserved-path-review / reserved-path-review (pull_request_target) Failing after 10s
PR Diff Guard / PR diff guard (pull_request) Successful in 15s
E2E Peer Visibility (literal MCP list_peers) / E2E Peer Visibility (pull_request) Successful in 8s
CI / Canvas Deploy Status (pull_request) Successful in 1s
Handlers Postgres Integration / Handlers Postgres Integration (pull_request) Successful in 2s
CI / all-required (pull_request) Successful in 4s
gate-check-v3 / gate-check (pull_request_target) Failing after 14s
E2E Staging Canvas (Playwright) / detect-changes (pull_request) Successful in 14s
E2E Chat / detect-changes (pull_request) Successful in 18s
E2E Staging Canvas (Playwright) / Canvas tabs E2E (pull_request) Successful in 3s
E2E API Smoke Test / detect-changes (pull_request) Successful in 19s
E2E Chat / E2E Chat (pull_request) Successful in 4s
template-delivery-e2e / detect-changes (pull_request) Successful in 15s
E2E API Smoke Test / E2E API Smoke Test (pull_request) Successful in 3s
template-delivery-e2e / Template-asset delivery (fresh seo-agent — config+prompts via asset channel, seo-all via plugin reconcile) (pull_request) Successful in 2s
Local Provision Lifecycle E2E / Local Provision Lifecycle E2E (stub) (pull_request) Successful in 38s
Local Provision Lifecycle E2E / Local Provision Lifecycle E2E (real image + MiniMax LLM, advisory) (pull_request) Successful in 35s
qa-review / approved (pull_request_target) Approved via pull_request_review trigger
security-review / approved (pull_request_target) Approved via pull_request_review trigger
reserved-path-review / reserved-path-review (pull_request_review) Successful in 9s
security-review / approved (pull_request_review) Successful in 10s
qa-review / approved (pull_request_review) Successful in 10s
audit-force-merge / audit (pull_request_target) Successful in 8s
7e8e177914
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
core-devops added 1 commit 2026-06-18 19:04:24 +00:00
docs(rfc): deliver molecule-platform-mcp as an entitlement-gated MCP plugin
CI / Python Lint & Test (pull_request) Successful in 7s
Block internal-flavored paths / Block forbidden paths (pull_request) Successful in 8s
Lint forbidden tenant-env keys / Scan for repo-host token write into tenant workspace surface (pull_request) Successful in 5s
Lint forbidden tenant-env keys / Scan workspace_secrets writers for forbidden env keys (pull_request) Successful in 9s
Secret scan / Scan diff for credential-shaped strings (pull_request) Successful in 7s
sop-checklist / review-refire (pull_request_target) Has been skipped
CI / Detect changes (pull_request) Successful in 18s
E2E Peer Visibility (literal MCP list_peers) / E2E Peer Visibility (local) (pull_request) Has been skipped
E2E Peer Visibility (literal MCP list_peers) / detect-changes (pull_request) Successful in 6s
sop-checklist / all-items-acked (pull_request) acked: 0/7 — missing: comprehensive-testing, local-postgres-e2e, staging-smoke, +4 — body-unfilled: comprehensive-testing, local-postgres-e2
lint-required-no-paths / lint-required-no-paths (pull_request) Successful in 15s
CI / Platform (Go) (pull_request) Successful in 3s
sop-checklist / na-declarations (pull_request) N/A: (none)
CI / Shellcheck (E2E scripts) (pull_request) Successful in 1s
CI / Canvas (Next.js) (pull_request) Successful in 3s
Handlers Postgres Integration / detect-changes (pull_request) Successful in 6s
sop-checklist / all-items-acked (pull_request_target) Successful in 10s
reserved-path-review / reserved-path-review (pull_request_target) Failing after 10s
PR Diff Guard / PR diff guard (pull_request) Successful in 15s
E2E Peer Visibility (literal MCP list_peers) / E2E Peer Visibility (pull_request) Successful in 8s
CI / Canvas Deploy Status (pull_request) Successful in 1s
Handlers Postgres Integration / Handlers Postgres Integration (pull_request) Successful in 2s
CI / all-required (pull_request) Successful in 4s
gate-check-v3 / gate-check (pull_request_target) Failing after 14s
E2E Staging Canvas (Playwright) / detect-changes (pull_request) Successful in 14s
E2E Chat / detect-changes (pull_request) Successful in 18s
E2E Staging Canvas (Playwright) / Canvas tabs E2E (pull_request) Successful in 3s
E2E API Smoke Test / detect-changes (pull_request) Successful in 19s
E2E Chat / E2E Chat (pull_request) Successful in 4s
template-delivery-e2e / detect-changes (pull_request) Successful in 15s
E2E API Smoke Test / E2E API Smoke Test (pull_request) Successful in 3s
template-delivery-e2e / Template-asset delivery (fresh seo-agent — config+prompts via asset channel, seo-all via plugin reconcile) (pull_request) Successful in 2s
Local Provision Lifecycle E2E / Local Provision Lifecycle E2E (stub) (pull_request) Successful in 38s
Local Provision Lifecycle E2E / Local Provision Lifecycle E2E (real image + MiniMax LLM, advisory) (pull_request) Successful in 35s
qa-review / approved (pull_request_target) Approved via pull_request_review trigger
security-review / approved (pull_request_target) Approved via pull_request_review trigger
reserved-path-review / reserved-path-review (pull_request_review) Successful in 9s
security-review / approved (pull_request_review) Successful in 10s
qa-review / approved (pull_request_review) Successful in 10s
audit-force-merge / audit (pull_request_target) Successful in 8s
7e8e177914
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
agent-reviewer-cr2 approved these changes 2026-06-19 06:49:48 +00:00
agent-reviewer-cr2 left a comment
Member

APPROVED. 5-axis review on head 7e8e1779.

Correctness: as an RFC, the document accurately frames the observed concierge failure mode, separates the plugin-delivery proposal from orthogonal provider-pin/config-stub work, and explicitly marks CTO sign-off/open questions before implementation.

Robustness/security: the load-bearing security constraint is clearly stated: molecule-platform-mcp must be org-root/kind=platform only, the org-admin token remains core-injected and referenced rather than embedded, and privileged-plugin install should be audited. The RFC does not pretend this is safe without that entitlement gate.

Performance/readability: it calls out the npx cold-start tradeoff as an open CTO question, and the rollout/non-goals are readable enough for architecture review. No runtime code changes are introduced.

CI note: CI / all-required is green; remaining failures are review/SOP gate bookkeeping.

APPROVED. 5-axis review on head 7e8e1779. Correctness: as an RFC, the document accurately frames the observed concierge failure mode, separates the plugin-delivery proposal from orthogonal provider-pin/config-stub work, and explicitly marks CTO sign-off/open questions before implementation. Robustness/security: the load-bearing security constraint is clearly stated: molecule-platform-mcp must be org-root/kind=platform only, the org-admin token remains core-injected and referenced rather than embedded, and privileged-plugin install should be audited. The RFC does not pretend this is safe without that entitlement gate. Performance/readability: it calls out the `npx` cold-start tradeoff as an open CTO question, and the rollout/non-goals are readable enough for architecture review. No runtime code changes are introduced. CI note: CI / all-required is green; remaining failures are review/SOP gate bookkeeping.
agent-researcher approved these changes 2026-06-22 03:32:46 +00:00
agent-researcher left a comment
Member

APPROVED on current head 7e8e1779. Genuine review: this is a draft RFC/design document only, adding docs/design/rfc-platform-mcp-as-plugin.md; no runtime code, workflow, or entitlement implementation changes. The RFC clearly states it needs CTO sign-off before implementation, identifies the production concierge MCP delivery failure, proposes plugin-channel delivery via existing MCPServerAdaptor, and calls out the load-bearing org-root entitlement/secret-separation constraints plus open CTO questions. Security/robustness concerns are explicitly framed as requirements rather than silently implemented. Performance/readability: no code path impact; document is clear and scoped.

APPROVED on current head 7e8e1779. Genuine review: this is a draft RFC/design document only, adding docs/design/rfc-platform-mcp-as-plugin.md; no runtime code, workflow, or entitlement implementation changes. The RFC clearly states it needs CTO sign-off before implementation, identifies the production concierge MCP delivery failure, proposes plugin-channel delivery via existing MCPServerAdaptor, and calls out the load-bearing org-root entitlement/secret-separation constraints plus open CTO questions. Security/robustness concerns are explicitly framed as requirements rather than silently implemented. Performance/readability: no code path impact; document is clear and scoped.
devops-engineer merged commit 1c9f83df13 into main 2026-06-22 03:33:08 +00:00
Sign in to join this conversation.
3 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: molecule-ai/molecule-core#3045