docs: expand MCP binding configuration reference#385
Merged
Conversation
…meout options Complete the mcp binding reference with the options and route properties exposed by the binding that were previously undocumented: - options.elicitation (callback) and options.timeout, common to all kinds - options.authorization (named guard) for server and client kinds - options.cache (store, ttl, authorization) for the proxy kind - routes when[].toolkit as proxy-only and required, with capability available to all kinds - routes with[].cache override Split the shared options/routes partials so each kind page reflects its kind-specific properties, and enrich the server and proxy examples. https://claude.ai/code/session_01Kmke6UevrnjCvVLCeNQmkA
The proxy route when condition now supports tools, prompts, and resources allow-lists of glob patterns that filter which tool names, prompt names, and resource URIs are exposed for a matched toolkit and capability. Each filter is valid only when its corresponding capability is enabled and is proxy-kind only. Update the proxy route reference and examples. https://claude.ai/code/session_01Kmke6UevrnjCvVLCeNQmkA
Replace the redis store reference in the mcp cache examples with a generic store name, since redis and hazelcast stores are not yet released in zilla-plus. https://claude.ai/code/session_01Kmke6UevrnjCvVLCeNQmkA
Revert the memory store reference back to a generic store name to avoid tying the example to a specific store implementation. https://claude.ai/code/session_01Kmke6UevrnjCvVLCeNQmkA
Reflect the develop refactor that makes mcp options fully kind-specific and removes route-based headers: - server options: elicitation (callback, timeout) and authorization; no routes, no prompts - client options: required server URL and authorization; no routes - proxy options: cache only; routes keep toolkit, capability, and the tools/prompts/resources filters - remove route with.headers (now cache override only) - drop the obsolete prompts option and top-level timeout (timeout moved under elicitation) https://claude.ai/code/session_01Kmke6UevrnjCvVLCeNQmkA
Add the proxy options.tools validation model that validates tools/call request arguments. https://claude.ai/code/session_01Kmke6UevrnjCvVLCeNQmkA
jfallows
force-pushed
the
claude/youthful-hamilton-0pIpI
branch
from
befbab0 to
6c33612
Compare
ankitk-me
approved these changes
Jul 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Reworks the MCP binding configuration reference to match the kind-specific configuration model on
develop. MCP options are now documented per kind (server,client,proxy) instead of as a single shared block, and routing is documented for theproxykind only.Key Changes
options-server.md—elicitation(callback,timeout) andauthorizationoptions-client.md— requiredserverupstream URL andauthorizationoptions-proxy.md—cache(store,ttl,authorization)options-authorization.md— shared guard-basedauthorizationpartial reused byserverandclientroutes-proxy.md):whenmatching ontoolkit(required),capability, and per-routetools/prompts/resourcesglob filters, plus awith.cachecredential overrideoptions.mdandroutes.md; removed thepromptsoption, the top-leveltimeout(nowelicitation.timeout), and routewith.headersserverandclientno longer document routes — routes are proxy-only@includewiring for each kindserver.yaml,client.yaml,proxy.yaml) to reflect the kind-specific optionsNotes
binding-mcpspec schema patch and config fixtures ondevelop.zilla-plusrelease, so the non-blockingschemaCheckerjob reports expected drift against the released schema snapshot until they ship.https://claude.ai/code/session_01Kmke6UevrnjCvVLCeNQmkA