ZeroHrs MCP-сервер

Этот публичный локальный MCP-сервер предоставляет Codex данные вошедшего пользователя ZeroHrs. Он использует ZeroHrs API и его проверки авторизации пользователей.

Инструкцию по установке, ориентированную на агентов и удобную для совместного использования, см. в INSTALL.md.

Установка в Codex

Требуется Node.js 20 или новее. Если запись zerohrs уже существует, изучите её перед заменой, затем установите публичный релиз с тегом:

codex mcp add zerohrs -- npx -y github:ZeroHrs-Org/zerohrs-mcp#v0.2.0

Задайте для этого сервера в ~/.codex/config.toml параметр default_tools_approval_mode = "writes", перезапустите Codex и вызовите инструмент login без аргументов.

Related MCP server: vibelogin-mcp

Инструменты

Инструменты только для чтения:

• search_zero

• list_meetings

• list_transcripts

• search_transcripts

• get_transcript

• list_tasks

• get_task

• get_meeting_prep

Инструменты записи, для которых Codex запрашивает одобрение:

• login

• disconnect

• create_task

• update_task

• add_meeting_prep_note

Сервер намеренно не содержит инструментов для отправки электронных писем или сообщений, планирования подключения ботов к встречам, распространения расшифровок, удаления данных или выполнения действий во внешних сервисах.

get_transcript по умолчанию возвращает сводку расшифровки. Она может содержать связанные задачи и блоки докладчиков, совпадающие с запросом, но по умолчанию никогда не загружает все реплики расшифровки.

Вход и отключение

Сервер запускается локально по STDIO. При запуске ему не требуется токен сессии.

Вызовите login без аргументов. Он вернёт кликабельный короткоживущий URL:

• http://localhost:3100

Откройте URL и выберите Войти через Google. Официальный вход Google откроется в системном браузере за пределами встроенного браузера Codex. Локальный MCP-сервер использует учётные данные Google для получения сессии ZeroHrs и проверяет возвращённую сессию через /auth/profile. Ни учётные данные Google, ни токен сессии ZeroHrs не проходят через чат Codex. URL истекает через десять минут, и прослушивание прекращается после успешного входа, истечения срока действия или отключения.

Вход через браузер включает публичный идентификатор клиента Google боевого экземпляра ZeroHrs. Администраторы могут переопределить его через ZEROHRS_GOOGLE_WEB_CLIENT_ID или GOOGLE_WEB_CLIENT_ID. При разработке репозитория он также может читать GOOGLE_WEB_CLIENT_ID из backend/control-plane/.env. Веб-клиент Google должен авторизовать http://localhost:3100 как источник JavaScript. Задавайте ZEROHRS_MCP_LOGIN_PORT только в том случае, если этот альтернативный источник localhost также авторизован.

Адрес API не задаётся через вызов инструмента. По умолчанию используется https://control-plane.zerohrs.com, и администратор может задать его через ZEROHRS_API_BASE_URL до запуска Codex, например при использовании локальной или стейджинговой управляющей плоскости.

После входа через браузер сохраняется только подтверждённый токен ZeroHrs — файл ~/.zerohs/codex-mcp-session.json с правами 0600. Сохранённая сессия становится активной сразу, без перезапуска Codex.

Вызовите disconnect, чтобы отменить ожидающий вход в браузере и удалить локальный файл с учётными данными. Он не вызывает /auth/logout, не отзывает токен и не завершает другие сессии приложения ZeroHrs. Вызов повторно безопасен.

Не добавляйте токен сессии в ~/.codex/config.toml, в зафиксированный файл .env, в чат или в историю команд. Сохранённый токен отправляется только как Authorization: Bearer <token> на заданный администратором URL ZeroHrs API. Управляющая плоскость по-прежнему отвечает за проверку прав доступа пользователя на встречи, расшифровки, задачи, контакты, заметки для тех-подготовки и брифы.

После первоначального добавления или обновления этого MCP-сервера перезапустите Codex, затем с помощью /mcp убедитесь, что сервер zerohrs и его инструменты доступны.

Состав релиза

Этот репозиторий содержит автономный публичный дистрибутив. Исполняемый бандл — dist/index.mjs; все его зависимости времени выполнения — обычные npm-пакеты.