convex-mcp-visual 1.4.7 → 1.5.0

package/README.md

@@ -7,6 +7,7 @@ Schema visualizer and dashboard tools for exploring Convex databases. Opens inte
 **Features:**
 
 - Schema browser with graph view, list view, and document browser
+- Component browser for viewing installed Convex components
 - Real-time dashboard with metrics and charts
 - Mermaid ER diagrams with relationship detection
 - Codebase subway map for files and imports
@@ -45,6 +46,7 @@ convex-mcp-visual --setup
 
 # Use it
 convex-mcp-visual schema      # Browse schema
+convex-mcp-visual components  # Browse installed components
 convex-mcp-visual dashboard   # View metrics
 convex-mcp-visual diagram     # Generate ER diagram
 convex-mcp-visual subway      # Codebase subway map
@@ -97,13 +99,12 @@ cd my-convex-app/
 npx convex-mcp-visual --setup
 ```
 
-The setup wizard detects your project from `.env.local` and shows which deployment to look for in the dashboard. Just copy and paste the key.
+The setup wizard detects your project from `.env.local` and saves the deploy key per-project. Just copy and paste the key from the Convex dashboard.
 
-Or set the environment variable manually:
-
-```bash
-export CONVEX_DEPLOY_KEY="prod:your-deployment|your-key"
-```
+> **Do not add `export CONVEX_DEPLOY_KEY=...` to your shell profile** (`~/.zshrc`,
+> `~/.bashrc`, etc.). A global export overrides all per-project `.env.local` files and
+> connects every project to the same deployment. If you already did this, see
+> [Troubleshooting](#troubleshooting) for removal steps.
 
 Get your deploy key from [dashboard.convex.dev](https://dashboard.convex.dev) under Settings > Deploy Keys.
 
@@ -144,6 +145,9 @@ npx convex-mcp-visual --test
 | "What tables do I have?"              | `schema_browser` (graph view)     |
 | "Browse my database"                  | `schema_browser` (graph view)     |
 | "Show schema for users table"         | `schema_browser` with table param |
+| "Show installed components"           | `component_browser`               |
+| "What components are installed?"      | `component_browser`               |
+| "Show agent component"                | `component_browser` with filter   |
 | "Create a dashboard for my data"      | `dashboard_view`                  |
 | "Show me metrics for my app"          | `dashboard_view`                  |
 | "Generate a diagram of my schema"     | `schema_diagram` (Mermaid ER)     |
@@ -165,6 +169,14 @@ All tools open an interactive browser UI and return output to the terminal. The
 - ASCII/Unicode output for terminal
 - SVG diagram in browser with theme options
 - Exportable Mermaid code
+- Component grouping support
+
+**Component Browser Features:**
+
+- Lists all installed Convex components
+- Detects known component types (agent, auth, ratelimiter, etc.)
+- Shows component table schemas and document counts
+- Components tab integrated in Schema Browser UI
 
 ## Documentation
 
@@ -364,6 +376,73 @@ codex mcp remove convex-visual
 npm uninstall -g convex-mcp-visual
 ```
 
+## Troubleshooting
+
+### Wrong deployment or stuck deploy key
+
+If the tool keeps connecting to the wrong Convex deployment, a global config is overriding your local project settings.
+
+**1. Check what config is active:**
+
+```bash
+npx convex-mcp-visual --config
+```
+
+**2. Clear the global environment variable:**
+
+```bash
+unset CONVEX_DEPLOY_KEY
+echo $CONVEX_DEPLOY_KEY
+```
+
+If the variable reappears in new terminals, it was added to a shell profile. Open the file in your editor and delete the `export CONVEX_DEPLOY_KEY=...` line:
+
+| OS | File to check |
+| --- | --- |
+| macOS (zsh) | `~/.zshrc` or `~/.zprofile` |
+| macOS (bash) | `~/.bash_profile` or `~/.bashrc` |
+| Linux (bash) | `~/.bashrc` or `~/.profile` |
+| Linux (zsh) | `~/.zshrc` |
+| Windows (PowerShell) | Run `[Environment]::SetEnvironmentVariable("CONVEX_DEPLOY_KEY", $null, "User")` |
+| Windows (System) | Settings > System > Advanced > Environment Variables |
+
+After removing the line, open a new terminal to confirm it is gone.
+
+**3. Remove the legacy global config file:**
+
+```bash
+rm ~/.convex-mcp-visual.json
+```
+
+This file was created by older versions of `--setup`. Removing it lets per-project `.env.local` files take priority.
+
+**4. Use per-project config:**
+
+In each Convex project folder, run `--setup` or create a `.env.local` file:
+
+```
+CONVEX_DEPLOY_KEY="prod:your-deployment-name|your-admin-key"
+```
+
+**5. Verify:**
+
+```bash
+npx convex-mcp-visual --test
+```
+
+### Config priority
+
+The first source found wins:
+
+1. `CONVEX_DEPLOY_KEY` environment variable (highest priority)
+2. `CONVEX_URL` environment variable
+3. `.env.local` in the current directory
+4. `.convex/deployment.json` in the current directory
+5. `~/.convex/config.json` (Convex CLI login session)
+6. `~/.convex-mcp-visual.json` (legacy global fallback)
+
+For more issues, see [Troubleshooting docs](docs/troubleshooting.md).
+
 ## Contributing
 
 See [Development](docs/architecture.md) for build instructions.

package/dist/apps/apps/kanban-board/index.html

@@ -7,7 +7,7 @@
     <title>Kanban Board - Convex MCP Apps</title>
     <script type="module" crossorigin src="../../assets/kanban-board-B3LBzk3P.js"></script>
     <link rel="modulepreload" crossorigin href="../../assets/modulepreload-polyfill-B5Qt9EMX.js">
-    <link rel="stylesheet" crossorigin href="../../assets/style-C_-VyIe_.css">
+    <link rel="stylesheet" crossorigin href="../../assets/style-C5Anu08Y.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/apps/apps/realtime-dashboard/index.html

@@ -7,7 +7,7 @@
     <title>Realtime Dashboard - Convex MCP Apps</title>
     <script type="module" crossorigin src="../../assets/realtime-dashboard-D9nem8DB.js"></script>
     <link rel="modulepreload" crossorigin href="../../assets/modulepreload-polyfill-B5Qt9EMX.js">
-    <link rel="stylesheet" crossorigin href="../../assets/style-C_-VyIe_.css">
+    <link rel="stylesheet" crossorigin href="../../assets/style-C5Anu08Y.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/apps/apps/schema-browser/index.html

@@ -5,9 +5,9 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="theme-color" content="#faf8f5" />
     <title>Schema Browser - Convex MCP Apps</title>
-    <script type="module" crossorigin src="../../assets/schema-browser-S5aw9ecT.js"></script>
+    <script type="module" crossorigin src="../../assets/schema-browser-D1dGKaRh.js"></script>
     <link rel="modulepreload" crossorigin href="../../assets/modulepreload-polyfill-B5Qt9EMX.js">
-    <link rel="stylesheet" crossorigin href="../../assets/style-C_-VyIe_.css">
+    <link rel="stylesheet" crossorigin href="../../assets/style-C5Anu08Y.css">
   </head>
   <body>
     <div id="app"></div>