Pyrus MCP: как подключить Pyrus к Claude, Cursor и Codex

brain-boost-academy/pyrus-mcp· Проверено 12.11.2026· 0на GitHub

Подключает агента к Pyrus: читать входящие и задачи, ставить и закрывать задачи, оставлять комментарии, работать с формами, реестрами, справочниками, контактами и базой знаний.

2 реализации:

Все 41 метод Pyrus API через библиотеку pyrus-api; три режима доступа, запрещённые методы клиент даже не видит, плюс скачивание и загрузка файлов.

Как подключить

Что сделать до подключения

Python 3.14 и uv с командой uvx

Логин и секретный ключ API Pyrus

PYRUS_LOGIN / PYRUS_SECURITY_KEY

Pyrus → настройки профиля → раздел «Авторизация» → скопировать или выпустить ключ API

PYRUS_MCP_MODE

read-only (22 инструмента), non-destructive (39, по умолчанию) или full (41)

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'PYRUS_LOGIN=<email в Pyrus>' --env 'PYRUS_SECURITY_KEY=<секретный ключ>' --env PYRUS_MCP_MODE=read-only --transport stdio pyrus \
  -- uvx --from git+https://github.com/brain-boost-academy/pyrus-mcp pyrus-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.pyrus]
command = "uvx"
args = ["--from", "git+https://github.com/brain-boost-academy/pyrus-mcp", "pyrus-mcp"]

