time-messenger-mcp-server

MCP (Model Context Protocol) сервер для корпоративного мессенджера Time Messenger (на базе Mattermost) от Т-Банка.

Позволяет AI-ассистентам (Claude, OpenCode и др.) работать с Time Messenger: читать и отправлять сообщения, управлять тредами, искать каналы и пользователей, отслеживать непрочитанные сообщения.

Установка

Вариант 1: npx (без установки)

npx time-messenger-mcp-server

Вариант 2: глобальная установка

npm install -g time-messenger-mcp-server
time-messenger-mcp-server

Вариант 3: из исходников

git clone https://github.com/anomalyco/time-messenger-mcp-server.git
cd time-messenger-mcp-server
npm install
npm run build
node dist/index.js

Настройка

Переменные окружения

Способ 1: Personal Access Token (рекомендуется)

Personal Access Token — постоянный токен, который не истекает.

Как получить:

1. Откройте Time Messenger в браузере

2. Аватарка → Настройки аккаунта → Безопасность → Персональные токены доступа

3. Создайте токен с описанием "MCP Server"

4. Скопируйте токен (показывается только один раз!)

Способ 2: Логин и пароль

Токен сессии получается автоматически. Если включена MFA — потребуется ввести код через tool login_with_mfa.

Способ 3: OAuth2

Только для веб-приложений (требует браузерный редирект). Документация

Интеграция с AI-клиентами

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

С токеном:

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": ["-y", "time-messenger-mcp-server"],
      "env": {
        "TIME_URL": "https://your-instance.time-messenger.ru",
        "TIME_TOKEN": "your_token_here"
      }
    }
  }
}

С логином/паролем:

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": ["-y", "time-messenger-mcp-server"],
      "env": {
        "TIME_URL": "https://your-instance.time-messenger.ru",
        "TIME_LOGIN_ID": "your@email.com",
        "TIME_PASSWORD": "your_password"
      }
    }
  }
}

OpenCode

~/.config/opencode/opencode.json:

{
  "mcp": {
    "time": {
      "type": "local",
      "command": ["npx", "-y", "time-messenger-mcp-server"],
      "enabled": true,
      "environment": {
        "TIME_URL": "https://your-instance.time-messenger.ru",
        "TIME_TOKEN": "your_token_here"
      }
    }
  }
}

Любой MCP-совместимый клиент

npx time-messenger-mcp-server

Сервер использует stdio transport — стандартный для MCP.

Доступные инструменты

Аутентификация

Сообщения

Треды

Каналы

Команды

Пользователи

MFA (двухфакторная аутентификация)

Если на вашем аккаунте включена MFA:

1. При первом запросе получите ошибку: MFA verification required

2. Используйте инструмент login_with_mfa с 6-значным кодом из аутентификатора

3. После успешного ввода все инструменты будут работать до конца сессии

Разработка

# Установка зависимостей
npm install

# Сборка
npm run build

# Разработка
npm run dev

# Проверка типов
npm run typecheck

Структура проекта

src/
├── index.ts              # MCP сервер
├── client/
│   └── time-client.ts    # Time API клиент
├── tools/
│   ├── auth.ts           # MFA аутентификация
│   ├── messages.ts       # Сообщения
│   ├── threads.ts        # Треды
│   ├── channels.ts       # Каналы
│   ├── teams.ts          # Команды
│   ├── users.ts          # Пользователи
│   └── types.ts          # Типы инструментов
└── types/
    └── time-api.ts       # TypeScript типы для Time API

API документация

• Time Messenger API v4

• Time Messenger API v5

Требования

• Node.js 18+

Лицензия

MIT