Stories A promise's telling

ONE in Claude

A person adds ONE to Claude by pasting one URL, and signs in the way they sign in to ONE.

The seven beats

Groups
Groups
Actors
Actors
Events
signal
Things
Things
Paths
Paths
Outcome
Events
Learning
Learning

This story carries its beats but no written telling yet — text/mcp.md has no “The story” section.

Connected to

Every link here was checked against the repo when the page was built. 3 names the story uses could not be found and are shown without a link.

People

  • a ONE account holder who uses Claude

Agents

Each opens a chat with that agent.

Paths

The flows this story walks — trigger → step → step.

  1. trigger: Claude calls /mcp → human: the person approves at /oauth/authorize → tool: the router runs the call as the person

Tools

Receivers and scripts it signals.

  • the stdio tool router in packages/mcp
  • /api/auth/mcp/device/approve (the approval it reuses)
  • agent-key.ts mintKey

Promises

What it holds; a told promise opens its own story.

Events

Every event is a signal; each names the path it marks or warns.

  • mcp:connected · from the authorize step, once the person approves marks the path from the person to the connector tags: mcp
  • mcp:auth-refused · from the token or authorize step, on a refusal warns the path, so a bad client costs more each time tags: mcp, auth

Transactions

  • none — a tool that moves money keeps its own limit and its own Touch ID

Analytics

  • connections made, tools called per connection, refusals by reason — read from the signals above