Quickstart

A folder with an app in it, and something that speaks MCP: Claude Code, Claude Desktop, claude.ai, Cursor, Codex, Windsurf, Cline or Zed. That is the whole list. There is no CLI to install.

Spocket is one URL. How you add it depends on what you are using, and the two shapes are genuinely different — Claude Desktop and claude.ai have no config file at all, so if you go looking for one you will not find it.

https://www.spocket.dev/api/mcp

Claude Desktop and claude.ai

1. 01
   Open Settings → ConnectorsOn claude.ai this is under your profile menu. In Claude Desktop it is in the app settings.
2. 02
   Add custom connectorPaste https://www.spocket.dev/api/mcp as the URL. There is nothing else to fill in — no API key, no client id, no secret.
3. 03
   ConnectA browser window opens and asks you to allow the connection. Approve it once. Claude registers itself with us automatically and holds the token from then on.

Claude Code

claude mcp add --transport http spocket https://www.spocket.dev/api/mcp

Cursor, Codex, Windsurf, Cline and Zed

These read a config file. The key differs — Cursor and Windsurf use mcpServers, Codex uses mcp_servers in TOML — but the URL is the same one:

{
  "mcpServers": {
    "spocket": {
      "type": "http",
      "url": "https://www.spocket.dev/api/mcp"
    }
  }
}

Restart the editor afterwards. The first time your agent uses Spocket, the same browser approval appears.

Tell your agent what you want. It reads your folder, bundles the files and ships them:

Deploy this folder to Spocket as "mod-app".

The bundle uploads, a container starts, dependencies install, and your entry point runs. A small app is live in about twenty seconds; one with heavy dependencies takes a minute.

Most apps need a secret before they can connect to anything:

Set DISCORD_TOKEN on mod-bot to <your token>, then restart it.

The value is encrypted before it is stored. Neither you nor any connected tool can read it back afterwards — only replace it. That is deliberate: a token you cannot retrieve is a token that cannot be exfiltrated by anything holding your credentials.

What's the status of mod-app? Show me its logs.

You get the running state, memory, uptime and recent output. If it did not start, the reason is almost always in the first few lines — and your agent can read them and fix the code without you switching windows.