Update Claude Desktop installation instructions (#169)

Author: rgambee

.github/workflows/publish.yaml

@@ -36,8 +36,6 @@ jobs:
     permissions:
       contents: write
     # MCPB bundles enable one-click installation in Claude Desktop.
-    # Note: Local MCP servers currently only work in Chat mode, not Cowork mode.
-    # See: https://github.com/anthropics/claude-code/issues/20377
     steps:
       - uses: actions/checkout@v4
         with:

docs-site/scripts/check-links.py

@@ -47,6 +47,8 @@
 # Each URL must be listed explicitly — new links to the same domain will
 # error until added here, so broken links don't slip through unnoticed.
 SKIPPED_URLS: set[str] = {
+    "https://clinicaltrials.gov/",
+    "https://clinicaltrials.gov/data-api/about-api",
     "https://code.claude.com/docs/en/discover-plugins",
     "https://code.claude.com/docs/en/mcp",
     "https://cursor.com/deeplink/mcp-install-dark.svg",
@@ -65,10 +67,9 @@
     "https://huggingface.co/datasets/fancyzhx/dbpedia_14",
     "https://hugovk.github.io/top-pypi-packages/",
     "https://jqlang.org/",
+    "https://pip.pypa.io/en/stable/",
     "https://www.kaggle.com/code/rafaelpoyiadzi/active-learning-with-an-llm-oracle",
     "https://www.kaggle.com/datasets/tunguz/pubmed-title-abstracts-2019-baseline",
-    "https://clinicaltrials.gov/",
-    "https://clinicaltrials.gov/data-api/about-api",
 }
 
 

docs/installation.mdx

@@ -7,10 +7,6 @@ description: Get started with everyrow. Install the Python SDK via pip, add the
 
 Get an API key at [everyrow.io/api-key](https://everyrow.io/api-key) ($20 free credit included).
 
-```bash
-export EVERYROW_API_KEY=your_key_here
-```
-
 Select your platform and integration method below.
 
 <InstallationTabs>
@@ -23,6 +19,13 @@ pip install everyrow
 
 Requires Python 3.12+.
 
+**Important:** be sure to supply your API key when running scripts:
+
+```bash
+export EVERYROW_API_KEY=sk-cho...
+python3 example_script.py
+```
+
 **Quick example:**
 
 ```python
@@ -152,31 +155,11 @@ You can optionally configure Claude Code to show a [progress bar](/docs/progress
 
 <TabContent agent="claude-desktop" type="mcp">
 
-Download the latest `.mcpb` bundle from [GitHub Releases](https://github.com/futuresearch/everyrow-sdk/releases) and double-click to install. You'll be prompted for your API key during setup.
-
-> **Note:** Works in Claude Desktop's **Chat** mode only (not Cowork mode due to a [known limitation](https://github.com/anthropics/claude-code/issues/20377)).
+First, make sure you have [uv installed](https://docs.astral.sh/uv/).
 
-**Manual installation:**
-
-Add to your MCP config (requires [uv](https://docs.astral.sh/uv/)):
-
-```json
-{
-  "mcpServers": {
-    "everyrow": {
-      "command": "uvx",
-      "args": ["everyrow-mcp"],
-      "env": {
-        "EVERYROW_API_KEY": "sk-cho..."
-      }
-    }
-  }
-}
-```
+Then, download the latest `.mcpb` bundle from [GitHub Releases](https://github.com/futuresearch/everyrow-sdk/releases) and double-click to install. You'll be prompted for your API key during setup.
 
-Config file location:
-- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+After installing the bundle, you can use everyrow from Chat, Cowork and Code within Claude Desktop.
 
 </TabContent>
 
@@ -365,6 +348,6 @@ Config file location:
 
 ## Dependencies
 
-The MCP server requires **uv** (if using `uvx`) or **pip** (if installed directly). The Python SDK requires **Python 3.12+**.
+The MCP server requires [**uv**](https://docs.astral.sh/uv/) (if using `uvx`) or [**pip**](https://pip.pypa.io/en/stable/) (if installed directly). The Python SDK requires **Python 3.12+**.
 
 For the optional terminal progress bar, see the [jq dependency](/docs/progress-monitoring#status-line-progress-bar) in the progress monitoring guide.

docs/skills-vs-mcp.mdx

@@ -73,7 +73,7 @@ MCP provides direct tool calls without code generation. Your agent calls everyro
 | Preview mode | Yes (`preview=True`) | Not available |
 | Custom response models | Full Pydantic BaseModel | JSON schema only |
 | Effort/LLM control | `effort_level`, `llm`, `iteration_budget` | Not available |
-| Works in Claude Desktop | Cowork mode only | Yes (Chat mode only for now) |
+| Works in Claude Desktop | Cowork mode only | Yes (all modes) |
 | Debugging | Requires some Python knowledge | Not needed |
 
 ### Which Should I Start With?

everyrow-mcp/README.md

@@ -12,9 +12,7 @@ The server requires an everyrow API key. Get one at [everyrow.io/api-key](https:
 
 ### Claude Desktop
 
-Download the latest `.mcpb` bundle from the [GitHub Releases](https://github.com/futuresearch/everyrow-sdk/releases) page and double-click to install in Claude Desktop. You'll be prompted to enter your everyrow API key during setup.
-
-> **Note:** The MCPB bundle works in Claude Desktop's **Chat** mode. Due to a [known limitation](https://github.com/anthropics/claude-code/issues/20377), local MCP servers are not currently exposed in Cowork mode.
+Download the latest `.mcpb` bundle from the [GitHub Releases](https://github.com/futuresearch/everyrow-sdk/releases) page and double-click to install in Claude Desktop. You'll be prompted to enter your everyrow API key during setup. After installing the bundle, you can use everyrow from Chat, Cowork and Code within Claude Desktop.
 
 ### Cursor
 Set the environment variable in your terminal shell before opening cursor. You may need to re-open cursor from your shell after this. Alternatively, hardcode the api key within cursor settings instead of the hard-coded `${env:EVERYROW_API_KEY}`