Skip to content

chore(mcp): drop .mcp.json — shared servers moved to user scope - #7

Merged
42piratas merged 1 commit into
mainfrom
chore/upgrade-mcp-centralize
Aug 14, 2026
Merged

chore(mcp): drop .mcp.json — shared servers moved to user scope#7
42piratas merged 1 commit into
mainfrom
chore/upgrade-mcp-centralize

Conversation

@42piratas

Copy link
Copy Markdown
Collaborator

Part of the fleet-wide MCP centralization. This repo's .mcp.json is removed — nothing it declared was unique to it.

Why

Kit 1.9.0 put four generic servers — exa, github, chrome-devtools, playwright — into every scaffolded project, and the P4 fleet pass carried them into 77 repos. Two consequences:

  1. Every future MCP change cost 77 pull requests. A new shared server, a moved endpoint, a renamed tool — all of it a fleet pass.
  2. Behaviour depended on cd. The same names already sat at user scope on different definitions (exa keyed via npx there, keyless HTTP here). Precedence is local > project > user, so the duplicate never errored — it silently resolved by whichever directory you were in.

The rule now: shared tooling is declared once at user scope; a project .mcp.json exists only for servers unique to that project. Measured across all 80 files in the fleet, nothing was unique — even 42bros-data is a fixed URL with an env-supplied token.

Verified before this landed, not after

  • A bare directory with no .mcp.json resolves all nineteen server namespaces.
  • GITHUB_PAT was defined nowhere on this host — so the github server in all 77 repos had been launching with an empty token since the kit shipped it. It is now derived from the gh CLI (gh auth token), which means it authenticates for the first time and rotates with gh auth instead of being a pasted secret.

Carrier

project-scaffold 1.11.0 removed templates/.mcp.json, so no new project inherits this. Full reasoning and phases: tron-modes/modes/flynn/plans/plan-mcp-centralization.md.

Kit 1.9.0 put four generic MCP servers into every scaffolded project and the P4
fleet pass carried them into 77 repos. That made every future MCP change cost 77
pull requests, and the same names already sat at user scope on different
definitions — precedence is local > project > user, so the duplicate never
errored, it just resolved by whichever directory you were in.

All nineteen servers are declared once at user scope now. Nothing in this repo
was unique to it, so the file goes rather than shrinks.

Verified before this landed, not after: a bare directory with no `.mcp.json`
resolves all nineteen namespaces. `GITHUB_PAT` — referenced by the github server
in all 77 repos and defined nowhere on this host — is now derived from the gh
CLI, so that server authenticates for the first time.

Carrier: project-scaffold 1.11.0 removed `templates/.mcp.json`, so no new project
inherits this. Plan: modes/flynn/plans/plan-mcp-centralization.md.
@vercel

vercel Bot commented Aug 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
hamlet Ready Ready Preview Aug 14, 2026 8:16pm

Request Review

@42piratas
42piratas merged commit f275fd1 into main Aug 14, 2026
3 checks passed
@42piratas
42piratas deleted the chore/upgrade-mcp-centralize branch August 14, 2026 20:31
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