START HERE

Quickstart

Get an app online from your editor in about two minutes.

What you need

Something that speaks MCP: Claude Desktop, claude.ai, ChatGPT, Claude Code, Cursor, Codex, Windsurf, Cline or Zed. That is the whole list. There is no CLI to install and nothing to set up on your machine.

A project on disk is the common case, and any editor or desktop app can read one. But it is not required: if the code is in your conversation, that is enough to deploy it — which is what makes this work on claude.ai and ChatGPT, where there is no folder to point at.

No bot yet? Ask for one. "Write me a Discord bot that responds to /ping and deploy it to Spocket" is a complete instruction — the writing and the deploying are the same request.

Connect

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.

THE SERVER URL

https://www.spockethosting.com/api/mcp

Claude Desktop and claude.ai

Four screens, about thirty seconds. The steps are the same in the desktop app and on claude.ai — the screenshots below are from the desktop app.

The Claude menu, with Settings at the top above Language and Get help. — 1 · Open Settings from the Claude menu.

The Customize section of Settings, listing Skills, Connectors, Plugins and Memory. — 2 · In the sidebar under Customize, choose Connectors.

A dropdown with two options: Browse connectors, and Add custom connector. — 3 · Choose Add custom connector — not Browse.

The Add custom connector dialog, with a name field reading SPOCKET HOSTING and the URL field containing https://www.spockethosting.com/api/mcp. The OAuth client ID and secret fields under Advanced settings are empty. — 4 · Name it anything, paste the URL, and press Add. Leave the OAuth fields empty.

A browser window then asks you to allow the connection. Approve it once — Claude registers itself with us and holds the token from then on, so this does not come back.

The OAuth Client ID and Secret under Advanced settings stay empty. They are there for servers that need credentials issued by hand; Spocket issues its own during that approval, which is why there is nothing for you to copy anywhere.

Claude Code

BASH

claude mcp add --transport http spocket https://www.spockethosting.com/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:

CURSOR · ~/.CURSOR/MCP.JSON

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

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

Other clients

01
ChatGPTSettings → Connectors → Add. Same URL, same approval. Connectors need developer mode enabled.
02
Anything else with a connector listIf it accepts a remote MCP server URL, it accepts this one. There is no API key, client id or secret to fill in.

Use www.spockethosting.com, not spockethosting.com. The bare domain redirects, and some clients do not follow redirects on the initial handshake.

Deploy

Tell your agent what you want. If it can see your files, point it at them:

TEXT

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

And if the code is in the conversation rather than on disk, say that instead — there is nothing to save or upload first:

TEXT

Deploy that bot 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.

Add your token

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

TEXT

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.

Pasting a token into a chat puts it in that conversation’s history. For anything that matters, set it in the panel under your app’s Environment tab instead.

Check it worked

TEXT

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.

NEXTHow it works