Merge pull request #93 from keycardai/larry/fix-example-workspace-members

fix: add examples as workspace members for standalone execution

Author: Larry-Osakwe

packages/mcp-fastmcp/examples/delegated_access/README.md

@@ -96,22 +96,17 @@ Use the public URL from your tunnel as `MCP_SERVER_URL`.
 ### 2. Set Environment Variables
 
 ```bash
-export KEYCARD_ZONE_ID="your-zone-id"
+export KEYCARD_ZONE_ID="your-zone-id"          # or use KEYCARD_ZONE_URL
 export KEYCARD_CLIENT_ID="your-client-id"
 export KEYCARD_CLIENT_SECRET="your-client-secret"
 export MCP_SERVER_URL="https://your-tunnel-url.ngrok.io/"  # Must be publicly reachable
 ```
 
-### 3. Install Dependencies
+### 3. Install Dependencies and Run the Server
 
 ```bash
 cd packages/mcp-fastmcp/examples/delegated_access
 uv sync
-```
-
-### 4. Run the Server
-
-```bash
 uv run python main.py
 ```
 
@@ -176,11 +171,14 @@ The example demonstrates comprehensive error handling patterns:
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `KEYCARD_ZONE_ID` | Yes | Your Keycard zone ID |
+| `KEYCARD_ZONE_ID` | Yes* | Your Keycard zone ID |
+| `KEYCARD_ZONE_URL` | Yes* | Your full Keycard zone URL (alternative to `KEYCARD_ZONE_ID`) |
 | `KEYCARD_CLIENT_ID` | Yes | Client ID from application credentials |
 | `KEYCARD_CLIENT_SECRET` | Yes | Client secret from application credentials |
 | `MCP_SERVER_URL` | Yes | Server URL (must be publicly reachable for delegated access) |
 
+\* Provide either `KEYCARD_ZONE_ID` or `KEYCARD_ZONE_URL`, not both.
+
 ## Learn More
 
 - [Keycard Documentation](https://docs.keycard.ai)

packages/mcp-fastmcp/examples/delegated_access/main.py

@@ -19,7 +19,7 @@
 from keycardai.mcp.integrations.fastmcp import AccessContext, AuthProvider, ClientSecret
 
 # Configure Keycard authentication with client credentials for delegated access
-# Get your zone_id and client credentials from console.keycard.ai
+# Set KEYCARD_ZONE_ID (or KEYCARD_ZONE_URL) and client credentials from console.keycard.ai
 auth_provider = AuthProvider(
     zone_id=os.getenv("KEYCARD_ZONE_ID", "your-zone-id"),
     mcp_server_name="GitHub API Server",

packages/mcp-fastmcp/examples/delegated_access/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "delegated-access-example"
+name = "delegated-access-fastmcp-example"
 version = "0.1.0"
 description = "GitHub API integration with Keycard delegated access using the @grant decorator"
 readme = "README.md"

packages/mcp-fastmcp/pyproject.toml

@@ -61,9 +61,6 @@ url = "https://test.pypi.org/simple/"
 publish-url = "https://test.pypi.org/legacy/"
 explicit = true
 
-[tool.uv.sources]
-keycardai-oauth = { workspace = true }
-keycardai-mcp = { workspace = true }
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/keycardai"]

packages/mcp/examples/delegated_access/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "delegated-access-example"
+name = "delegated-access-lowlevel-example"
 version = "0.1.0"
 description = "GitHub API integration with Keycard delegated access using the low-level MCP package"
 readme = "README.md"

packages/mcp/pyproject.toml

@@ -79,10 +79,6 @@ url = "https://test.pypi.org/simple/"
 publish-url = "https://test.pypi.org/legacy/"
 explicit = true
 
-[tool.uv.sources]
-keycardai-oauth = { workspace = true }
-keycardai-mcp-fastmcp = { workspace = true }
-
 [tool.hatch.build.targets.wheel]
 packages = ["src/keycardai"]
 

pyproject.toml

@@ -51,7 +51,8 @@ Issues = "https://github.com/keycardai/python-sdk/issues"
 [tool.uv.workspace]
 members = [
     ".",
-    "packages/*"
+    "packages/*",
+    "packages/*/examples/*"
 ]
 # Exclude any packages that shouldn't be part of the workspace
 exclude = []