docs(mcp): document mcp.json options and custom-droid mcpServers#1175
Merged
Conversation
Add documentation for newly available MCP configuration surfaces: variable expansion in mcp.json values, enabledTools/disabledTools per-tool filtering, configurable per-server and global call timeouts, and the mcpServers field for scoping MCP servers to a custom droid. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
|
Droid finished @factory-davidgu's task —— View job The new MCP docs are clear and cover the added configuration surfaces well. Follow-ups: keep the JP localized pages in sync, document |
![factory-droid[bot]](https://avatars.githubusercontent.com/in/358017?s=60&v=4){kind=small}
factory-ain3sh
previously approved these changes
May 30, 2026
…n tip - Add mcp.callTimeoutMs row to the settings reference table - Add a supply-chain Tip near the popular stdio examples (EN + JP) recommending pinned npx versions for security-sensitive setups - Sync docs/jp/cli/configuration/mcp.mdx with the new schema fields (enabledTools, disabledTools, timeoutMs) and the three new sections: variable expansion, per-tool filtering, MCP call timeout - Sync docs/jp/cli/configuration/custom-droids.mdx with the mcpServers frontmatter field row and scoping subsection Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
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
Adds documentation for newly available MCP configuration surfaces:
mcp.jsonvalues —${VAR}/${VAR:-default}resolved from the environment at load time (CLI-161).enabledTools/disabledToolsarrays inmcp.json, with precedence and context-cost notes (CLI-510).timeoutMsplus globalmcp.callTimeoutMsinsettings.json, with resolution order (CLI-707).mcpServers— new frontmatter field that scopes a subagent to a subset of configured MCP servers (PR Factory-AI/factory-mono#14134 / CLI-728).Files changed
docs/cli/configuration/mcp.mdx— new schema fields plus three subsections (Variable expansion, Per-tool filtering, MCP call timeout).docs/cli/configuration/custom-droids.mdx—mcpServersrow in the metadata table and a new Scoping MCP servers to a droid subsection with an example.Linear / upstream
Naming used in drafts (
timeoutMs,mcp.callTimeoutMs, expansion fallback behavior) follows what's described in the Linear issues — please flag if the shipping implementation uses different identifiers and I'll align.