@capxul/mcp 4.20.0-beta.30 → 4.20.0-beta.32
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/README.md
CHANGED
|
@@ -77,20 +77,34 @@ Organization and member reads but does not author or activate invitations.
|
|
|
77
77
|
|
|
78
78
|
## Environment
|
|
79
79
|
|
|
80
|
-
| Name | Meaning
|
|
81
|
-
| ---------------------------- |
|
|
82
|
-
| `CAPXUL_MCP_PUBLIC_URL` | The URL clients type. Its `/mcp` path is the protected-resource `resource`. Defaults to `http://127.0.0.1:<port>`.
|
|
83
|
-
| `CAPXUL_MCP_AUTH_ISSUER` | The authorization server issuer. Defaults to `CAPXUL_MCP_AUTH_URL`.
|
|
84
|
-
| `CAPXUL_MCP_EXCHANGE_SECRET` | Resource-server secret for the backend token exchange.
|
|
85
|
-
| `CAPXUL_MCP_ACCESS_TOKEN` | Stdio only: the bearer for every request.
|
|
86
|
-
| `CAPXUL_MCP_HOST` | Bind interface. Defaults to `127.0.0.1`.
|
|
87
|
-
| `CAPXUL_MCP_PORT` | Default port when `--port` is absent.
|
|
88
|
-
| `
|
|
89
|
-
| `
|
|
80
|
+
| Name | Meaning |
|
|
81
|
+
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
|
|
82
|
+
| `CAPXUL_MCP_PUBLIC_URL` | The URL clients type. Its `/mcp` path is the protected-resource `resource`. Defaults to `http://127.0.0.1:<port>`. |
|
|
83
|
+
| `CAPXUL_MCP_AUTH_ISSUER` | The authorization server issuer. Defaults to `CAPXUL_MCP_AUTH_URL`. |
|
|
84
|
+
| `CAPXUL_MCP_EXCHANGE_SECRET` | Resource-server secret for the backend token exchange. |
|
|
85
|
+
| `CAPXUL_MCP_ACCESS_TOKEN` | Stdio only: the bearer for every request. |
|
|
86
|
+
| `CAPXUL_MCP_HOST` | Bind interface. Defaults to `127.0.0.1`. |
|
|
87
|
+
| `CAPXUL_MCP_PORT` | Default port when `--port` is absent. |
|
|
88
|
+
| `CAPXUL_DEVTOOLS_URL` | Optional local Effect DevTools endpoint, for example `ws://127.0.0.1:34439`. Each request SDK client owns its connection. |
|
|
89
|
+
| `POSTHOG_PROJECT_TOKEN` | Enables PostHog MCP Analytics. |
|
|
90
|
+
| `POSTHOG_HOST` | PostHog ingest host. Defaults to `https://us.i.posthog.com`. |
|
|
90
91
|
|
|
91
92
|
Every name is read lazily, so `system.ping` runs on a machine that holds no
|
|
92
93
|
secret and a missing slot surfaces as a structured error naming the variable.
|
|
93
94
|
|
|
95
|
+
For local debugging, start the repository collector with `vp run devtools:serve`
|
|
96
|
+
and set
|
|
97
|
+
`CAPXUL_DEVTOOLS_URL=ws://127.0.0.1:34439` when you start this MCP server.
|
|
98
|
+
Invoke a tool that uses the SDK and read its spans with `vp run devtools:snapshot`.
|
|
99
|
+
For the editor view, start its Effect DevTools server and run the collector with
|
|
100
|
+
`vp run devtools:serve --vscode`. Public ping has
|
|
101
|
+
no SDK client. Request cleanup closes the connection. Omit the variable to keep
|
|
102
|
+
DevTools disabled. The SDK accepts only local `ws` or `wss` URLs without
|
|
103
|
+
credentials, a query, or a fragment. Local inspection sends native debug detail;
|
|
104
|
+
MCP protocol output and remote analytics keep their existing behavior.
|
|
105
|
+
See the [development workflow](../../docs/canon/development-and-verification.md)
|
|
106
|
+
for agent access and the shared local collector.
|
|
107
|
+
|
|
94
108
|
## Verify in the repository
|
|
95
109
|
|
|
96
110
|
```bash
|