Get startedCLIAPIMCPWebDesktopAgentsSupportBillingChangelog
Connect
raycast logo

Raycast AI

Raycast AI can call Dock via Quicklinks (for lookups) or the Script Commands + Node REST pattern (for writes). The MCP integration ships for Raycast Pro users with agent commands.

Client
Raycast AI
macOS launcher with AI. Quicklinks for REST, MCP for agent commands.
HTTP JSON-RPC (streamable-http)
Dock MCP
trydock.ai/api/mcp
37 tools · OAuth 2.1 + DCR · Bearer
Auth path
1
Mint a dk_ key in Dock Settings → API keys.
2
Paste it as Authorization: Bearer dk_… in the client config.
3
Client calls Dock MCP directly on every request.

Prerequisites

  • Raycast installed (macOS).
  • A Dock dk_ key.
Secret
Raycast · Extensions · Developer · Secrets · add DOCK_API_KEY.
A Script Command: append a drafted rowtypescript
import { getPreferenceValues, showToast } from "@raycast/api";

export default async function main() {
  const { dockApiKey } = getPreferenceValues<{ dockApiKey: string }>();
  const title = await showPromptForTitle();
  await fetch(
    "https://trydock.ai/api/workspaces/inbox/rows",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${dockApiKey}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ data: { title, status: "drafted" } }),
    }
  );
  showToast({ title: "Added to Dock inbox" });
}

Troubleshooting

Symptom
Fix
"Extension needs a token"
Add dockApiKey as a Preference in package.json.

Frequently asked questions

How do I connect Dock to Raycast AI?
Add Dock as a remote MCP server in Raycast AI. Either let Raycast AI's OAuth 2.1 + DCR flow handle auth (recommended; no credential ceremony), or paste a scoped Dock `dk_` API key in Raycast AI's MCP config under the `Authorization: Bearer dk_…` header.
Does Raycast AI 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 Raycast AI, discovers them via the standard `tools/list` handshake. Learn more →
How do I limit which Dock workspaces Raycast AI can write to?
When you mint the `dk_` key for Raycast AI 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 Raycast AI did in my Dock workspace?
Open the workspace in your browser. Every row Raycast AI 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 Raycast AI 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 Raycast AI's `dk_` key in Settings → API keys.
Can multiple Raycast AI sessions share state through Dock?
Yes. Every Raycast AI 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 Raycast AI need OAuth or a dk_ API key for Dock?
Either works. OAuth 2.1 + DCR is the recommended path: Raycast AI 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 →
How do I use Dock with Raycast AI?
Two paths. Use Raycast's Quicklinks to hit Dock's REST API for one-shot row writes. For full agent-mode access, configure Dock as an MCP server in Raycast AI Settings → Extensions → MCP (Pro tier required).
Does Raycast AI support Dock's MCP on the free tier?
MCP custom-server support in Raycast AI is gated to Raycast Pro. The Quicklinks-to-REST path works on free, and lets you trigger row writes from any Raycast invocation.
How do I trigger a Dock workflow from Raycast keyboard shortcut?
Create a Raycast Quicklink pointing at a Dock REST endpoint with your `dk_` key in the header (or use a script command). Bind it to a hotkey. Now ⌘-shift-D appends a row to your Dock workspace from anywhere on macOS.

Related

Updated