@enfyra/mcp-server 0.0.82 → 0.0.83

package/README.md

@@ -12,7 +12,7 @@ From your project root:
 npx @enfyra/mcp-server config
 ```
 
-The config command can write project config for Codex, Claude Code, Cursor, or all supported clients. It preserves other MCP servers and replaces only the `enfyra` entry.
+The config command can write user-level Codex config plus project config for Claude Code and Cursor. It preserves other MCP servers and replaces only the `enfyra` entry.
 
 Interactive setup asks for `ENFYRA_APP_URL` first, then asks for `ENFYRA_API_TOKEN`. The MCP API base is inferred as `<app>/api`, and the token page is inferred as `<app>/me`. For example, `https://demo.enfyra.io` becomes API base `https://demo.enfyra.io/api` and token page `https://demo.enfyra.io/me`.
 
@@ -37,7 +37,7 @@ yarn mcp:config
 
 | Client | Command | Project config |
 |--------|---------|----------------|
-| Codex | `npx @enfyra/mcp-server config --codex` | `.codex/config.toml` |
+| Codex | `npx @enfyra/mcp-server config --codex` | `~/.codex/config.toml` |
 | Claude Code | `npx @enfyra/mcp-server config --claude-code` | `.mcp.json` |
 | Cursor | `npx @enfyra/mcp-server config --cursor` | `.cursor/mcp.json` |
 | MCP Inspector / other hosts | Paste the shared STDIO config below | Host-specific `mcpServers` config |
@@ -49,7 +49,7 @@ yarn mcp:config
 npx @enfyra/mcp-server config --codex
 ```
 
-Generated project config:
+Generated user config:
 
 ```toml
 [mcp_servers.enfyra]
@@ -61,9 +61,9 @@ ENFYRA_API_URL = "http://localhost:3000/api"
 ENFYRA_API_TOKEN = "efy_pat_your-token"
 ```
 
-The writer replaces only `[mcp_servers.enfyra]` and `[mcp_servers.enfyra.env]`. Other Codex config and other MCP servers are preserved.
+The writer replaces only `[mcp_servers.enfyra]` and `[mcp_servers.enfyra.env]` in the user-level Codex config. Other Codex config and other MCP servers are preserved.
 
-After editing config, open the folder in a new Codex session so project config is loaded.
+Restart Codex or start a new Codex session so user MCP config is loaded. The setup command does not create project `.codex/config.toml`, because project-scoped executable MCP config can trigger Codex workspace safety checks.
 
 Official reference: [Codex config](https://developers.openai.com/codex/config-reference).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/mcp-server",
-  "version": "0.0.82",
+  "version": "0.0.83",
   "description": "MCP server for Enfyra - manage Enfyra instances from MCP-compatible coding tools",
   "type": "module",
   "license": "MIT",

package/src/lib/config-local.mjs

@@ -23,7 +23,7 @@ const style = {
 const clients = {
   codex: {
     label: 'Codex',
-    path: './.codex/config.toml',
+    path: '~/.codex/config.toml',
     color: style.green,
   },
   claude: {
@@ -61,7 +61,7 @@ ${style.bold('Usage')}
   npx @enfyra/mcp-server config [options]
 
 ${style.bold('Supported clients')}
-  Codex        ./.codex/config.toml
+  Codex        ~/.codex/config.toml
   Claude Code  ./.mcp.json
   Cursor       ./.cursor/mcp.json
   Other MCP hosts can use the shared stdio JSON from the README.
@@ -69,7 +69,7 @@ ${style.bold('Supported clients')}
 ${style.bold('Options')}
   --app-url <url>          Enfyra app/admin URL, for example https://demo.enfyra.io
   --api-token, -t <secret>  ENFYRA_API_TOKEN
-  --global                Write global/user config for selected hosts instead of project config
+  --global                Write Claude Code/Cursor global config instead of project config; Codex is always user-level
   --reconfig              Always choose target again in interactive mode and replace the old enfyra config for that target
   --yes                   Non-interactive: no prompts (CI / scripts); use CLI, env, existing file, then defaults
 
@@ -78,7 +78,7 @@ ${style.bold('Client selection')}
 
   --claude-code, --claude, --claude-only   Only ./.mcp.json (Claude Code project scope)
   --cursor, --cursor-only                  Only ./.cursor/mcp.json (Cursor)
-  --codex, --codex-only                    Only ./.codex/config.toml (Codex project scope)
+  --codex, --codex-only                    Only ~/.codex/config.toml (Codex user scope)
   Passing multiple target flags writes each selected target.
 
   -h, --help              Show this help
@@ -287,7 +287,7 @@ async function readCodexEnfyraEnv(absPath) {
 }
 
 function getCodexConfigPath(root, globalScope) {
-  return globalScope ? join(homedir(), '.codex', 'config.toml') : join(root, '.codex', 'config.toml');
+  return join(homedir(), '.codex', 'config.toml');
 }
 
 function getClaudeConfigPath(root, globalScope) {
@@ -361,7 +361,7 @@ async function promptTargetChoice() {
   const rl = createInterface({ input, output });
   const line = (await rl.question(
     'Where should Enfyra MCP config be written?\n'
-      + '  [1] Codex        ./.codex/config.toml\n'
+      + '  [1] Codex        ~/.codex/config.toml\n'
       + '  [2] Claude Code  ./.mcp.json\n'
       + '  [3] Cursor       ./.cursor/mcp.json\n'
       + '  [4] All [default]\n'
@@ -595,7 +595,14 @@ export async function runLocalConfig(argv) {
     written.push({ client: 'cursor', path: p });
   }
 
-  const scopeLabel = opts.global ? 'global/user' : 'project';
+  const hasProjectConfig = writeClaude || writeCursor;
+  const scopeLabel = opts.global
+    ? 'global/user'
+    : writeCodex && hasProjectConfig
+      ? 'project + Codex user'
+      : writeCodex
+        ? 'Codex user'
+        : 'project';
   console.log(`${statusIcon('success')} ${style.bold(style.green('Enfyra MCP config updated'))} ${style.dim(`(${scopeLabel})`)}\n`);
   for (const entry of written) {
     const meta = clients[entry.client];
@@ -606,7 +613,7 @@ export async function runLocalConfig(argv) {
   const selectedClients = new Set(written.map(entry => entry.client));
   console.log(`\n${style.bold(style.blue('Next steps'))}`);
   if (selectedClients.has('codex')) {
-    console.log('  - Codex: open this folder in a new Codex session so config is loaded.');
+    console.log('  - Codex: restart Codex or start a new Codex session so user MCP config is loaded.');
   }
   if (selectedClients.has('claude')) {
     console.log('  - Claude Code: open this folder; approve project MCP if prompted.');