Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

`~/.mcp.json` is not a user-scope MCP location, so the documented setup silently fails

Aperta Adatta ai principianti
  • Qualcosa non va?
#55 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
74/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
shell
Ambito
cli, documentation

Direzione di ricerca

Inizia da README.md:380-385, quindi esamina /trailofbits:config, mcp-template.json e settings.json per tracciare come viene rappresentata la configurazione MCP documentata. Aggiorna la documentazione e i riferimenti alla configurazione in modo che utilizzino comandi CLI con ambito utente e decidi se mcp-template.json debba essere rimosso o rietichettato come esempio con ambito di progetto. Verifica che le istruzioni risultanti non presentino ~/.mcp.json come una posizione globale.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

README.md:380-385 describes ~/.mcp.json as "global servers available in every session." There is no such location.

MCP user scope lives in ~/.claude.json. A file at ~/.mcp.json is only picked up incidentally, as a project-scope .mcp.json discovered by walking up the directory tree from the working directory — which happens to work for repos under $HOME and nowhere else.

Two consequences:

  • Because it resolves as project scope, it's gated by the project-server approval flow — and this repo's settings.json sets enableAllProjectMcpServers: false. The README's two recommendations work against each other.
  • For anyone who keeps repos outside $HOME, the servers silently don't load at all.
Verified

macOS, CLI 2.1.238, with ~/.mcp.json present and populated from mcp-template.json:

$ cd ~/Developer/claude-code-config && claude mcp get exa
exa:
  Scope: Project config (shared via .mcp.json)
  Status: ⏸ Pending approval (run `claude` to approve)
  Type: http

$ cd /private/tmp/scratch && claude mcp get exa
No MCP server named "exa".

The Scope: Project config line and the pending-approval status are both the symptom: it was never registered as a user-scope server.

Suggested fix

Drop ~/.mcp.json from the README and from /trailofbits:config, and use the CLI, which writes real user scope:

claude mcp add --transport http exa --scope user 'https://mcp.exa.ai/mcp' --header "x-api-key: $EXA_API_KEY"
claude mcp add context7 --scope user -- npx -y @upstash/context7-mcp

That leaves mcp-template.json without a purpose — either remove it, or relabel it as an example project-scoped .mcp.json rather than something to copy into $HOME.

Found while reviewing the repo against Anthropic's current docs and the installed CLI (2.1.238). One of five separate findings from the same pass.

Lingua principale
Shell
Stelle
2.1k
Fork
164
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di trailofbits/claude-code-config

Tutte le issue di trailofbits/claude-code-config

Issue simili

Altre issue su Shell/Bash

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.