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.
- 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.
Docs
What derives from this file.
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