MCP · Streamable HTTP

Timex MCP — подключи ИИ к своему дню

Доступно начиная с Timex 1.3.0.

Что это

Timex запускает локальный MCP-сервер по Streamable HTTP. По умолчанию он выключен, привязан к 127.0.0.1:41741, если адрес не изменён, и защищён bearer-токеном.

Для клиентов, которые запускают stdio-серверы, внутри Timex.app есть мост timex-mcp. После подключения клиент видит данные, записанные Timex, включая заголовки окон и URL.

Как включить

  1. Открой Settings ▸ Integrations.
  2. Включи Enable MCP server.
  3. Скопируй токен.

Если изменить host, Timex предупредит, что сервер может стать доступен из твоей сети. Bearer-токен всё равно обязателен.

Подключение клиента

Замени YOUR_TOKEN токеном из Timex. После изменения конфигурации перезапусти клиент.

Claude Code

Добавь Timex как удалённый Streamable HTTP-сервер.

claude mcp add --transport http timex http://127.0.0.1:41741/mcp --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop

Нажми Add to Claude Desktop в Settings ▸ Integrations или добавь это в ~/Library/Application Support/Claude/claude_desktop_config.json.

{"mcpServers":{"timex":{"command":"/Applications/Timex.app/Contents/MacOS/timex-mcp"}}}

Мост читает host, port и token из настроек Timex. Переменные TIMEX_MCP_URL и TIMEX_MCP_TOKEN имеют приоритет. Если установлен Node, также можно использовать npx -y mcp-remote http://127.0.0.1:41741/mcp --header "Authorization: Bearer YOUR_TOKEN".

Codex CLI (OpenAI)

Экспортируй токен и используй CLI-команду либо добавь TOML-запись в ~/.codex/config.toml.

export TIMEX_MCP_TOKEN=YOUR_TOKEN
codex mcp add timex --url http://127.0.0.1:41741/mcp --bearer-token-env-var TIMEX_MCP_TOKEN
[mcp_servers.timex]
url = "http://127.0.0.1:41741/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }

OpenCode

Добавь этот удалённый сервер в opencode.json.

{"$schema":"https://opencode.ai/config.json","mcp":{"timex":{"type":"remote","url":"http://127.0.0.1:41741/mcp","enabled":true,"headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}

Octomind от Muvon GitHub ↗

Для Octomind с поддержкой `headers` (текущая ветка master) добавь этот HTTP-сервер и укажи его в ролях, которым он нужен.

[[mcp.servers]]
name = "timex"
type = "http"
url = "http://127.0.0.1:41741/mcp"
headers = { Authorization = "Bearer YOUR_TOKEN" }
timeout_seconds = 30

# then add "timex" to server_refs of the roles that should use it:
# [roles.mcp]
# server_refs = ["core", "timex"]
url = "http://127.0.0.1:41741/mcp?token=YOUR_TOKEN"

Для старых сборок Octomind, которые не умеют отправлять заголовки, используй запасной URL ниже. Timex принимает ?token= для клиентов без заголовков; используй его только на loopback-интерфейсе.

Cursor

Сохрани это в ~/.cursor/mcp.json.

{"mcpServers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}

Zed

Добавь эту запись сервера в настройки MCP в Zed.

{"mcpServers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}

VS Code

Сохрани это в .vscode/mcp.json. VS Code использует ключ servers вместо mcpServers.

{"servers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}

16 инструментов

get_summary

Сводка учтённого времени за период.

list_activities

Список записей активности за период.

search_activities

Поиск по приложениям, заголовкам окон и URL.

get_current_activity

Показывает, что Timex отслеживает прямо сейчас.

list_categories

Список категорий и их весов фокуса.

list_rules

Список правил для приложений, заголовков и URL.

add_rule

Создаёт правило категоризации.

remove_rule

Удаляет правило категоризации.

create_category

Создаёт категорию с весом фокуса.

update_category

Переименовывает категорию или меняет её вес.

add_manual_entry

Добавляет время, не записанное автоматически.

export_csv

Экспортирует период в CSV-файл.

pause_tracking

Приостанавливает автоматическое отслеживание.

resume_tracking

Возобновляет автоматическое отслеживание.

start_break

Запускает перерыв в Timex.

list_backups

Показывает локальные резервные копии базы Timex.

Протокол: Streamable HTTP; версии протокола 2026-07-28 / 2025-11-25 / 2025-06-18 / 2025-03-26; без состояния (без сессий); для клиентов без заголовков принимается ?token=; Origin ограничен localhost.

Примеры запросов

  • “Сколько времени ушло на Zoom на этой неделе по сравнению с прошлой?”
  • “Что я делал во вторник с 14:00 до 16:00?”
  • “Считай github.com категорией «Разработка»”
  • “Запиши сегодняшний 45-минутный звонок с клиентом в 15:00 в категорию «Коммуникация»”
  • “Экспортируй этот месяц в CSV на ~/Desktop”

Решение проблем

Timex не запущен или его MCP-сервер выключен

Открой Timex и включи сервер в Settings ▸ Integrations.

401 Unauthorized

Пересоздай или снова скопируй токен, обнови конфигурацию и перезапусти клиент.

Привязка к другому host

Токен всё равно обязателен, а ?token= по-прежнему поддерживается. В браузерах проверка Origin разрешает только localhost-источники.