Skip to content

docs: connect an AI agent to the hosted MCP server or dcd mcp - #164

Open
finalerock44 wants to merge 4 commits into
mainfrom
docs/connect-ai-agent
Open

finalerock44 wants to merge 4 commits into
mainfrom
docs/connect-ai-agent

Conversation

@finalerock44

Copy link
Copy Markdown
Contributor

A new page, Connect an AI Agent, sets up every client against both ways in: the hosted server (Claude Code, Cursor, VS Code, Claude Desktop, Codex and other OAuth clients), its read-only URL and API-key sign-in, and dcd mcp through the CLI, with dcd mcp install and the configs by hand. It also covers Connected apps, and points dcd-mcp users at the existing MCP Server page.

A new page, Connect an AI Agent, sets up every client against both ways
in: the hosted server (Claude Code, Cursor, VS Code, Claude Desktop,
Codex and other OAuth clients), its read-only URL and API-key sign-in,
and dcd mcp through the CLI, with dcd mcp install and the configs by
hand. It also covers Connected apps, and points dcd-mcp users at the
existing MCP Server page.
@finalerock44 finalerock44 self-assigned this Nov 9, 2026
Comment thread mcp/connect.md Resolved
Comment thread mcp/connect.md Resolved
Comment thread mcp/connect.md Resolved
…sion

Review follow-ups on the Connect an AI Agent page:
- The pages that said the standalone binary has no MCP server meant
  dcd-mcp, which is still npm-only. They now say both installs have
  dcd mcp, and the dcd-mcp page points new setups at Connect an AI Agent.
- The MCP servers renew a dcd login session as they run, so the warnings
  that a long-running server stops when the session expires were out of
  date (api-keys, dcd login, MCP Server). An API key is still the advice
  for agents that run unattended.
- API keys gets an Access section (Full access, Device sessions only),
  which the agent page links to.
- Connect an AI Agent says to update the CLI when dcd mcp, or a client
  in dcd mcp install, is missing.
"gives an AI agent such as ... the tools to" ran the client list into
the second object. It now reads "lets an AI agent, such as ..., drive
cloud devices and run cloud tests".
@claude

claude Bot commented Nov 9, 2026

Copy link
Copy Markdown

Code review

I found no bugs. The JSON, TOML and shell snippets are valid. Every relative link resolves, and so does the new #access anchor. SUMMARY.md adds the page without renaming anything, so no redirect is needed.

CLAUDE.md says: "Flag a doc change that names a flag, input or endpoint the rest of the docs don't use, so a reviewer can confirm it exists." This PR names several. Please confirm they exist in the current CLI and API:

  • How the hosted server takes an API key: in an Authorization: Bearer <key> header (mcp/connect.md L105-L107). Everywhere else in the docs, the key goes in x-app-api-key (getting-started/api-keys.md L74-L80). Please check that the hosted MCP endpoint takes Bearer.
  • dcd mcp and dcd mcp install: the client names claude-code, claude-desktop, codex, cursor and vscode, the --print flag, and the claim that dcd mcp reads --read-only and DCD_MCP_READONLY (L119-L124, L172-L174).
  • Hosted server: the ?read_only=true query parameter, and the tool names get_human_status, cheat_sheet, install_app (app_path) and run (path). None of these are in Tools Reference (L87-L89, L112-L114).
  • Console UI: the API key Access setting, with Full access and Device sessions only (getting-started/api-keys.md L36-L45). Also Settings → AI agents and Settings → Account → Connected apps.
  • Behaviour change: cli/dcd-login.md, getting-started/api-keys.md and mcp/overview.md now say an MCP server renews its dcd login session while it runs. Before, they said it didn't. mcp/overview.md now says this about the older dcd-mcp too (L49-L52).
  • Node 22 minimum for the npx route (L170-L172).

🤖 Generated with Claude Code

The page now covers dcd mcp, the MCP server in the CLI, for running cloud
tests from an AI agent: setting it up with dcd mcp install, running it
headless with an API key (for example in CI), configs by hand, its dcd_*
tools and read-only mode, and the older dcd-mcp. The CLI Reference and
MCP Server pages point at it the same way.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant