• ANALYSIS
  • REPAIR
  • HISTORY
  • HUMAN

How to debug real-time state with your AI

Connect your agent to Liveblocks to inspect live document data and patch room storage to fix sync issues.

Ask AI about this page

Short answer

How can I debug real-time state with my AI?

Your agent pulls the current Yjs document and room storage to find where data diverged. It then identifies the mismatch and applies patches to the storage to fix the sync. You get a clear view of the document state and a way to correct it.

Debugging outcomes

Where your fixes land.

The AI handles the data inspection so you can focus on the logic.

ANALYSIS

State inspection

The agent pulls the Yjs document and room storage to find where the data diverged. You get a clear report of the current state.

REPAIR

Storage patching

Once the agent finds the error, it applies a patch to the room storage. This fixes the sync issue for all connected clients.

HISTORY

Version auditing

The agent looks through previous versions to find exactly when the state went wrong. This helps pinpoint the specific change that broke the sync.

HUMAN

Logic verification

The AI identifies the mismatch, but you decide if the patch is correct. You review the proposed changes before they go live.

The workflow

What your AI does when a sync error occurs.

The agent moves from observation to correction using specific Liveblocks tools.

  1. Read the document

    The agent pulls the current Yjs document to see the actual data structure being shared.

    get_ydoc

  2. Check room storage

    It compares the document against the underlying room storage to find inconsistencies.

    get_storage

  3. Review history

    The agent looks at past versions to trace the origin of the corruption.

    list_versions

  4. Fix the state

    The agent applies the necessary updates to the room storage to align the state.

    patch_storage

Try it

Copy these to start.

Use these prompts to kick off a debugging session.

Starting points

Replace the room IDs and document names with your actual Liveblocks identifiers.

Liveblocks Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_v2FU0vtTfzUrtsk5QcSuOhhoPhdk0tcyNdn6k4Ay/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Liveblocks capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "liveblocks-collaborative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_v2FU0vtTfzUrtsk5QcSuOhhoPhdk0tcyNdn6k4Ay/mcp"
    }
  }
}
Copy into chat04

  • Get the Yjs document for room 'dev-room-123' and tell me if the state looks valid.

  • Compare the current storage in room 'prod-session-456' with the latest Yjs document.

  • List the recent versions for room 'user-edit-789' to find when the state diverged.

  • Patch the storage in room 'test-room-000' to fix the missing user metadata.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Liveblocks once, then ask.

Just link your account once. Your credentials stay encrypted, and you can immediately start debugging via your preferred AI client.

Connect Liveblocks to your AI

FAQ

How this task behaves.

  • 01

    Can the AI delete my room storage?

    No. The agent can only patch existing storage; it has no tool to delete rooms or wipe storage.

  • 02

    Will the AI automatically fix my production data?

    No. The agent proposes the patch, but you must review and trigger the action to ensure the fix is correct.

  • 03

    Can it see my application's private database?

    No. The agent only has access to the data exposed through the Liveblocks Yjs and storage tools.

  • 04

    Can I use this to create new rooms?

    No. This MCP is designed for inspecting and patching existing state, not for room orchestration or creation.

  • 05

    Does it work with any real-time framework?

    It works with any setup using Liveblocks and Yjs, as it interacts directly with the Liveblocks storage and documents.

  • More questions about Liveblocks? The Connector page answers them. See everything the Liveblocks Connector can do

Connect Liveblocks to Claude, Cursor, ChatGPT & more