docs: expand MCP binding configuration reference#385
Draft
jfallows wants to merge 2 commits into
Draft
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
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
2 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
Expanded and reorganized the MCP binding configuration documentation to include cache, authorization, and routing features. Split monolithic route documentation into binding-specific partials and added new configuration sections for proxy, client, and server bindings.
Key Changes
routes-proxy.md): Separated proxy-specific routing logic with toolkit matching, capability filtering, and glob patterns for tools/prompts/resourcesoptions-cache.md): Added cache store binding, TTL, and authorization credential configuration for upstream MCP responsesoptions-authorization.md): New partial documenting guard-based authorization for MCP sessionsproxy.yamlandserver.yamlpartials to demonstrate cache, authorization, and routing configurationsproxy.md,client.md, andserver.mdto include appropriate authorization and cache partialsImplementation Details
@includedirectives to compose reference pages from focused partials\*, header depth matching path depth)https://claude.ai/code/session_01Kmke6UevrnjCvVLCeNQmkA