Tallyfy MCP Server

Официальный сервер Model Context Protocol (MCP) для Tallyfy, платформы по управлению рабочими процессами и автоматизации. Он позволяет любому MCP‑совместимому AI‑ассистенту управлять вашими операциями: создавать и отслеживать задачи, запускать и продвигать процессы, читать и редактировать шаблоны, заполнять поля форм, управлять людьми и группами, а также выполнять поиск по вашей организации — всё через вашу собственную авторизованную учётную запись в Tallyfy.

Этот репозиторий представляет собой автоматически публикуемое, только для чтения зеркало. Канонический источник ведётся приватно компанией Tallyfy, и здесь публикуется очищенная, серверная копия на каждом продакшн‑выпуске. Пожалуйста, не открывайте pull‑запросы к этому зеркалу (их нельзя слить здесь). Для ошибок или запросов на новые функции используйте трекер задач или свяжитесь с нами (см. Поддержка). Код для размещения, развёртывания и мониторинга намеренно не входит в это зеркало.

Подключение (хостинг, рекомендуется)

Tallyfy управляет удалённым сервером. Вам не нужно ничего размещать. Укажите адрес вашего клиента MCP:

https://mcp.tallyfy.com/

Передача — это потоковый HTTP, а аутентификация осуществляется через OAuth по вашей учётной записи в Tallyfy, поэтому ассистент видит только те данные, которые разрешено видеть вошедшему в систему пользователю.

Пример конфигурации клиента

{
  "mcpServers": {
    "tallyfy": {
      "type": "streamable-http",
      "url": "https://mcp.tallyfy.com/"
    }
  }
}

Что он может делать

109 инструментов по домену Tallyfy, сгруппированных по областям:

Область	Примеры
Задачи	создавать, завершать, переназначать, комментировать и искать задачи
Процессы (исполнения)	запуск процесса из шаблона, продвижение и отслеживание шагов
Шаблоны (чек‑листы)	читать, создавать и редактировать шаблоны и их шаги
Поля форм	читать и заполнять поля форм инициации и шага
Автоматизация	просматривать и управлять автоматизированными действиями / правилами
Люди и доступ	пользователи, группы, гости, членство в организации
Организация	теги, папки, комментарии, поиск по организации
API‑резерв	чтение из любого REST‑эндпойнта Tallyfy, если у него нет отдельного инструмента

Каждый инструмент обращается к публичному API Tallyfy от имени аутентифицированного пользователя. Нет операций записи, которые вошедший в систему пользователь не мог бы выполнить напрямую в приложении Tallyfy.

Работаете пакетно или по скрипту? Этот сервер заточен под интерактивное, разговорное использование и ограничивает, сколько действий можно выполнить за один запрос. Для высоких объёмов или headless‑автоматизации (запуск процессов из CSV, экспорт каждой шаблонной на диск, циклы по нескольким организациям, одобрения CI/CD) используйте штатный tallyfy CLI. Он рассчитан на детерминированные, скриптуемые пакетные операции. Установите через brew install tallyfy/tap/tallyfy или скачайте бинарник со страницы релизов.

Запустите его у себя

Вы можете собрать и запустить сервер из этого зеркала с Docker. Начальная настройка не требуется:

cd server
docker build -t tallyfy-mcp-server .
docker run --rm -p 9000:9000 tallyfy-mcp-server
curl http://localhost:9000/health      # {"status":"healthy"}

Сервер слушает на порту 9000 и отвечает по потоковому HTTP на / (и на /mcp). Для запуска без Docker требуется Python 3.13 (pip install -r server/requirements.txt, затем uvicorn server:app из директории server/).

Чтобы настроить его, скопируйте .env.example в .env и передайте его через --env-file .env. Любое значение внутри файла является необязательным; значения по умолчанию ориентированы на продакшн‑окружение Tallyfy.

Об аутентификации

Каждый запрос MCP требует OAuth 2.1 bearer‑токен, выдаваемый Tallyfy (RS256). Сервер проверяет подпись на каждом вызове, поэтому неавторизованный клиент получает вызов с задачей аутентификации 401 и не имеет доступа к данным Tallyfy. Только /health и документы обнаружения OAuth доступны.

Ключ проверки поднимается автоматически. По умолчанию сервер читает публикуемые JWKS Tallyfy по адресу https://account.tallyfy.com/.well-known/jwks.json и автоматически обрабатывает ротацию ключей. Для фиксирования ключа локально и обхода сетевых обращений можно задать TALLYFY_PUBLIC_KEY в форме PEM‑ключа. Если ни один источник не сработает, сервер всё равно запустится и отклонит каждый токен.

В списке на

Official MCP Registry (com.tallyfy/mcp-server)
Официальный реестр MCP
Smithery
Smithery
Glama
Glama
PulseMCP
PulseMCP

Безопасность

Инструменты ограничены аутентифицированным пользователем, входные данные валидируются, а внешний API‑интерфейс разрешён (allowlisted). В этом репозитории не публикуются статические учётные данные: все секреты подаются во время выполнения через переменные окружения. Если найдёте проблему безопасности, отправляйте письмо на security@tallyfy.com вместо открытия публичного вопроса.

Поддержка

Документация по продукту: https://tallyfy.com/products/pro/integrations/mcp-server/
Помощь / Контакты: https://tallyfy.com/contact/