@treebeam/mcp

MCP-сервер (Model Context Protocol) для TreeBeam — платформы финансового управления и бухгалтерского учета. Этот сервер позволяет ИИ-ассистентам взаимодействовать с вашими организациями и проектами в TreeBeam через любой MCP-совместимый клиент.

Предварительные требования

• Node.js версии 18 или выше — Как установить Node.js

• Git (требуется только при установке из исходного кода) — Как установить Git

• Claude Code (если используется в качестве ИИ-ассистента) — Как установить Claude Code

• Учетная запись TreeBeam — зарегистрируйтесь на treebeam.com

Впервые работаете с этими инструментами? Каждая ссылка выше ведет на простое руководство, которое пошагово поможет вам выполнить установку.

Related MCP server: freee Accounting MCP Server

Установка

npm (рекомендуется)

npm install -g @treebeam/mcp

Из исходного кода

git clone https://github.com/treebeam-code/tb-mcpserver.git
cd tb-mcpserver
npm install

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

Сервер использует поток устройства (device flow) OAuth 2.0 для аутентификации. Токены безопасно хранятся в связке ключей вашей ОС (macOS Keychain, Windows Credential Vault или Linux Secret Service). После аутентификации токены кэшируются и обновляются автоматически.

В вашем ИИ-ассистенте (рекомендуется)

Самый простой способ аутентификации — непосредственно во время диалога с ИИ. Просто попросите ассистента войти в TreeBeam — он использует инструмент treebeam_login для запуска потока устройства, предоставит вам ссылку и выполнит остальное автоматически. Команды терминала не требуются.

Вы также можете в любой момент попросить ассистента проверить статус вашей аутентификации или выйти из системы, используя инструменты treebeam_auth_status и treebeam_logout.

Командная строка (альтернатива)

Если вы предпочитаете проходить аутентификацию вне ИИ-клиента, вы можете использовать CLI напрямую:

treebeam-mcp login       # Opens browser to complete sign-in
treebeam-mcp status      # Check current auth status
treebeam-mcp logout      # Remove stored credentials

При запуске из исходного кода замените treebeam-mcp на npm run в приведенных выше командах.

Настройка клиента

Добавьте MCP-сервер TreeBeam в файл конфигурации вашего клиента. Структура JSON одинакова для всех клиентов — различается только расположение файла.

Расположение файлов конфигурации:

При глобальной установке через npm:

{
  "mcpServers": {
    "treebeam": {
      "command": "treebeam-mcp"
    }
  }
}

При запуске из исходного кода:

{
  "mcpServers": {
    "treebeam": {
      "command": "node",
      "args": ["/absolute/path/to/tb-mcpserver/src/index.js"]
    }
  }
}

Другие MCP-клиенты

Любой MCP-совместимый клиент может использовать этот сервер. Настройте его как транспорт stdio — клиент запускает процесс и обменивается данными через stdin/stdout.

Доступные инструменты

После подключения вашему ИИ-ассистенту станут доступны следующие инструменты. Вот некоторые из них:

Сервер предоставляет в общей сложности 47 инструментов, охватывающих полные операции CRUD для сущностей, счетов, групп счетов, периодов, невыверенных балансов, корректировок и позиций корректировок. Каждый ресурс поддерживает операции search_*, get_*, create_*, update_* и delete_*. Полный список см. в src/tool.js.

Аутентификация выполняется автоматически — если срок действия вашего токена истекает во время сеанса, сервер инициирует повторную аутентификацию через поток устройства.

Устранение неполадок

Ошибки "Not authenticated" (Не аутентифицирован)

Запустите treebeam-mcp login (или npm run login из исходного кода) для повторной аутентификации. Если проблема сохраняется, сначала запустите treebeam-mcp logout, чтобы очистить устаревшие учетные данные, а затем войдите снова.

Проблемы с доступом к связке ключей

Сервер использует keytar для хранения в связке ключей ОС. В Linux убедитесь, что установлен libsecret:

# Debian/Ubuntu
sudo apt install libsecret-1-dev

# Fedora
sudo dnf install libsecret-devel

Версия Node.js

Убедитесь, что вы используете Node.js 18+:

node --version

Лицензия

Apache License 2.0 — Copyright 2026 TNS Solutions, Inc.