-
Notifications
You must be signed in to change notification settings - Fork 46
Description
Is your feature request related to a problem? Please describe.
Users have no guidance on using ${input:...} variables in MCP server headers and env fields. The documentation at IDE & Tool Integration — MCP Server Declaration and the Manifest Schema reference don't mention this capability.
Depends on #342.
Describe the solution you'd like
Document ${input:...} variable support in the following pages:
-
docs/src/content/docs/integrations/ide-tool-integration.md— MCP Server Declaration section: add a subsection explaining${input:...}syntax inheadersandenv, with a practical example. -
docs/src/content/docs/reference/manifest-schema.md—headersandenvfield descriptions: note that values can contain${input:<id>}references for VS Code runtime prompting.
Content to include
-
${input:...}syntax — values inheadersandenvcan reference VS Code input variables using${input:<variable-id>}. -
How it works — for registry-backed servers, APM auto-generates input prompts from registry metadata. For self-defined servers, APM detects the patterns and generates matching definitions.
-
Runtime support matrix:
Runtime ${input:...}supportVS Code Yes — prompts user at runtime Copilot CLI No — use environment variables Codex No — use environment variables -
Examples:
dependencies: mcp: - name: my-server registry: false transport: http url: https://my-server.example.com/mcp/ headers: Authorization: "Bearer ${input:my-server-token}" X-Project: "${input:my-server-project}"
Describe alternatives you've considered
Leaving it undocumented, but this leads to user confusion (as evidenced by genuine questions about the feature).
Additional context
Keep documentation concise and task-oriented per project conventions. This should be a short subsection, not a separate page.