Skip to content

fix(ord): catalog MCP surfaces in ORD document (bump @cap-js/ord ^1.9.3) (#2249) - #2255

Merged
jung-thomas merged 1 commit into
DEVfrom
fix-2249-ord-mcp
Sep 11, 2026
Merged

jung-thomas merged 1 commit into
DEVfrom
fix-2249-ord-mcp

Conversation

@jung-thomas

Copy link
Copy Markdown
Contributor

Closes #2249.

What

Bumps @cap-js/ord from ^1.9.1 → ^1.9.3.

Why

The plugin was already integrated at 1.9.1 with cds.ord config, but MCP surfaces were not being cataloged in the generated ORD document. 1.9.1 silently dropped any CAP protocol missing from its internal CAP→ORD protocol map, and mcp was not in that map (only odata/rest/graphql/ina). @cap-js/ord 1.9.2 added mcp to the map; 1.9.3 is the current patch.

This directly delivers part (a) of the issue — generating ORD API resources for OData, REST, GraphQL, MCP, and INA protocols.

Verification (TEST THE ACTUAL THING)

cds compile srv --to ord after the bump — apiResources went from 25 → 30, with 5 new mcp entries:

apiProtocol count
odata-v4 20
graphql 4
mcp 5
rest 1

New mcp apiResources: AdminService, DeveloperService, HomepageService, KnowledgeGraphService, SearchService. The prior "Unknown protocol 'mcp' is not supported, and skipped" warnings are gone. The only remaining skips are websocket (DisplayService, EventStreamService) — expected, as WebSocket is not an ORD protocol.

Notes / out of scope

  • The two ORD smoke tests in test/smoke/public-endpoints.test.js remain it.skip ("routes not active in production CSN") — a separate, pre-existing plugin-wiring investigation, not addressed here.
  • CF mTLS securing of ORD endpoints (part b) and parallel cds build generation (part c) from the issue are runtime/deploy concerns not exercised by this dependency bump.

…2249)

@cap-js/ord 1.9.1 dropped protocols missing from its CAP→ORD protocol
map, so the 5 MCP-enabled services never appeared in the generated ORD
document. 1.9.2 added `mcp` to the map; 1.9.3 is the current patch.

Verified via `cds compile srv --to ord`: apiResources now include 5 mcp
entries (AdminService, DeveloperService, HomepageService,
KnowledgeGraphService, SearchService) alongside odata-v4/graphql/rest,
with no "Unknown protocol 'mcp'" warnings. Remaining websocket skips
(DisplayService, EventStreamService) are expected — not an ORD protocol.
@jung-thomas
jung-thomas merged commit c51776c into DEV Sep 11, 2026
6 of 7 checks passed
@jung-thomas
jung-thomas deleted the fix-2249-ord-mcp branch September 11, 2026 22:13
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.

1 participant