fenix-claude-plugin 0.1.1 → 0.1.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "fenix",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Fenix patent automation for Claude — MCP connector plus patent drafting, office-action, and project skills. Provide one API key; the server infers your firm (client + database).",
   "author": {
     "name": "Fenix AI",

package/.mcp.json

@@ -4,7 +4,7 @@
       "type": "http",
       "url": "https://claude.fenix.ai/api/plugin",
       "headers": {
-        "Authorization": "Bearer ${FENIX_API_KEY}"
+        "Authorization": "Bearer ${FENIX_API_KEY:-NOT_SET}"
       }
     }
   }

package/commands/fenix-install.md

@@ -12,4 +12,6 @@ For each skill — `fenix-application`, `fenix-office-action`, `fenix-project`:
 
 The connector is configured by this plugin and **infers your firm (client + database) from your single API key**, so never pass a `clientDb` or client argument to any tool — let it default.
 
-If `install_fenix_skills` returns 401/unauthorized, the API key isn't set — run `/fenix-setup` first.
+If the `install_fenix_skills` tool is **not available** (you can't find it, or the `fenix` server shows "still connecting" in `/mcp`), the plugin's MCP server hasn't started in this session. Run **`/reload-plugins`** (or fully restart Claude Code), then retry — do not give up after one lookup.
+
+If `install_fenix_skills` returns **401/unauthorized**, the API key isn't set or is wrong — run `/fenix-setup`, then `/reload-plugins`.

package/commands/fenix-setup.md

@@ -7,8 +7,13 @@ Help the user connect the Fenix plugin. **Only one value is needed: a single API
 1. Confirm the user has a **Fenix API key** (issued by Fenix for their firm). The server maps this key to their account and **infers the client and database from it** — they never provide a client name, database, or any second value.
 2. The connector reads the key from the **`FENIX_API_KEY`** environment variable and sends it as a bearer token to `https://claude.fenix.ai/api/plugin`.
 3. Guide them to set `FENIX_API_KEY` (do not type the key into chat; have them set it themselves):
-   - **macOS / Linux:** add `export FENIX_API_KEY="<their key>"` to `~/.zshrc` or `~/.bashrc`, then restart the terminal and Claude Code.
-   - **Windows (PowerShell):** run `setx FENIX_API_KEY "<their key>"`, then restart the terminal and Claude Code.
-4. Verify the connection by calling a read-only tool such as `get_project` (or run `/fenix-install`). A 401/unauthorized means the key is missing or wrong, or Claude Code wasn't restarted after setting it.
+   - **macOS / Linux:** add `export FENIX_API_KEY="<their key>"` to `~/.zshrc` or `~/.bashrc`.
+   - **Windows (PowerShell):** run `setx FENIX_API_KEY "<their key>"`.
+4. **Reload so the connector picks up the key — this step is required.** The Fenix MCP server only connects at session startup, so after setting the key the user must **run `/reload-plugins`** (or fully quit and reopen Claude Code, and reopen the terminal so the new env var is in scope). Without this, the `fenix` server stays unconnected even with a valid key.
+5. Verify with `/mcp` — the `fenix` server should show **connected** with tools. Then call a read-only tool such as `get_project` (or run `/fenix-install`).
+
+## Troubleshooting
+- **`fenix` server shows "still connecting" / no Fenix tools (install_fenix_skills, get_project) appear:** the server hasn't started in this session. Run **`/reload-plugins`**, or fully restart Claude Code. ("Still connecting" is NOT an auth error — a bad key shows as "Failed to connect.")
+- **"Failed to connect" / 401:** the key is missing or wrong. Confirm `FENIX_API_KEY` is set **in the environment Claude Code was launched from** (set it, reopen the terminal, then `/reload-plugins`).
 
 Never print, log, or store the key anywhere other than the environment variable.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fenix-claude-plugin",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Fenix patent automation plugin for Claude Code — MCP connector plus patent drafting, office-action, and project skills.",
   "license": "UNLICENSED",
   "homepage": "https://claude.fenix.ai",