@enfyra/mcp-server 0.0.83 → 0.0.85

package/README.md

@@ -12,9 +12,9 @@ From your project root:
 npx @enfyra/mcp-server config
 ```
 
-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.
+The config command writes project config for Codex, 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`.
+Interactive setup asks for your Enfyra app/admin URL, then guides you to the token page when needed and asks for `ENFYRA_API_TOKEN`.
 
 ```bash
 # Non-interactive, all supported clients
@@ -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 user config:
+Generated project 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]` in the user-level Codex config. Other Codex config and other MCP servers are preserved.
+The writer replaces only `[mcp_servers.enfyra]` and `[mcp_servers.enfyra.env]`. Other Codex config and other MCP servers are preserved.
 
-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.
+Open this folder in a new Codex session and approve the project MCP config if prompted. The setup command only writes `.codex/config.toml`; it does not ship or create `.codex/skills`.
 
 Official reference: [Codex config](https://developers.openai.com/codex/config-reference).
 
@@ -142,7 +142,7 @@ npx @enfyra/mcp-server config [options]
 
 | Option | Use |
 |--------|-----|
-| `--app-url` | Set the Enfyra app/admin URL; setup writes `<app>/api` to MCP config |
+| `--app-url` | Set the Enfyra app/admin URL |
 | `--api-token`, `-t` | Set `ENFYRA_API_TOKEN` |
 | `--yes` | Non-interactive mode for CI/scripts |
 | `--global` | Write global/user config instead of project config |
@@ -158,8 +158,8 @@ Without a target flag, interactive mode asks which client to configure. Non-inte
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `ENFYRA_APP_URL` | App/admin URL used by setup to derive `ENFYRA_API_URL=<app>/api` and token page `<app>/me` | `http://localhost:3000` |
-| `ENFYRA_API_URL` | Runtime API base written into MCP client config | Derived from `ENFYRA_APP_URL` |
+| `ENFYRA_APP_URL` | App/admin URL used by setup | `http://localhost:3000` |
+| `ENFYRA_API_URL` | Runtime API base written into MCP client config | Generated by setup |
 | `ENFYRA_API_TOKEN` | Programmatic token from the Enfyra admin UI `/me` | Required |
 
 For normal apps and demos, enter the app/admin URL such as `http://localhost:3000` or `https://demo.enfyra.io`. Treat the direct Enfyra backend host as private infrastructure unless you are debugging Enfyra core/server internals.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/mcp-server",
-  "version": "0.0.83",
+  "version": "0.0.85",
   "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 Claude Code/Cursor global config instead of project config; Codex is always user-level
+  --global                Write global/user config for selected clients instead of project config
   --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,14 +78,13 @@ ${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 user scope)
+  --codex, --codex-only                    Only ./.codex/config.toml (Codex project scope)
   Passing multiple target flags writes each selected target.
 
   -h, --help              Show this help
 
 ${style.bold('Interactive mode')}
   Choose Codex, Claude Code, Cursor, or all clients; then enter ENFYRA_APP_URL and ENFYRA_API_TOKEN.
-  The API base is inferred by appending /api to the app URL.
   Existing Enfyra config and environment variables are used as defaults. Re-run anytime to update.
 
 ${style.bold('Examples')}
@@ -287,7 +286,7 @@ async function readCodexEnfyraEnv(absPath) {
 }
 
 function getCodexConfigPath(root, globalScope) {
-  return join(homedir(), '.codex', 'config.toml');
+  return globalScope ? join(homedir(), '.codex', 'config.toml') : join(root, '.codex', 'config.toml');
 }
 
 function getClaudeConfigPath(root, globalScope) {
@@ -361,7 +360,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'
@@ -485,7 +484,7 @@ async function promptConfig(opts, existing) {
   const defaultAppUrl = resolveDefaultAppUrl(opts, existing);
   if (!appUrl) {
     console.log(`${style.cyan('◆')} ${style.bold('Connect to Enfyra')}`);
-    console.log(`${style.dim('│')} Enter the Enfyra app URL. The API base will be inferred as ${style.bold('<app>/api')}.`);
+    console.log(`${style.dim('│')} Enter the Enfyra app URL.`);
     const line = (await q(`${style.dim('└')} ENFYRA_APP_URL ${style.dim(`[${defaultAppUrl}]`)}: `)).trim();
     appUrl = normalizeAppUrl(line || defaultAppUrl);
   }
@@ -497,8 +496,7 @@ async function promptConfig(opts, existing) {
     const meUrl = deriveMeUrl(appUrl);
     console.log('');
     console.log(`${style.cyan('◆')} ${style.bold('API token')}`);
-    console.log(`${style.dim('│')} If you do not have a token yet, open: ${style.cyan(meUrl)}`);
-    console.log(`${style.dim('│')} In the Enfyra admin UI, open ${style.bold('/me')} and create/copy a programmatic API token.`);
+    console.log(`${style.dim('│')} If you do not have a token yet, create one here: ${style.cyan(meUrl)}`);
     const line = (await q(`${style.dim('└')} ENFYRA_API_TOKEN${hint}: `)).trim();
     apiToken = line !== '' ? line : defaultApiToken;
   }
@@ -595,14 +593,7 @@ export async function runLocalConfig(argv) {
     written.push({ client: 'cursor', path: p });
   }
 
-  const hasProjectConfig = writeClaude || writeCursor;
-  const scopeLabel = opts.global
-    ? 'global/user'
-    : writeCodex && hasProjectConfig
-      ? 'project + Codex user'
-      : writeCodex
-        ? 'Codex user'
-        : 'project';
+  const scopeLabel = opts.global ? 'global/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];
@@ -613,7 +604,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: restart Codex or start a new Codex session so user MCP config is loaded.');
+    console.log('  - Codex: open this folder in a new Codex session and approve the project MCP config if prompted.');
   }
   if (selectedClients.has('claude')) {
     console.log('  - Claude Code: open this folder; approve project MCP if prompted.');