Skip to content

fix(release): add $schema to mcp.json in the OpenAI zip only - #61

Merged
oriolpetithelical merged 3 commits into
developfrom
fix/openai-zip-mcp-schema
Nov 12, 2026
Merged

oriolpetithelical merged 3 commits into
developfrom
fix/openai-zip-mcp-schema

Conversation

@oriolpetithelical

@oriolpetithelical oriolpetithelical commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Why

#58 removed "$schema" from plugins/helical-platform/mcp.json to clear the Anthropic Directory's LOCAL_CODE_UNKNOWN_KEY blocker. That worked: v1.0.6 passed the automated checks and is now awaiting review. But OpenAI then refused the 1.0.6 zip:

Invalid plugin package · helical-platform/plugin.json
Plugin-level test_cases require exactly one MCP server.

That $schema line is the only MCP-related difference between the accepted 1.0.5 zip and the refused 1.0.6 zip. A 1.0.6 zip with only $schema restored in mcp.json was accepted by OpenAI.

mcp.json Anthropic Directory (scans the repo) OpenAI (takes the zip)
with $schema ❌ blocked ✅
without $schema ✅ ❌

Changes

  • scripts/release.py: build_zip leaves out the committed mcp.json and adds a generated one with MCP_SCHEMA, using git archive --add-virtual-file. Git writes every entry, so the commit timestamp and file modes match the rest of the zip, and rebuilds stay byte-identical. If mcp.json already names a schema, it is packaged as is.
  • check_zip refuses a zip whose mcp.json has no $schema.
  • tests/helical-platform/test_plugin_manifest.py: the committed mcp.json must not have $schema.
  • DEVELOPING.md: documents the difference between the repo and the zip.

Bumps the plugin to 1.0.7 so the merge to main releases a zip built with this change. The helical-platform-v1.0.6 release zip has no $schema, so OpenAI refuses it.

Testing

  • make check passes: 47 tests, strict validation, install round-trips.
  • make package builds a 1.0.6 zip whose contents are identical to the one OpenAI accepted. Two builds give the same SHA-1.

Refs #25

OpenAI finds no MCP server in an mcp.json without $schema and refuses the
plugin-level test_cases; the Anthropic Directory refuses the field in the repo.
build_zip now packages a generated mcp.json that names the schema, and a
manifest test keeps the field out of the committed file.

Refs #25

@dmiv-helical dmiv-helical left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I wonder if this incompatibility is enforced on purpose.

@oriolpetithelical
oriolpetithelical merged commit 58e72ea into develop Nov 12, 2026
1 check 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