@aotter/mantle 0.0.11-alpha.52 → 0.0.11-alpha.53

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aotter/mantle",
3
- "version": "0.0.11-alpha.52",
3
+ "version": "0.0.11-alpha.53",
4
4
  "description": "Umbrella entry for @aotter/mantle. Adopters install this one package and import from subpaths: /spec, /runtime, /cloudflare, /admin-ui. Sub-packages remain individually installable on npm for tooling / alt-adapter authors. The Netlify adapter ships as a private workspace stub in v0.1 — its subpath will be added when the impl lands in v0.2.",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://mantle.tools/",
@@ -47,10 +47,10 @@
47
47
  "README.md"
48
48
  ],
49
49
  "dependencies": {
50
- "@aotter/mantle-admin-ui": "0.0.11-alpha.52",
51
- "@aotter/mantle-spec": "0.0.11-alpha.52",
52
- "@aotter/mantle-cloudflare": "0.0.11-alpha.52",
53
- "@aotter/mantle-runtime": "0.0.11-alpha.52"
50
+ "@aotter/mantle-admin-ui": "0.0.11-alpha.53",
51
+ "@aotter/mantle-cloudflare": "0.0.11-alpha.53",
52
+ "@aotter/mantle-runtime": "0.0.11-alpha.53",
53
+ "@aotter/mantle-spec": "0.0.11-alpha.53"
54
54
  },
55
55
  "peerDependencies": {
56
56
  "@cloudflare/workers-oauth-provider": "^0.8.0",
@@ -61,7 +61,7 @@
61
61
  },
62
62
  "devDependencies": {
63
63
  "@cloudflare/workers-oauth-provider": "^0.8.0",
64
- "@types/node": "^25",
64
+ "@types/node": "^26",
65
65
  "aws4fetch": "^1.0.20",
66
66
  "better-auth": "^1.6.23",
67
67
  "hono": "^4.12.27",
@@ -88,6 +88,32 @@ pnpm check
88
88
 
89
89
  Use `pnpm dev` for local preview when the project provides it.
90
90
 
91
+ ## Connect a Local MCP Client
92
+
93
+ Start the project with `pnpm dev`, then use the exact local origin it prints.
94
+ Generated Cloudflare projects normally expose:
95
+
96
+ - `http://localhost:8787/mcp` for public tools;
97
+ - `http://localhost:8787/mcp/staff` for authenticated authoring tools.
98
+
99
+ Prefer the client's native remote HTTP + OAuth support. Use a standard
100
+ HTTP-to-stdio bridge such as `npx -y mcp-remote <url>` only when the client
101
+ accepts stdio MCP servers but cannot connect to remote HTTP directly. Mantle
102
+ does not own a separate local proxy or an auth-bypass mode.
103
+
104
+ Before changing client config, confirm the Worker is reachable:
105
+
106
+ ```bash
107
+ curl -i http://localhost:8787/mcp
108
+ ```
109
+
110
+ An OAuth-protected endpoint should respond with `401` and a
111
+ `WWW-Authenticate` resource-metadata challenge before sign-in. After
112
+ connecting, inspect `tools/list`; make one read-only `query_view_*` call when
113
+ available before invoking any mutation. Use project-scoped client config when
114
+ the client offers it, and never commit OAuth tokens or the bridge's token
115
+ cache.
116
+
91
117
  ## Rules
92
118
 
93
119
  - Prefer manifest YAML for content model changes.