Connect
ChatGPT (MCP + Apps SDK)
Two ways to wire Dock into ChatGPT, depending on what you want. The full Dock MCP server gives every primitive (63 tools, full API surface). The curated Dock app gives a focused, opinionated subset with rich inline widgets (workspace picker, doc preview, confirm cards). Both speak the same backend; pick whichever matches your usage. The marketing page at /chatgpt-app has a 3-step visual install flow if you prefer a guided walk-through.
Client
ChatGPT (MCP + Apps SDK)
ChatGPT speaks MCP natively on Plus / Team / Enterprise via Settings → Apps → Create app.
HTTP JSON-RPC (streamable-http)
Dock MCP
trydock.ai/api/mcp
37 tools · OAuth 2.1 + DCR · Bearer
Auth path
1
Client fetches
/.well-known/oauth-authorization-server.2
Self-registers via DCR, opens your browser to Dock consent.
3
Dock returns an access token, client uses it on every request.
Prerequisites
- ChatGPT Plus, Team, or Enterprise (the custom-app feature is gated to paid tiers).
- Developer Mode enabled in Settings → Apps → Advanced settings.
Path A: full MCP
Settings → Apps → Create app → URL
https://trydock.ai/api/mcp → Auth: OAuth. ChatGPT auto-registers via Dock's /api/oauth/register and opens a browser for sign-in. After consent, all 48 Dock MCP tools become available in chat.Path B: curated app
Same dialog → URL
https://chatgpt-app.trydock.ai/sse → Auth: OAuth. Five tools: save_chat_to_dock, create_dock_workspace, upsert_dock_rows, summarize_dock_workspace, show_dock_workspaces, each renders a custom card inline in chat (workspace picker, doc preview, confirm dialog) instead of plain text.Auth model
Per-user OAuth. Each ChatGPT user signs into Dock with their own identity; the agent acts as them, not as a shared service account. Destructive operations route through Dock's two-call confirmation pattern (and on the curated app, through an in-chat Approve/Cancel card).
Pick one path or both, they coexist cleanly because each is a separate connector in ChatGPT's app drawer. Most teams start with the curated app (better in-chat UX) and add the full MCP for power users who want every primitive.
Verify
Test the full MCPtext
List my Dock workspaces, then append a row to content-pipeline with the title "ChatGPT smoke test".Test the curated apptext
Use the Dock app to show me my workspaces, summarize the launch-plan workspace, and save this conversation when I'm done.Troubleshooting
Symptom
Fix
"Add app" button isn't visible in Settings → Apps
ChatGPT's custom MCP feature is gated to Plus / Team / Enterprise. Free tier doesn't expose the dialog. Upgrade or use Claude Web / Claude Desktop instead.
OAuth bounces back to the sign-in wall
ChatGPT requests
/.well-known/oauth-authorization-server/mcp for discovery, Dock serves identical metadata at both the root and the suffixed path. If the bounce keeps happening, your tier may not have rolled out to MCP custom servers yet; check the Apps directory for the green checkmark.Curated-app widget renders empty ("0 workspaces")
The connector cached an older version of the tool schema. Open the app's settings page in ChatGPT and click Refresh. ChatGPT re-fetches
tools/list and the widget's structuredContent on next call.Frequently asked questions
- How do I connect Dock to ChatGPT?
- Add Dock as a remote MCP server in ChatGPT. Either let ChatGPT's OAuth 2.1 + DCR flow handle auth (recommended; no credential ceremony), or paste a scoped Dock `dk_` API key in ChatGPT's MCP config under the `Authorization: Bearer dk_…` header.
- Does ChatGPT work with Dock's MCP server?
- Yes. Dock exposes 43 MCP tools at `https://trydock.ai/api/mcp` over HTTP transport with OAuth 2.1 + DCR and Bearer-token auth. Any MCP-spec-compliant client, including ChatGPT, discovers them via the standard `tools/list` handshake. Learn more →
- How do I limit which Dock workspaces ChatGPT can write to?
- When you mint the `dk_` key for ChatGPT in Settings → API keys, pick the workspace from the dropdown. The key returns 403 on every other workspace regardless of what the prompt asks. To scope across multiple, mint multiple keys or add the agent as an explicit member of each. Learn more →
- How do I see what ChatGPT did in my Dock workspace?
- Open the workspace in your browser. Every row ChatGPT created or updated is stamped with the agent's identity (orb + name) in the createdBy / updatedBy field. The workspace activity feed shows every action chronologically. Learn more →
- How do I undo a row ChatGPT wrote to Dock?
- Open the row, click the kebab menu, choose Delete (soft-delete preserves history). For bulk reverts use the activity feed to find the agent's session and delete its rows in batch. To prevent future writes, revoke ChatGPT's `dk_` key in Settings → API keys.
- Can multiple ChatGPT sessions share state through Dock?
- Yes. Every ChatGPT session reads and writes the same workspace, so handoffs across machines or across long-running multi-session workflows just work. The Dock workspace IS the shared state; no separate message bus required.
- Does ChatGPT need OAuth or a dk_ API key for Dock?
- Either works. OAuth 2.1 + DCR is the recommended path: ChatGPT hits Dock's discovery endpoint at `/.well-known/oauth-authorization-server` and auto-registers as a client. The `dk_` Bearer token path is fine for owned-code agents and CI scripts; pick whichever fits your stack. Learn more →
- Does ChatGPT support Dock as an MCP server?
- Yes. ChatGPT's MCP support uses OAuth 2.1 + DCR; add Dock under Settings → Connectors → Add MCP Server with URL `https://trydock.ai/api/mcp`. ChatGPT auto-registers via Dock's `/api/oauth/register` and opens a browser for consent. Learn more →
- Can ChatGPT search my Dock workspace via MCP?
- Yes. The `search` MCP tool returns ranked hits across workspace names, row cell values, and doc sections. ChatGPT auto-discovers it via `tools/list` and can call it without any user prompt-engineering.
- Does ChatGPT need a paid plan to use Dock's MCP?
- ChatGPT's MCP connector support is gated to paid tiers (Plus / Team / Enterprise) at the time of writing. Dock itself is free; the gate is on ChatGPT's side. Anthropic's Claude Web is a free alternative MCP host.