TimeBase — MCP-сервер для Claude Code: установка
MCP-сервер подключает ИИ-агента к TimeBase: он читает схемы и символы, просматривает сообщения и выполняет QQL-запросы.
claude mcp add --env TIMEBASE_URL=<TIMEBASE_URL> --env TIMEBASE_SERVERS=<TIMEBASE_SERVERS> --env TIMEBASE_USERNAME=<TIMEBASE_USERNAME> --env TIMEBASE_PASSWORD=<TIMEBASE_PASSWORD> --env TIMEBASE_OAUTH2_TOKEN_URL=<TIMEBASE_OAUTH2_TOKEN_URL> --transport stdio timebase -- uvx timebase-mcpЧто делает TimeBase
TimeBase даёт агенту доступ к потокам TimeBase. Через MCP можно перечислять потоки, читать их схемы и символы, просматривать сообщения, выполнять запросы на QQL и проверять состояние и активность сервера.
Сервер запускается локально как процесс stdio и подключается к TimeBase, либо разворачивается как общий HTTP-сервис для нескольких пользователей. Для локальной установки используется uvx и команда timebase-mcp.
Общий HTTP-вариант требует отдельного развёртывания сервера. Для подключения используются параметры TimeBase, включая TIMEBASE_URL, TIMEBASE_SERVERS, TIMEBASE_USERNAME, TIMEBASE_PASSWORD и TIMEBASE_OAUTH2_TOKEN_URL.
Какие задачи решает
- перечислить потоки TimeBase
- прочитать схему потока
- просмотреть символы и сообщения
- выполнить запрос QQL
- проверить состояние сервера
Примеры запросов агенту
- Перечисли потоки TimeBase и покажи схему выбранного потока.
- Просмотри несколько сообщений из потока и объясни структуру данных.
- Выполни запрос QQL к TimeBase и проверь состояние сервера.
Как установить TimeBase
Командой платформы
claude mcp add --env TIMEBASE_URL=<TIMEBASE_URL> --env TIMEBASE_SERVERS=<TIMEBASE_SERVERS> --env TIMEBASE_USERNAME=<TIMEBASE_USERNAME> --env TIMEBASE_PASSWORD=<TIMEBASE_PASSWORD> --env TIMEBASE_OAUTH2_TOKEN_URL=<TIMEBASE_OAUTH2_TOKEN_URL> --transport stdio timebase -- uvx timebase-mcpВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from timebase-mcp <команда>
Командой платформы
codex mcp add timebase --env TIMEBASE_URL=<TIMEBASE_URL> --env TIMEBASE_SERVERS=<TIMEBASE_SERVERS> --env TIMEBASE_USERNAME=<TIMEBASE_USERNAME> --env TIMEBASE_PASSWORD=<TIMEBASE_PASSWORD> --env TIMEBASE_OAUTH2_TOKEN_URL=<TIMEBASE_OAUTH2_TOKEN_URL> -- uvx timebase-mcpВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from timebase-mcp <команда>
Файл настроек
{
"mcpServers": {
"timebase": {
"command": "uvx",
"args": [
"timebase-mcp"
],
"env": {
"TIMEBASE_URL": "<TIMEBASE_URL>",
"TIMEBASE_SERVERS": "<TIMEBASE_SERVERS>",
"TIMEBASE_USERNAME": "<TIMEBASE_USERNAME>",
"TIMEBASE_PASSWORD": "<TIMEBASE_PASSWORD>",
"TIMEBASE_OAUTH2_TOKEN_URL": "<TIMEBASE_OAUTH2_TOKEN_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from timebase-mcp <команда>
Файл настроек
{
"servers": {
"timebase": {
"type": "stdio",
"command": "uvx",
"args": [
"timebase-mcp"
],
"env": {
"TIMEBASE_URL": "<TIMEBASE_URL>",
"TIMEBASE_SERVERS": "<TIMEBASE_SERVERS>",
"TIMEBASE_USERNAME": "<TIMEBASE_USERNAME>",
"TIMEBASE_PASSWORD": "<TIMEBASE_PASSWORD>",
"TIMEBASE_OAUTH2_TOKEN_URL": "<TIMEBASE_OAUTH2_TOKEN_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from timebase-mcp <команда>
Командой платформы
gemini mcp add -e TIMEBASE_URL=<TIMEBASE_URL> -e TIMEBASE_SERVERS=<TIMEBASE_SERVERS> -e TIMEBASE_USERNAME=<TIMEBASE_USERNAME> -e TIMEBASE_PASSWORD=<TIMEBASE_PASSWORD> -e TIMEBASE_OAUTH2_TOKEN_URL=<TIMEBASE_OAUTH2_TOKEN_URL> timebase uvx timebase-mcpВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from timebase-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о TimeBase
Как установить TimeBase в Claude Code?
Выполните `claude mcp add timebase-mcp -e TIMEBASE_PASSWORD=<TIMEBASE_PASSWORD> -e TIMEBASE_OAUTH2_CLIENT_SECRET=<TIMEBASE_OAUTH2_CLIENT_SECRET> -- uvx timebase-mcp`.
Что делает TimeBase?
Сервер позволяет агенту исследовать потоки TimeBase, читать схемы и символы, просматривать сообщения, выполнять QQL-запросы и проверять состояние сервера.
Можно ли подключить TimeBase к общему серверу?
Да. timebase-mcp можно развернуть как общий HTTP-сервис, к которому подключаются несколько пользователей и их агенты.
