Skip to content

Commit ef7770a

Browse files
committed
docs(skills): the automation skill's OAuth recipe names a stdio MCP server's credential route as transport.credentialEnv
Recipe 6 of objectstack-automation/references/integration-recipes.md said a stdio server's credentials ride transport.env, the literal-in-metadata route the connector-credential-literal advisory warns against. It now says what the mcp provider does on main: the grant-bearing kinds stay http only; a stdio server takes a static auth with a credentialRef, handed to the child process in the variable transport.credentialEnv names, never a literal in transport.env. Paid inside the file's token ceiling by dropping the opening paragraph's restatement of the packaged spec and of where an api hook's secret goes (SKILL.md and recipe 4 keep both). Co-authored-by: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012MmDsR4AZoJZyzKQcBEESh
1 parent fdd0641 commit ef7770a

2 files changed

Lines changed: 16 additions & 6 deletions

File tree

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
'@objectstack/skills': patch
3+
---
4+
5+
docs(skills): the automation skill's OAuth recipe names a stdio MCP server's credential route as `transport.credentialEnv`
6+
7+
Clause-②: no
8+
Metadata-protocol: none
9+
10+
Recipe 6 of `objectstack-automation/references/integration-recipes.md` said a `stdio` server's credentials ride `transport.env` — the literal-in-metadata route the `connector-credential-literal` advisory warns against. It now says what the `mcp` provider does: the grant-bearing kinds stay `http` only; a `stdio` server takes a static `auth: { type: 'bearer', credentialRef }`, handed to the child process in the variable `transport.credentialEnv` names, never a literal in `transport.env`. Paid inside the file's token ceiling by dropping the opening paragraph's restatement of two facts that keep their homes: the packaged spec (SKILL.md § Integrations are declared, not coded) and where an `api` hook's secret goes (SKILL.md's `secretRef` row and recipe 4). No eval asserted the old route; none changes.

‎skills/objectstack-automation/references/integration-recipes.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,8 @@ the fields the answer lands in, a flow dispatching `connector_action`) and the
66
one thing the **customer's administrator** supplies: the value behind
77
`auth.credentialRef` — an environment variable of that name (wins), or a
88
value set in the running app at `PUT /api/v1/automation/connectors/credential-refs/:ref`;
9-
an unset ref leaves its instance degraded until set. A spec is not a
10-
secret and ships in the package; an `api` flow's hook secret goes to the
11-
deployment and to the sender. Keep `automation` in `requires` whenever a
12-
connector is declared. Full guide: https://objectstack.ai/docs/automation/connectors.
9+
an unset ref leaves its instance degraded until set. Keep `automation` in
10+
`requires` whenever a connector is declared. Full guide: https://objectstack.ai/docs/automation/connectors.
1311

1412
## Holds on every recipe
1513

@@ -155,8 +153,10 @@ export const LegacyErp = defineConnector({
155153
## 6 · OAuth or vendor-app token — the server runs the grant
156154

157155
Recipe 1's shape with a grant-bearing `auth`, served on `rest`, `openapi` and
158-
`mcp` (`http` only; a `stdio` server's credentials ride `transport.env`): the
159-
token is fetched per dispatch; no metadata key holds it.
156+
`mcp` (`http` only; a `stdio` server takes a static `auth: { type: 'bearer',
157+
credentialRef }` in the variable `transport.credentialEnv` names, never a
158+
literal in `transport.env`): the token is fetched per dispatch; no metadata
159+
key holds it.
160160

161161
```ts
162162
// PKCE always on; the ref is the client secret, omitted for a public client.

0 commit comments

Comments
 (0)