Skip to content

Add per-server MCP extension data - #26

Closed
jonathanhefner wants to merge 1 commit into
agent/simplify-manifest-validationfrom
agent/mcp-server-extensions
Closed

jonathanhefner wants to merge 1 commit into
agent/simplify-manifest-validationfrom
agent/mcp-server-extensions

Conversation

@jonathanhefner

@jonathanhefner jonathanhefner commented Sep 29, 2026 •

Copy link
Copy Markdown
Owner

Stacked on agentplugins/agent-plugins-spec#82.

Summary

This PR adds an optional extensions field to each MCP server configuration in Agent Plugins 1.1.0, using the same namespace model as plugin.json. Plugin authors can keep client-specific server settings alongside the portable configuration.

Motivation

In openai/codex#38438, a plugin author needed to pass an environment variable such as DB_PASSWORD to an MCP server. Codex supported this through an env_vars list in its native configuration, but portable mcp.json had no place for that client-specific setting. The Codex fix reads a second, legacy configuration and matches servers by name to obtain their environment-variable lists.

Rationale

Keeping client-specific settings beside the MCP server they affect lets authors configure that server in one place, without maintaining a separate mapping that must stay synchronized when servers are renamed or copied. Reusing the existing extension model gives clients a place for native settings while keeping their meaning client-owned.

Comment thread spec/1.1.0.md Outdated
Comment thread spec/1.1.0.md Outdated
Comment thread spec/1.1.0.md Outdated
Comment thread spec/1.1.0.md Outdated
@jonathanhefner
jonathanhefner force-pushed the agent/mcp-server-extensions branch from 8f3b09b to 76c7a66 Compare September 30, 2026 00:49
@jonathanhefner
jonathanhefner changed the base branch from start-v1.1.0 to agent/simplify-manifest-validation September 30, 2026 00:49
Comment thread spec/1.1.0.md Outdated
Comment thread spec/1.1.0.md Outdated
Comment thread spec/1.1.0.md Outdated
Allow client-specific settings beside each MCP server configuration so
authors do not need a separate mapping keyed by server name.

Reuse reverse-domain extension namespaces across all transport variants.
Validate container shapes through the existing server failure boundary
while leaving namespace object contents and implemented extension
behavior client-defined. Preserve portable environment semantics and the
published 1.0 contract.
@jonathanhefner
jonathanhefner force-pushed the agent/mcp-server-extensions branch from 76c7a66 to 3202fe4 Compare September 30, 2026 15:17
@jonathanhefner

Copy link
Copy Markdown
Owner Author

Submitted as agentplugins#85.

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