@myhero/mcp-server

MCP-сервер для HERO — позволяет ИИ-инструментам, таким как Claude Desktop, Cursor, Claude Code и любому stdio MCP-клиенту, читать и записывать ваши документы, проекты и таблицы HERO.

Быстрый старт

Добавьте его в конфигурацию MCP вашего ИИ-инструмента:

{
  "mcpServers": {
    "hero": {
      "command": "npx",
      "args": ["-y", "@myhero/mcp-server"],
      "env": {
        "HERO_API_KEY": "hero_at_your_token_here"
      }
    }
  }
}

Сгенерируйте токен на app.myhero.so → Settings → MCP Tokens.

Пошаговое руководство по настройке для Claude Desktop, Cursor, Claude Code и других см. в полном руководстве на myhero.so/mcp-setup.

Что он делает

Документы

• Чтение любого документа — полное содержимое, обычный текст, метаданные или только заголовки разделов

• Поиск по всем вашим рабочим пространствам и проектам

• Создание новых документов, их переименование, перемещение, дублирование или удаление

• Создание снимков, перечисление всех блоков в документе, переход к разделу по его нумерации

• Точечное редактирование: изменение отдельного абзаца, заголовка, элемента списка или таблицы без перезаписи остального содержимого с использованием полной схемы блоков HERO.

Положения и юридическая структура

• Чтение, перечисление и редактирование положений, подпунктов и определений внутри контрактов и соглашений

• Поиск всех документов, которые ссылаются на данное положение или определенный термин

• Получение объяснения определения непосредственно из документа, которому оно принадлежит

Проекты, папки и рабочие пространства

• Перечисление ваших рабочих пространств, проектов, папок и документов внутри них

• Создание проектов, их переименование, организация документов по папкам

• Массовое перемещение или копирование документов между проектами

Таблицы

• Создание таблиц, добавление или удаление столбцов и строк, установка динамических значений.

• Чтение целых таблиц, поиск конкретных строк, столбцов или ячеек по имени

• Обновление ячеек по одной или пакетно

• Ссылка на строки из документов, чтобы документ оставался синхронизированным с таблицей

Шаблоны и плейсхолдеры

• Создание повторно используемых шаблонов документов с «живыми» плейсхолдерами, которые берут данные из ваших таблиц

• Когда базовые данные таблицы меняются, каждый документ, ссылающийся на них, обновляется автоматически

Аутентификация

Два способа аутентификации:

1. Персональный токен доступа (переменная окружения HERO_API_KEY) — рекомендуется для headless-установок.

2. OAuth-вход — пропустите переменную окружения, и мост откроет ваш браузер при первом использовании. Токены сохраняются в ~/.hero/credentials.json.

Управляйте токенами или сессиями и отзывайте их на app.myhero.so → Settings → MCP Tokens.

Переменные окружения

Исходный код

Исходный код находится на github.com/Unwynd-io/hero-mcp. Проблемы и pull-запросы приветствуются.