Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chatblocks.ai/llms.txt

Use this file to discover all available pages before exploring further.

Three steps. By the end you’ll have a published block, rendered on your personal canvas, built by your coding agent over the MCP server.
1

Sign up

Go to chatblocks.ai and sign in with Google. We use Better Auth — magic link is also available where configured.On first signup you’ll go through /setup (pick a username), then a personal workspace is created automatically (${username}'s Workspace, slug = your username). Workspaces own all your blocks, canvases, connectors, BYOK keys, and audit log.A welcome canvas is seeded with two tutorial blocks so you have something to look at right away.
2

Pick your coding agent

Onboarding routes you to /onboarding/agent — a 4-tile picker plus an “Other” option:
  • Claude Code — Anthropic’s CLI
  • Codex — OpenAI Codex
  • Cursor — the editor
  • Windsurf — Codeium’s editor
  • Other — generic MCP client (Claude Desktop, etc.)
Each option shows the exact config snippet to paste into your agent. The wire format is the same everywhere: an Authorization: Bearer cb_live_* header against https://chatblocks.ai/api/mcp/v1.
{
  "mcpServers": {
    "chatblocks": {
      "url": "https://chatblocks.ai/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer cb_live_..."
      }
    }
  }
}
The first MCP call from your agent flips the live-sync badge in your canvas chrome from “empty” to “live” — that’s how you know the connection works.
3

Ask your agent to make a block

In your coding agent, say something like:
Make me a block that shows the weather in San Francisco.
The agent will walk through blocks.init → setFiles → build → publish over MCP. init scaffolds a single-file React app, setFiles writes your edits, build runs the Vercel Sandbox build, and publish lands a new published version. The published block lands on your canvas automatically.Refresh chatblocks.ai and the block is there. Click it to expand and inspect the source the agent wrote — the right rail shows the file list, recent edits, and a diff against the previous version.
Free workspaces include 100 builds per month, 10 blocks, and 2 canvases. The full caps are on Plans and limits. Builder ($9/mo) lifts the caps and unlocks BYOK keys, AI-generated blocks, and scheduled runs.

​
What’s next

Authoring → Via an agent

The full MCP authoring loop, manifest fields, and how to drive blocks.create for AI-generated drafts.

MCP → Setup

Per-client config, key rotation, and the complete tool reference.