Repository navigation
docs: Agent Devices (hosted MCP device sessions) - #134
Merged
Merged
Conversation
- mcp/agent-devices.md: what Agent Devices are; connecting Claude Code, Cursor and other MCP clients to https://api.devicecloud.dev/mcp (OAuth sign-in through the console, or an API key, ideally "Device sessions only"); connected apps; how an agent works a device; asking a person for help and handing back; watching and taking control in the console; secrets in env; recordings and artifacts; limits; pricing. - mcp/agent-devices-tools.md: every tool, its description and inputs, generated from the server's own tool list. - api/device-sessions.md: the /device/sessions REST API and its error codes. - notifications/webhook-notifications.md: the device.needs_human event. - README quick link, and SUMMARY entries. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018tQfgpTsA9UhcopKoDezUA
- New CLI page for dcd device: every subcommand, the --json envelope, exit codes and the default-session rule. - Agent Devices: connecting through dcd mcp, with local files. - Device sessions API: the flow bundle endpoints. - dcd live is marked deprecated in favour of dcd device. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018tQfgpTsA9UhcopKoDezUA
…de skill) Plan 8.2. A page with a ready-to-copy AGENTS.md section and a Claude Code skill that teach an agent the device loop: inspect, act, inspect, ask a person when needed, and always stop the device. llms.txt is generated from SUMMARY.md, so the new pages appear there on their own. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018tQfgpTsA9UhcopKoDezUA
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018tQfgpTsA9UhcopKoDezUA
finalerock44
marked this pull request as ready for review
November 11, 2026 11:29
![claude[bot]](https://avatars.githubusercontent.com/in/1236702?s=60&v=4){kind=small}
Agent Devices reached production on 9 November, and main moved from
GitBook to VitePress, so:
- Callouts use VitePress syntax; GitBook {% hint %} no longer renders.
- The tool reference is regenerated from the production server's own
tool list: wait on get_device_status and get_command_status,
wait_seconds on run, all on inspect_screen, level and grep on
get_logs, and the current descriptions. It now lists the session
block's fields and marks the read-only tools.
- The Agent Devices page covers every client the console's Settings ->
AI agents panel sets up (VS Code, Claude Desktop and Codex too), the
?read_only=true connection, and headless use through dcd mcp with an
API key. Asking a person sends no email, so that line is gone. Taking
control now holds the agent's steps rather than refusing them.
- The REST page adds waitSeconds, inspect ?all, the logs filters,
deviceLocale, the press_key names, the per-session rate limits and
LIVE_NOT_IN_CONTROL.
- dcd device adds request-human, human and inspect --all, and says what
a directory run uploads.
- The agent instructions wait with get_device_status and share the
session's monitor_url.
- The needs_human webhook example uses the model format the API sends.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Hold the merge until we decide to document Agent Devices publicly. They're a closed beta: the hosted MCP server serves no tools to an organization that isn't enrolled. Everything these pages describe is in production (dcd API and console) and in CLI 5.12.0.
This is Phase 8.1 and 8.2 of the dcd Agent Devices plan (
docs/device-v1-plan.md).Pages
mcp/agent-devices.md(new):?read_only=trueconnectiondcd mcpwith an API key, recommending a "Device sessions only" keyenv, recordings and artifacts, and the limits table, which matches the API defaultsmcp/agent-devices-tools.md(new): every tool with its description, inputs and limits, plus the session block's fields. It's generated from the production server's own tool list, through an in-memory MCP client, so it matches what clients see.mcp/agent-devices-skill.md(new): anAGENTS.mdsection and a Claude Code skill.api/device-sessions.md(new): the/device/sessions,/device/modelsand/device/bundlesREST API, grouped into sessions, the device, flow bundles, asking a person and artifacts, plus secrets, rate limits and every error code. The code table was checked against the API's list.cli/dcd-device.md(new): everydcd devicesubcommand in CLI 5.12.0, with--jsonand the exit codes.cli/dcd-live.md: a deprecation notice pointing atdcd device.cli/overview.md:dcd deviceanddcd mcpin the command table.notifications/webhook-notifications.md: thedevice.needs_humanevent, with its payload. Theeventfield is no longer described as "alwaysupload.completed".SUMMARY.mdlink the new pages, so they also appear inllms.txt.Checked
:::syntax.npm run buildandnpm run checkpass: all internal links and anchors are OK across 72 pages.Overlaps
SUMMARY.md, so whichever merges second resolves a small conflict there. It also linksdcd mcpfromcli/overview.md, and the two should agree on where that link goes.dcd mcp install codexisn't in CLI 5.12.0, so the local setup lists Claude Code, Claude Desktop, Cursor and VS Code only. Codex is covered for the hosted server.🤖 Generated with Claude Code