# Dock

> Dock is a workspace where people and AI agents make docs, decks (slide presentations), sheets, databases and canvases together. Agents work in Dock through its remote MCP server; every node has a browser URL to hand back to the user.

## Connect

- MCP endpoint (Streamable HTTP, OAuth 2.1): https://app.dock.space/v1/mcp
- Claude Code: `claude mcp add --transport http dock https://app.dock.space/v1/mcp`
- Codex: `codex mcp add dock --url https://app.dock.space/v1/mcp`, then `codex mcp login dock`
- Any other MCP client (Claude.ai, Claude Desktop, Cursor, ...): add a custom connector with the endpoint above.
- Sign-in: the first call answers 401 with `WWW-Authenticate: resource_metadata=...` (RFC 9728). The client registers itself (Client ID Metadata Document or Dynamic Client Registration) and opens the browser once, where the user signs in to Dock and approves. Nothing in Dock can be made before that.

## No Dock tools in this session

A connector added now is there in the NEXT session. To do the user's task in this one, use the command line:

1. Install: `curl -fsSL https://app.dock.space/install.sh | sh` (puts `dock` in `~/.local/bin`).
2. Sign in: `dock login`. It prints a URL and a code: give both to the user, and leave it running until they approve in the browser.
3. Work: `dock deck get <deck id>` reads a deck with its slide and shape ids, `dock deck verbs` lists the edits, `dock deck edit <deck id> <verb> --args '[...]'` makes one, and `dock --help` lists the rest. Read the skill for the job first (below).

## Links

- Every node opens in the browser at `https://app.dock.space/w/<workspace>/<letter>/<id>` (`k` a deck, `d` a page, `s` a sheet, `b` a database). A tool that makes a deck answers its `webUrl`: hand that link to the user.
- When the user hands you a Dock link, pass it as is wherever a tool takes that node's id (`presentation_id`, a page's `id`, `doc_id`, `node_id`, ...). The tool reads the id out of it.
- The id is the 32 hex digits at the end of the link; written as a uuid (8-4-4-4-12, with hyphens) it is what every tool and command takes, older ones included. The workspace is the part after `/w/`: a command run with no link takes it as `--workspace <workspace>`.

## Skills

Read the skill for the job before the first tool call. Once connected, the same text is the MCP tool `dock_skill` (call it with a skill name).

- [dock-slides](https://app.dock.space/.well-known/agent-skills/dock-slides/SKILL.md): Use whenever the user asks to make, draft, redo or improve a deck, presentation, slides, 簡報 or 投影片 in Dock, even when they name no tool.
- [dock-slides-visual](https://app.dock.space/.well-known/agent-skills/dock-slides-visual/SKILL.md): The look of every Dock deck, built from native objects — custom-geometry shapes, texture fills, shadow and glow, theme fonts, Morph and entrance builds — with style packs for torn-paper collage, kinetic typography, retro CRT, board explainer and pixel art. Load it after dock-slides for every deck; a style, mood or "video-like" ask (拼貼, 撕紙, 動態字, 復古, 像素, 視覺化說明) picks its pack.
- [Skill index](https://app.dock.space/.well-known/agent-skills/index.json): Agent Skills discovery index (schema 0.2.0) with a sha256 digest per skill.
