tasqr-mcp (Node)

Сервер MCP Tasqr — управление состоянием задач для ИИ-агентов.

Работает как локальный процесс stdio, который читает ваш API-ключ из ~/.config/tasqr/credentials и проксирует вызовы инструментов на сервер Tasqr Lambda MCP. В конфиге вашего MCP-клиента нет секретов — API-ключ хранится только в файле учётных данных (с правами 0600 на Mac/Linux; на Windows он полагается на ACL вашего профильного каталога).

Установка

Требуется Node 22 или новее.

npx tasqr-mcp        # run once without installing
# or
npm install -g tasqr-mcp

Related MCP server: pith

Конфигурация MCP-клиента

{
  "mcpServers": {
    "tasqr": {
      "command": "npx",
      "args": ["tasqr-mcp"]
    }
  }
}

Учётные данные

Первый запуск — настройка не требуется. Запустите прокси один раз в терминале:

npx tasqr-mcp

Если на диске нет API-ключа, запускается регистрация через GitHub device-flow: открывается браузер на GitHub, код устройства копируется в буфер обмена для вставки, и (если у вашей учётной записи несколько рабочих пространств) запрашивается выбор нужного. Затем файл учётных данных создаётся автоматически. Ручные шаги ниже нужны только в том случае, если вы хотите создать его самостоятельно.

Ваш MCP-клиент никогда не видит секрет — он просто запускает npx tasqr-mcp, а ключ читается из:

~/.config/tasqr/credentials   (Mac/Linux)
%APPDATA%\tasqr\credentials   (Windows)

[default]
api_key = tasqr_abc123...

На Mac/Linux файл записывается с правами 0600 (чтение/запись только владельцем); на Windows он наследует ACL вашего профильного каталога. Зарегистрируйтесь на tasqr.ai, если предпочитаете получить ключ через веб-интерфейс.

Поскольку регистрация интерактивна, она запускается только когда stdin является TTY. MCP-клиент, запускающий прокси без ключа в фоновом режиме, завершится и сообщит, что сначала нужно выполнить npx tasqr-mcp в терминале.

Журналирование

Журналирование по умолчанию выключено — ничего не записывается на диск, пока вы его не включите. При включении прокси ведёт журнал событий в формате JSON-lines с добавлением только метаданных: имена инструментов и полей, но никогда содержимое задач и ключевой материал.

Включите его в файле учётных данных:

[default]
api_key   = tasqr_abc123...
log_level = info                        # off (default) | info | debug
log_path  = ~/.config/tasqr/tasqr-mcp.log

Ротации и ограничения размера нет, поэтому debug предназначен для устранения неполадок, а не для постоянного использования.

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

Переменные окружения имеют приоритет над файлом учётных данных, который, в свою очередь, имеет приоритет над значениями по умолчанию.

Шифрование на стороне клиента (BYOK)

Шифрует поля задач (название, описание, метаданные, результат, заметка) локально до того, как они попадут на серверы Tasqr. Требуется ключ AWS KMS, которым вы управляете.

AWS SDK уже включён. @aws-sdk/client-kms и @aws-sdk/credential-providers поставляются как опциональные зависимости, которые npm устанавливает по умолчанию — обычный npx tasqr-mcp или npm install -g tasqr-mcp содержит всё необходимое для BYOK. Только установка с --omit=optional лишена их; переустановите без этого флага, чтобы использовать BYOK.

Добавьте в файл учётных данных:

[default]
api_key      = tasqr_abc123...
kms_key_id   = arn:aws:kms:us-east-1:123456789012:key/your-key-id
aws_profile  = default

Ваша организация Tasqr должна быть включена в клиентский BYOK. При запуске прокси запрашивает у сервера, какой режим использует ваша организация. Если организация управляется сервером, прокси отказывается запускаться, а не шифрует — в противном случае сервер зашифровал бы ваш шифротекст повторно, сделав данные нечитаемыми для панели управления, REST API и любого другого агента, а также невосстановимыми при потере ключа KMS. В сообщении об ошибке указано, какой профиль нужно исправить.

После включения прокси получает или генерирует ключ шифрования данных (DEK), оборачивает его с помощью KMS и сохраняет обёрнутый ключ в API Tasqr. При последующих запусках кэшированный DEK разворачивается одним вызовом KMS. Всё шифрование AES-256-GCM происходит в памяти — открытый DEK никогда не покидает процесс.

Каждый шифротекст дополнительно привязан к своему контексту: ассоциированные данные GCM связывают каждое зашифрованное значение с вашей организацией, её задачей и полем, для которого оно было записано. Блоб, перемещённый в любое другое место — другое поле, задачу или организацию — полностью не расшифровывается, а не расшифровывается в неправильном месте. Чтобы это стало возможным, прокси сам создаёт идентификатор каждой новой задачи и отправляет его вместе с вызовом создания.

Полное руководство по настройке см. в руководстве по клиентскому шифрованию.

Локальная разработка

npm install
npm test
node bin/tasqr-mcp.js --version