Для чего этот сервер?

Сервер подключает AI к Liveblocks REST API, чтобы тот мог управлять комнатами, комментариями, уведомлениями и другими элементами коллаборативной платформы. Он автоматизирует рутинные задачи — создание и редактирование объектов, чтение Storage и Yjs. Разработчикам не придется писать отдельные скрипты: AI сам настраивает часть инфраструктуры реального времени.

Что он умеет?

Сервер управляет комнатами Liveblocks: создаёт, читает, обновляет, меняет им ID и удаляет их, работает с активными пользователями и рассылает события по комнатам. Ведёт треды и комментарии: создаёт, читает, редактирует, удаляет их, правит метаданные тредов, помечает их решёнными или нерешёнными, подписывает и отписывает участников, ставит и снимает реакции. Разбирается с уведомлениями: читает, триггерит и удаляет входящие, правит настройки. Читает документы Storage и Yjs.

Каталог MCP
liveblocks/liveblocks-mcp-server

liveblocks/liveblocks-mcp-server

от liveblocks

MCP сервер для Liveblocks — AI-инструмент, работающий с REST API платформы для управления комнатами, комментариями и уведомлениями. Создавайте, изменяйте и удаляйте элементы в реальном времени, а т...

Github Сайт сервера

README

39 инструментов

Версии

Установить сервер

`liveblocks-mcp-server`

This MCP server allows AI to use a number of functions from our REST API. For example, it can create, modify, and delete different aspects of Liveblocks such as rooms, threads, comments, notifications, and more. It also has read access to Storage and Yjs. Learn more in our docs.

Setup

To install, copy your Liveblocks secret key from a project in your dashboard and run one of the following commands, replacing sk_xxxxxxxxxxxx with your secret key.

Cursor

Go to File → Cursor Settings → MCP → Add new server.
Add the following, inserting your secret key:

{
  "mcpServers": {
    "liveblocks": {
      "command": "npx",
      "args": ["-y", "github:liveblocks/liveblocks-mcp-server"],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      }
    }
  }
}

Claude Code

Run the following command in the terminal, inserting your secret key:

claude mcp add liveblocks -e LIVEBLOCKS_SECRET_KEY=sk_xxxxxxxxxxxx -- npx -y github:liveblocks/liveblocks-mcp-server

Часто задаваемые вопросы

Инструменты были проиндексированы: 15.10.2026

add-comment-reaction

Добавить реакцию к комментарию Liveblocks

Параметры

commentIdstringобязательный
dataobjectобязательный
roomIdstringобязательный
threadIdstringобязательный

broadcast-event

Транслировать событие в комнату Liveblocks

Параметры

eventobjectобязательный
roomIdstringобязательный

create-comment

Создайте комментарий Liveblocks. Всегда запрашивайте userId.

Параметры

dataobjectобязательный
roomIdstringобязательный
threadIdstringобязательный

create-room

Создать комнату Liveblocks

Параметры

defaultAccessesstring[]обязательный
Стандартные права доступа для комнаты. Возможные варианты прав: 1. ["room:write"] // публичная 2. ["room:read", "room:presence:write"] // только для чтения 3. [] // приватная
groupsAccessesobject
Идентификатор группы для доступа к комнате. Возможные разрешения: 1. ["room:write"] // публичный доступ 2. ["room:read", "room:presence:write"] // доступ на чтение 3. [] // приватный доступ Например, чтобы выдать группе "design" полный доступ: { design: ["room:write"] } Чтобы убрать существующий уровень доступа, установите значение null: { design: null }
metadataobject
roomIdstringобязательный
usersAccessesobject
Идентификатор пользователя определяет доступ к комнате. Разрешения могут быть такими: 1. ["room:write"] // полный доступ 2. ["room:read", "room:presence:write"] // только чтение 3. [] // приватная комната Например, чтобы выдать пользователю "charlie" полный доступ: { charlie: ["room:write"] } Чтобы убрать существующий уровень доступа, установите значение null: { charlie: null }

create-thread

Создаёт поток Liveblocks. Всегда запрашивает userId.

Параметры

dataobjectобязательный
roomIdstringобязательный

delete-all-inbox-notifications

Удалить все входящие уведомления Liveblocks

Параметры

userIdstringобязательный

delete-comment

Удалить комментарий Liveblocks

Параметры

commentIdstringобязательный
roomIdstringобязательный
threadIdstringобязательный

delete-inbox-notification

Удалить уведомление из папки 'Входящие' Liveblocks

