Docs · Agents

Run Ciela from your AI agent.

Build and edit your demos from Claude Code or Codex.

What you get

  • Build without the dashboardAsk your agent to create a demo for a prospect's website. It waits for the build and hands you the link.
  • Edit in plain wordsChange the headline, voice, greeting, fonts or logo by telling your agent what you want.
  • Stays in your accountEach connection only reaches your own demos. Revoke it any time in Settings.

Set it up

  1. 1. Create a key. Included with the Agency plan, including the trial. In Settings → Agent connections, create a key. You only see it once. Store it in the CIELA_API_KEY environment variable, not in a file you commit.
  2. 2. Claude Code or Codex on this computer (recommended).

    Needs Node.js 20 or later and lets Claude or Codex upload logo files from your folder.

    Use this when your agent runs on your computer. Claude Code: add this to your project's .mcp.json, then restart Claude Code.

    {
      "mcpServers": {
        "ciela": {
          "type": "stdio",
          "command": "npx",
          "args": [
            "--yes",
            "--package",
            "https://ciela.ai/mcp/ciela-mcp-0.1.0.tgz",
            "ciela-mcp"
          ],
          "env": {
            "CIELA_API_KEY": "${CIELA_API_KEY}"
          }
        }
      }
    }

    Codex: add this to ~/.codex/config.toml, then restart Codex.

    [mcp_servers.ciela]
    command = "npx"
    args = ["--yes","--package","https://ciela.ai/mcp/ciela-mcp-0.1.0.tgz","ciela-mcp"]
    env_vars = ["CIELA_API_KEY"]
  3. 3. Ask: “Create a demo for example.com.”

Web or cloud agents

Use the hosted connection when your agent runs on the web or in the cloud. Logos must be public image links. Existing hosted connections keep working. Both options read CIELA_API_KEY from the environment; keep the actual key out of the file.

Claude Code: add this to .mcp.json, then restart Claude Code.

{
  "mcpServers": {
    "ciela": {
      "type": "http",
      "url": "https://ciela.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${CIELA_API_KEY}"
      }
    }
  }
}

Codex: add this to ~/.codex/config.toml, then restart Codex.

[mcp_servers.ciela]
url = "https://ciela.ai/api/mcp"
bearer_token_env_var = "CIELA_API_KEY"

Use an attached logo

With the recommended local connection, attach the logo and ask your agent to use it on the demo. It passes the file path; the connector uploads the image, then your agent applies the returned URL. PNG, JPEG, WebP, SVG and GIF are supported up to 2 MiB. The file must be accessible in your workspace or an approved folder. In Claude Code, add an outside folder with /add-dir. Web or cloud agents use public image links.

Updates

Backend updates take effect automatically and your key stays valid. The local connector checks for new or changed tools every minute and notifies Claude Code to refresh them. Updating the local connector itself can require restarting it. On the direct HTTP connection, refresh from /mcp if a newly released tool or input is missing.

Things to ask

  • “Create a demo for example.com.”
  • “Show my remaining demo allowance and list my demos.”
  • “Change the headline on my example.com demo and keep everything else the same.”

Good to know

A key works like a password for your demos. Use one key per agent, and revoke a key in Settings if you stop using it. A key cannot manage billing or create other keys. Demos your agent creates use the same demo allowance as the dashboard.

Keep reading

Need help?

Write to adhiraj@kingstonesystems.com and we'll jump on the connection with you.

Email support