Connect your agent to Blocko

ChatGPT (web and desktop) from official or vendor docs

ChatGPT connects to remote MCP servers as custom connectors. This needs Developer mode, which OpenAI offers on paid plans; menu names change, so follow the labels you see.

1. Open Settings, then Connectors, then Advanced settings, and turn on Developer mode.
2. Back in Connectors, choose Create.
3. Name it Blocko, paste the server URL below, and set Authentication to No authentication.
4. Tick the box that you trust the connector, then Create. Start a new chat and enable Blocko from the tools menu.

https://blocko.ai/mcp

Shopify Sidekick limited / unverified

Unverified. We could not find documentation that lets a merchant add an arbitrary remote MCP server to Shopify's Sidekick; Shopify extends Sidekick through app extensions that app developers build. Check Sidekick's settings for a custom connector option, and if it is not there, use one of the alternatives below.

1. Best alternative: connect Blocko to Claude, ChatGPT, Cursor or Codex (below), ask the agent to install the section into your theme, then review it in the Theme Editor.
2. Or open an item in the library, copy its one-line prompt, and paste it into any coding agent.

https://blocko.ai/mcp

If Shopify adds custom MCP support to Sidekick, the server URL is the same as for every other client.

Claude (Claude Code, Claude Desktop, claude.ai) from official or vendor docs

Claude Code adds a remote server with one command. Claude Desktop and claude.ai use custom connectors.

1. Claude Code: run the command below.
2. Claude Desktop or claude.ai: open Settings, then Connectors, scroll down and choose Add custom connector, paste the server URL and add it. On Team and Enterprise plans an owner adds the connector first.

claude mcp add --transport http blocko https://blocko.ai/mcp

# or add the Blocko plugin (skills for find, install and deploy)
claude plugin marketplace add blockoai/blocko && claude plugin install blocko-sections@blocko

Custom connector URL: https://blocko.ai/mcp

Hermes Agent (Nous Research) from official or vendor docs

Hermes reads MCP servers from ~/.hermes/config.yaml and registers their tools at startup.

1. Add the block below under mcp_servers in ~/.hermes/config.yaml.
2. Restart Hermes (or start a new session) so it discovers the Blocko tools.

mcp_servers:
  blocko:
    url: "https://blocko.ai/mcp"

OpenClaw from official or vendor docs

OpenClaw keeps MCP servers in its registry; add Blocko as a streamable HTTP server.

1. Run the command below.
2. Check it with openclaw mcp show blocko --json.

openclaw mcp set blocko '{"url":"https://blocko.ai/mcp","transport":"streamable-http"}'

Cursor from official or vendor docs

Add Blocko in Settings, then MCP, or edit .cursor/mcp.json (project) or ~/.cursor/mcp.json (global).

1. Paste the JSON below into mcp.json.
2. Open Cursor's MCP settings and enable the blocko server.

{
  "mcpServers": {
    "blocko": {
      "url": "https://blocko.ai/mcp"
    }
  }
}

Codex CLI from official or vendor docs

Codex stores MCP servers in ~/.codex/config.toml; the CLI can write it for you.

1. Run the command below, or add the TOML block to ~/.codex/config.toml.
2. Start Codex and run /mcp to confirm the server is listed.

codex mcp add blocko --url https://blocko.ai/mcp

# or in ~/.codex/config.toml
[mcp_servers.blocko]
url = "https://blocko.ai/mcp"

VS Code and GitHub Copilot from official or vendor docs

VS Code reads MCP servers from .vscode/mcp.json (workspace) or your user profile. Note the root key is servers, not mcpServers.

1. Create .vscode/mcp.json with the JSON below, or run MCP: Add Server from the Command Palette.
2. Open Copilot Chat in Agent mode and enable the blocko tools.

{
  "servers": {
    "blocko": {
      "type": "http",
      "url": "https://blocko.ai/mcp"
    }
  }
}

Any other MCP client from official or vendor docs

Blocko speaks standard MCP over streamable HTTP, with no authentication. Anything that can connect to a remote MCP server can use it.

1. Add a remote (HTTP) server named blocko with the URL below. Config key names vary by client.
2. To test without an agent, run the MCP Inspector and connect to the URL.

{
  "mcpServers": {
    "blocko": {
      "type": "http",
      "url": "https://blocko.ai/mcp"
    }
  }
}

# test it
npx @modelcontextprotocol/inspector

No MCP? Paste the one-line prompt from official or vendor docs

Every item in the library has a single-line prompt that works in any coding agent that can read GitHub. Open an item, copy its prompt and paste it. This is an example:

Use the Blocko library (https://github.com/blockoai/blocko) to implement the section "FAQ accordion" into my project. Before changing any code, ask me where it should go and whether the target is a Shopify theme or a plain HTML site.

Claude Code plugin

Prefer skills over a server? The plugin adds four skills: find items in the catalog, install a section or block, push a whole theme, and deploy the optional API Worker.

claude plugin marketplace add blockoai/blocko && claude plugin install blocko-sections@blocko

What to ask

• "Which Blocko section fits an FAQ for a skincare store?"
• "Add the Blocko account sign-in section to my theme."
• "List Blocko pages that are ready as Shopify Liquid."

Browse the library Library index