Параметры

inboxNotificationIdstringобязательный
userIdstringобязательный

delete-notification-settings

Удалить настройки уведомлений Liveblocks

Параметры

userIdstringобязательный

delete-room

Удалить комнату Liveblocks

Параметры

roomIdstringобязательный

delete-room-subscription-settings

Удалить настройки подписки комнаты Liveblocks

Параметры

roomIdstringобязательный
userIdstringобязательный

delete-thread

Удалить тред Liveblocks

Параметры

roomIdstringобязательный
threadIdstringобязательный

edit-comment

Редактировать комментарий Liveblocks

Параметры

commentIdstringобязательный
dataobjectобязательный
roomIdstringобязательный
threadIdstringобязательный

edit-thread-metadata

Редактировать метаданные треда Liveblocks. null можно использовать для удаления ключа.

Параметры

dataobjectобязательный
roomIdstringобязательный
threadIdstringобязательный

get-active-users

Получить активных пользователей комнаты Liveblocks

Параметры

roomIdstringобязательный

get-comment

Получить комментарий Liveblocks

Параметры

commentIdstringобязательный
roomIdstringобязательный
threadIdstringобязательный

get-inbox-notification

Получить уведомление из входящих Liveblocks

Параметры

inboxNotificationIdstringобязательный
userIdstringобязательный

get-inbox-notifications

Получить последние уведомления входящих сообщений Liveblocks

Параметры

limitnumber
queryobject
startingAfterstring
userIdstringобязательный

get-notification-settings

Получить настройки уведомлений Liveblocks

Параметры

userIdstringобязательный

get-room

Получить комнату Liveblocks

Параметры

roomIdstringобязательный

get-rooms

Получить последние комнаты Liveblocks

Параметры

groupIdsstring[]
limitnumberобязательный
queryobject
startingAfterstring
userIdstring

get-room-subscription-settings

Получает настройки подписки комнаты Liveblocks.

Параметры

roomIdstringобязательный
userIdstringобязательный

get-storage-document

Получить документ из хранилища Liveblocks

Параметры

roomIdstringобязательный

get-thread

Получить тред Liveblocks

Параметры

roomIdstringобязательный
threadIdstringобязательный

get-thread-participants

Получить участников треда Liveblocks

Параметры

roomIdstringобязательный
threadIdstringобязательный

get-threads

Получить последние нити Liveblocks

Параметры

queryobject
roomIdstringобязательный

get-thread-subscriptions

Получить подписки треда Liveblocks

Параметры

roomIdstringобязательный
threadIdstringобязательный

get-user-room-subscription-settings

Получает настройки подписки пользователя на комнату

Параметры

userIdstringобязательный

get-yjs-document

Получить текстовый документ Liveblocks Yjs

Параметры

optionsobject
roomIdstringобязательный

mark-thread-as-resolved

Отметить тред Liveblocks как решённый

Параметры

dataobjectобязательный
roomIdstringобязательный
threadIdstringобязательный

mark-thread-as-unresolved

Отметить поток Liveblocks как неразрешённый

Параметры

dataobjectобязательный
roomIdstringобязательный
threadIdstringобязательный

remove-comment-reaction

Удалить реакцию из комментария Liveblocks

Параметры

commentIdstringобязательный
dataobjectобязательный
roomIdstringобязательный
threadIdstringобязательный

subscribe-to-thread

Подписаться на тред Liveblocks

Параметры

dataobjectобязательный
roomIdstringобязательный
threadIdstringобязательный

trigger-inbox-notification

Создать собственное уведомление в папке «Входящие» Liveblocks

Параметры

activityDataobjectобязательный
Пользовательские данные, связанные с уведомлением.
kindstringобязательный
roomIdstring
Не добавляй это, если специально не попросили.
subjectIdstringобязательный
userIdstringобязательный

unsubscribe-from-thread

Отписаться от ветки Liveblocks

Параметры

dataobjectобязательный
roomIdstringобязательный
threadIdstringобязательный

update-notification-settings

Обновить настройки уведомлений Liveblocks

Параметры

dataobjectобязательный
userIdstringобязательный

update-room

Обновить комнату Liveblocks

Параметры

