docs: update MCP documentation with 'fallow' registration instructions

[colinwilliams91]

Added instructions for registering 'fallow' MCP and updating Claude MCP settings, when .claude/settings.json does not successfully register

[colinwilliams91]

The original docs on adding fallow MCP to Claude did not work for me. My changes worked.

System:

• Ubuntu 26.04 LTS
• x86_64
• 2.1.153 (Claude Code)

[BartWaardenburg]

Thank you for this, @colinwilliams91, and sorry it took so long to come back to you.

You were right, and the problem was worse than the page let on. Claude Code does not read mcpServers from .claude/settings.json at all, and it fails silently, so the documented snippet looked applied and registered nothing. Reproduced with both files side by side in an empty directory:

.claude/settings.json → probe-in-settings
.mcp.json             → probe-in-mcpjson

$ claude mcp list
probe-in-mcpjson: true  - ⏸ Pending approval

Only the second one ever shows up.

I rewrote the Claude Code tab around your fix rather than merging this branch, because the original instruction needed to be removed rather than keep a working fallback underneath it. It now leads with claude mcp add fallow --scope user fallow-mcp, exactly what you suggested, documents --scope project and the .mcp.json it writes for teams, and carries a warning that the settings file is ignored so nobody loses an afternoon to it again. Your report is credited in the commit, 4fc90f8.

Closing in favor of that change. Thanks for taking the trouble to write up what actually worked, with the system details included. That is what made it quick to confirm.