Pre-flight Checks
Bug Description
La explicacion simple primero: si dejas una carta en un buzon que el cartero no pasa a buscar, la carta esta perfecta pero nunca llega. Eso hace hoy el install con scope workspace para Claude Code: deja la registracion MCP en un archivo dentro del workspace que Claude Code jamas va a mirar.
Lo tecnico: Claude Code lee MCP servers de user scope UNICAMENTE desde ~/.claude.json (el del home), y de project scope desde <proyecto>/.mcp.json. Un .claude.json (o .claude/mcp/*.json) dentro de un directorio de workspace arbitrario no es ninguna de las dos cosas.. es un camino muerto. El install reporta exito, la verificacion (si apunta al mismo archivo) da verde, y el usuario queda sin MCP sin ninguna señal de error.
Esto fue señalado por @dnlrsls en la review del PR #1909 (punto 1 de la ronda del 29/7). El PR de engram que sigue en esa cadena ya registra siempre en el home como interim, pero la decision de diseño merece su propio issue.
Steps to Reproduce
gentle-ai install con scope workspace en un proyecto, agente Claude Code, componente engram/context7- Mirar donde quedo la registracion MCP:
<workspace>/...
- Abrir Claude Code y listar MCP servers: el server no existe
Expected Behavior
La registracion MCP de Claude Code termina en un archivo que Claude Code realmente lee. Propuesta concreta a discutir: en scope workspace, registrar el MCP siempre en ~/.claude.json (user scope, home) y dejar el workspace solo para la entrega de prompts/skills.. o, si se quiere aislamiento real por proyecto, escribir <workspace>/.mcp.json, que es el mecanismo de project scope que Claude Code si soporta. La primera opcion es mas simple; la segunda es mas correcta semanticamente pero cambia el modelo de cleanup.
Actual Behavior
La registracion queda en un path que ningun proceso consume. Install verde, MCP inexistente para el usuario.
Operating System
Windows
Agent / Client
Claude Code
Shell
bash (Git Bash)
Pre-flight Checks
Bug Description
La explicacion simple primero: si dejas una carta en un buzon que el cartero no pasa a buscar, la carta esta perfecta pero nunca llega. Eso hace hoy el install con scope workspace para Claude Code: deja la registracion MCP en un archivo dentro del workspace que Claude Code jamas va a mirar.
Lo tecnico: Claude Code lee MCP servers de user scope UNICAMENTE desde
~/.claude.json(el del home), y de project scope desde<proyecto>/.mcp.json. Un.claude.json(o.claude/mcp/*.json) dentro de un directorio de workspace arbitrario no es ninguna de las dos cosas.. es un camino muerto. El install reporta exito, la verificacion (si apunta al mismo archivo) da verde, y el usuario queda sin MCP sin ninguna señal de error.Esto fue señalado por @dnlrsls en la review del PR #1909 (punto 1 de la ronda del 29/7). El PR de engram que sigue en esa cadena ya registra siempre en el home como interim, pero la decision de diseño merece su propio issue.
Steps to Reproduce
gentle-aiinstall con scope workspace en un proyecto, agente Claude Code, componente engram/context7<workspace>/...Expected Behavior
La registracion MCP de Claude Code termina en un archivo que Claude Code realmente lee. Propuesta concreta a discutir: en scope workspace, registrar el MCP siempre en
~/.claude.json(user scope, home) y dejar el workspace solo para la entrega de prompts/skills.. o, si se quiere aislamiento real por proyecto, escribir<workspace>/.mcp.json, que es el mecanismo de project scope que Claude Code si soporta. La primera opcion es mas simple; la segunda es mas correcta semanticamente pero cambia el modelo de cleanup.Actual Behavior
La registracion queda en un path que ningun proceso consume. Install verde, MCP inexistente para el usuario.
Operating System
Windows
Agent / Client
Claude Code
Shell
bash (Git Bash)