defaultAccessesstring[]обязательный
Стандартные права доступа для комнаты. Возможные варианты прав: 1. ["room:write"] // публичная 2. ["room:read", "room:presence:write"] // только для чтения 3. [] // приватная
groupsAccessesobject
Идентификатор группы для доступа к комнате. Возможные разрешения: 1. ["room:write"] // публичный доступ 2. ["room:read", "room:presence:write"] // доступ на чтение 3. [] // приватный доступ Например, чтобы выдать группе "design" полный доступ: { design: ["room:write"] } Чтобы убрать существующий уровень доступа, установите значение null: { design: null }
metadataobject
roomIdstringобязательный
usersAccessesobject
Идентификатор пользователя определяет доступ к комнате. Разрешения могут быть такими: 1. ["room:write"] // полный доступ 2. ["room:read", "room:presence:write"] // только чтение 3. [] // приватная комната Например, чтобы выдать пользователю "charlie" полный доступ: { charlie: ["room:write"] } Чтобы убрать существующий уровень доступа, установите значение null: { charlie: null }

update-room-id

Обновить ID комнаты Liveblocks

Параметры

newRoomIdstringобязательный
roomIdstringобязательный

update-room-subscription-settings

Обновить настройки подписки комнаты Liveblocks

Параметры

dataobjectобязательный
roomIdstringобязательный
userIdstringобязательный

Выберите клиент, чтобы установить liveblocks/liveblocks-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "liveblocks-liveblocks-mcp-server-4kux9wojou": {
      "command": "npx",
      "args": [
        "-y",
        "github:liveblocks/liveblocks-mcp-server"
      ],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "liveblocks-liveblocks-mcp-server-4kux9wojou": {
      "command": "npx",
      "args": [
        "-y",
        "github:liveblocks/liveblocks-mcp-server"
      ],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "liveblocks-liveblocks-mcp-server-4kux9wojou": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "github:liveblocks/liveblocks-mcp-server"
      ],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"liveblocks-liveblocks-mcp-server-4kux9wojou\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"github:liveblocks/liveblocks-mcp-server\"],\"env\":{\"LIVEBLOCKS_SECRET_KEY\":\"sk_xxxxxxxxxxxx\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "liveblocks-liveblocks-mcp-server-4kux9wojou": {
      "command": "npx",
      "args": [
        "-y",
        "github:liveblocks/liveblocks-mcp-server"
      ],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add liveblocks-liveblocks-mcp-server-4kux9wojou --env LIVEBLOCKS_SECRET_KEY=sk_xxxxxxxxxxxx -- npx -y github:liveblocks/liveblocks-mcp-server

Либо через JSON-конфиг:

claude mcp add-json liveblocks-liveblocks-mcp-server-4kux9wojou "{\"command\":\"npx\",\"args\":[\"-y\",\"github:liveblocks/liveblocks-mcp-server\"],\"env\":{\"LIVEBLOCKS_SECRET_KEY\":\"sk_xxxxxxxxxxxx\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add liveblocks-liveblocks-mcp-server-4kux9wojou --env LIVEBLOCKS_SECRET_KEY=sk_xxxxxxxxxxxx -- npx -y github:liveblocks/liveblocks-mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.liveblocks-liveblocks-mcp-server-4kux9wojou]
command = "npx"
args = ["-y", "github:liveblocks/liveblocks-mcp-server"]

[mcp_servers.liveblocks-liveblocks-mcp-server-4kux9wojou.env]
LIVEBLOCKS_SECRET_KEY = "sk_xxxxxxxxxxxx"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите liveblocks/liveblocks-mcp-server, а в поле команды запуска — строку ниже:

npx -y github:liveblocks/liveblocks-mcp-server

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "liveblocks-liveblocks-mcp-server-4kux9wojou": {
      "command": "npx",
      "args": [
        "-y",
        "github:liveblocks/liveblocks-mcp-server"
      ],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "liveblocks-liveblocks-mcp-server-4kux9wojou": {
      "command": "npx",
      "args": [
        "-y",
        "github:liveblocks/liveblocks-mcp-server"
      ],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например liveblocks-liveblocks-mcp-server-4kux9wojou.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: liveblocks-liveblocks-mcp-server-4kux9wojou
    command: npx
    args:
      - "-y"
      - "github:liveblocks/liveblocks-mcp-server"
    env:
      LIVEBLOCKS_SECRET_KEY: sk_xxxxxxxxxxxx

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "liveblocks-liveblocks-mcp-server-4kux9wojou": {
      "command": "npx",
      "args": [
        "-y",
        "github:liveblocks/liveblocks-mcp-server"
      ],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "github:liveblocks/liveblocks-mcp-server"
  ],
  "env": {
    "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
  }
}