[mcp_servers.pyrus.env]
PYRUS_LOGIN = "<email в Pyrus>"
PYRUS_SECURITY_KEY = "<секретный ключ>"
PYRUS_MCP_MODE = "read-only"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "pyrus": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/brain-boost-academy/pyrus-mcp",
        "pyrus-mcp"
      ],
      "env": {
        "PYRUS_LOGIN": "<email в Pyrus>",
        "PYRUS_SECURITY_KEY": "<секретный ключ>",
        "PYRUS_MCP_MODE": "read-only"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "pyrus": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/brain-boost-academy/pyrus-mcp",
        "pyrus-mcp"
      ],
      "env": {
        "PYRUS_LOGIN": "<email в Pyrus>",
        "PYRUS_SECURITY_KEY": "<секретный ключ>",
        "PYRUS_MCP_MODE": "read-only"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "pyrus": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/brain-boost-academy/pyrus-mcp",
        "pyrus-mcp"
      ],
      "env": {
        "PYRUS_LOGIN": "<email в Pyrus>",
        "PYRUS_SECURITY_KEY": "<секретный ключ>",
        "PYRUS_MCP_MODE": "read-only"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "pyrus": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/brain-boost-academy/pyrus-mcp",
        "pyrus-mcp"
      ],
      "env": {
        "PYRUS_LOGIN": "<email в Pyrus>",
        "PYRUS_SECURITY_KEY": "<секретный ключ>",
        "PYRUS_MCP_MODE": "read-only"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "pyrus": {
        "type": "local",
        "command": [
          "uvx",
          "--from",
          "git+https://github.com/brain-boost-academy/pyrus-mcp",
          "pyrus-mcp"
        ],
        "environment": {
          "PYRUS_LOGIN": "<email в Pyrus>",
          "PYRUS_SECURITY_KEY": "<секретный ключ>",
          "PYRUS_MCP_MODE": "read-only"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "pyrus": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/brain-boost-academy/pyrus-mcp",
        "pyrus-mcp"
      ],
      "env": {
        "PYRUS_LOGIN": "<email в Pyrus>",
        "PYRUS_SECURITY_KEY": "<секретный ключ>",
        "PYRUS_MCP_MODE": "read-only"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "pyrus": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/brain-boost-academy/pyrus-mcp",
        "pyrus-mcp"
      ],
      "env": {
        "PYRUS_LOGIN": "<email в Pyrus>",
        "PYRUS_SECURITY_KEY": "<секретный ключ>",
        "PYRUS_MCP_MODE": "read-only"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_inboxчитает входящие

get_taskчитает задачу с комментариями

create_taskставит задачу

comment_taskкомментирует и меняет задачу

get_formsвыводит формы

get_registryчитает реестр формы

get_task_listчитает задачи списка

get_calendar_tasksчитает календарь

get_catalogчитает справочник

update_catalog_itemsменяет строки справочника

sync_catalogсинхронизирует справочник

get_contactsвыводит контакты

get_membersвыводит сотрудников

create_announcementпубликует объявление

get_knowledge_base_structureчитает структуру базы знаний

update_knowledge_base_entityменяет статью базы знаний

download_fileскачивает вложение

upload_fileзагружает файл

Показано 18 из 41.

Несколько аккаунтов Pyrus в одном сервере с переключением; ставится из клона, ключи лежат в accounts.json.

Как подключить

Что сделать до подключения

Python 3: склонировать репозиторий, создать .venv и выполнить pip install -r requirements.txt

Записать аккаунты в accounts.json: login и security_key для каждого, default_account — аккаунт по умолчанию

security_key

Pyrus → настройки профиля → раздел «Авторизация» → ключ API; пишется в accounts.json

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio pyrus-mcp \
  -- '<путь к pyrus_mcp>/.venv/bin/python' '<путь к pyrus_mcp>/server.py'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.pyrus-mcp]
command = "<путь к pyrus_mcp>/.venv/bin/python"
args = ["<путь к pyrus_mcp>/server.py"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "pyrus-mcp": {
      "command": "<путь к pyrus_mcp>/.venv/bin/python",
      "args": ["<путь к pyrus_mcp>/server.py"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "pyrus-mcp": {
      "type": "stdio",
      "command": "<путь к pyrus_mcp>/.venv/bin/python",
      "args": ["<путь к pyrus_mcp>/server.py"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "pyrus-mcp": {
      "command": "<путь к pyrus_mcp>/.venv/bin/python",
      "args": ["<путь к pyrus_mcp>/server.py"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "pyrus-mcp": {
      "command": "<путь к pyrus_mcp>/.venv/bin/python",
      "args": ["<путь к pyrus_mcp>/server.py"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "pyrus-mcp": {
        "type": "local",
        "command": [
          "<путь к pyrus_mcp>/.venv/bin/python",
          "<путь к pyrus_mcp>/server.py"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "pyrus-mcp": {
      "command": "<путь к pyrus_mcp>/.venv/bin/python",
      "args": ["<путь к pyrus_mcp>/server.py"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "pyrus-mcp": {
      "command": "<путь к pyrus_mcp>/.venv/bin/python",
      "args": ["<путь к pyrus_mcp>/server.py"]
    }
  }
}

Инструменты сервера

list_accountsвыводит настроенные аккаунты

get_inboxчитает входящие

get_taskчитает задачу с комментариями

create_taskставит задачу

comment_taskдобавляет комментарий

complete_taskзакрывает задачу

reopen_taskоткрывает задачу заново

get_registryчитает задачи по форме

create_form_taskсоздаёт задачу по форме

get_calendarчитает календарь

get_announcementsчитает объявления

get_catalogчитает справочник

Показано 12 из 21.

Что попросить агента

«Покажи мои входящие в Pyrus»Агент вызовет get_inbox

«Создай задачу: проверить квартальный отчёт, срок — следующая пятница»Агент вызовет create_task с текстом и сроком

«Покажи задачи по форме <номер формы>»Агент вызовет get_registry

«Отметь задачу <номер> выполненной»gdigora вызовет complete_task

Для каких задач

Показать входящие и задачи из нужного списка

Поставить задачу с ответственным и сроком

Закрыть задачу или оставить комментарий

Выгрузить задачи по форме из реестра

Обновить справочник или статью базы знаний

Скачать вложение из задачи и загрузить файл

Ограничения

У обоих серверов 0 звёзд на GitHub; gdigora последний раз обновлялся в феврале 2026 года

pyrus-mcp распространяется по PolyForm Strict 1.0.0: только некоммерческое использование, менять код и распространять его нельзя

Режим non-destructive у pyrus-mcp разрешает правку комментариев и полей, смену прав и движение по BPMN: отзыв прав у последнего администратора может закрыть доступ насовсем

pyrus-mcp сохраняет скачанные файлы во временную папку на машине сервера: если сервер в контейнере или на другом компьютере, клиент этот путь не увидит

Если не работает

download_file падает на Windows с длинным именем файла

Путь %TEMP%\pyrus-mcp-…\<id>\<имя> длиннее 260 символов: включите LongPathsEnabled.

Большие файлы заполняют память на Fedora или Arch

/tmp там лежит в оперативной памяти (tmpfs): задайте TMPDIR на папку на диске.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
pyrus-mcp (Brain Boost Academy)	Brain Boost Academy	0	локально	токен	41	5 ноября 2026
Pyrus API MCP Server (gdigora)	gdigora	0	локально	токен	21	5 февраля 2026

Частые вопросы

Какой режим доступа выбрать в pyrus-mcp?

read-only даёт 22 инструмента и только читает. non-destructive (по умолчанию) открывает запись, но блокирует удаление строк справочника, исключение из ролей и блокировку сотрудников. full добавляет delete_role и delete_knowledge_base_entity. Режим меняется только перезапуском сервера.

Где взять ключ API Pyrus?

Войдите в Pyrus, откройте настройки профиля, раздел «Авторизация», и скопируйте ключ API или выпустите новый.

Можно ли работать с несколькими аккаунтами Pyrus?

Да, у gdigora: перечислите аккаунты в accounts.json и назначьте default_account. Каждый инструмент принимает необязательный параметр account.

Можно ли использовать pyrus-mcp в компании?

Лицензия PolyForm Strict 1.0.0 разрешает только некоммерческое использование, отдельно названы благотворительные, образовательные, государственные и научные организации. Коммерческое использование, изменение кода и распространение запрещены; для другого режима нужно договариваться с правообладателем.

Работает ли сервер из России?

Серверы работают на вашем компьютере и ходят в API Pyrus по вашему логину и ключу.

Pyrus MCP: как подключить Pyrus к Claude, Cursor и Codex

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы