TeamMatrix MCP Server

TeamMatrix MCP Server — это Model Context Protocol сервер поверх TeamMatrix REST API. Он даёт AI-агентам структурированные инструменты для работы с командами, участниками, матрицами навыков, survey и polls без ручных HTTP-запросов.

Страница пакета: teammatrix-mcp на npm.

Что нужно заранее

Node.js 18 или новее
Валидный API key из Settings → Security

Быстрый старт через npm

Обычному пользователю не нужно собирать MCP server из исходников. Пакет можно запустить напрямую из npm:

TEAMMATRIX_API_URL=http://localhost:8001 \
TEAMMATRIX_API_KEY=sf_live_xxx \
npx -y teammatrix-mcp

Claude Code CLI

Если вы используете `claude` CLI, сервер можно зарегистрировать один раз:

claude mcp add teammatrix \
  -e TEAMMATRIX_API_URL=http://localhost:8001 \
  -e TEAMMATRIX_API_KEY=sf_live_xxx \
  -- npx -y teammatrix-mcp

После регистрации проверьте, что сервер появился в списке MCP-подключений:

/mcp

Claude Desktop

Добавьте этот блок в ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "teammatrix": {
      "command": "npx",
      "args": ["-y", "teammatrix-mcp"],
      "env": {
        "TEAMMATRIX_API_URL": "http://localhost:8001",
        "TEAMMATRIX_API_KEY": "sf_live_xxx"
      }
    }
  }
}

После сохранения перезапустите Claude Desktop. TeamMatrix tools появятся в списке доступных инструментов.

Доступные tools

Пакет открывает основные действия TeamMatrix в виде групп структурированных MCP tools.

Teams

Tool	Описание
`list_teams`	Список доступных команд с поиском, фильтрацией по статусу и пагинацией.
`get_team`	Полные данные одной команды.
`create_team`	Создание новой команды.
`update_team`	Частичное обновление названия, описания и visibility-флагов команды.
`delete_team`	Мягкое удаление команды.

Members

Tool	Описание
`list_members`	Список участников команды с фильтрами по статусу и роли лида.
`get_member`	Детали одного участника команды.
`add_member`	Добавление пользователя в команду по email, user_id или username.
`update_member`	Обновление display name, флага лида или активности участника.
`remove_member`	Удаление участника из команды как soft delete.

Matrices

Tool	Описание
`list_team_matrices`	Список шаблонов матриц навыков, назначенных команде.
`assign_matrix`	Назначение шаблона матрицы навыков команде.
`get_team_matrix`	Полная структура матрицы: группы, уровни, строки и задачи.
`update_matrix_assignment`	Изменение позиции матрицы в порядке показа для команды.
`unassign_matrix`	Удаление шаблона матрицы из команды.
`list_member_progress`	Прогресс участника по задачам навыков.
`update_task_progress`	Обновление статуса прогресса по конкретной задаче.

Surveys

Tool	Описание
`list_survey_templates`	Список доступных survey templates.
`get_survey_template`	Полная структура шаблона: блоки и вопросы.
`list_team_surveys`	Список опросов команды с фильтрацией по статусу и диапазону дат.
`create_survey`	Создание черновика survey из шаблона.
`get_survey`	Детали survey и статистика completion.
`launch_survey`	Запуск draft survey с асинхронной рассылкой приглашений.
`close_survey`	Ручное закрытие активного survey.
`reopen_survey`	Повторное открытие закрытого survey с новым deadline при необходимости.
`remind_survey`	Постановка ручного reminder для незавершивших участников.
`list_survey_participants`	Список участников и их completion status.
`get_survey_results`	Агрегированные результаты: scores, heatmap, AI summary и baseline history.

Polls

Tool	Описание
`list_poll_templates`	Список доступных poll/interview templates.
`instantiate_poll_template`	Создание черновика poll из шаблона.
`list_polls`	Список управляемых poll со статус-фильтром и пагинацией.
`create_poll`	Создание нового poll draft с нуля.
`get_poll`	Детали poll.
`update_poll`	Частичное обновление настроек poll draft.
`delete_poll`	Удаление poll draft.
`list_poll_questions`	Список вопросов внутри poll.
`add_poll_question`	Добавление вопроса типа text, scale, single или multi.
`update_poll_question`	Обновление существующего вопроса.
`delete_poll_question`	Удаление вопроса.
`list_poll_participants`	Список участников с ролями и voted status.
`add_poll_participant`	Добавление участника с voter/viewer-флагами и role label.
`remove_poll_participant`	Удаление участника из poll draft.
`launch_poll`	Запуск poll draft с асинхронной рассылкой приглашений.
`get_poll_results`	Агрегированные результаты по ролям и группам.

Users and auth

Tool	Описание
`list_users`	Поиск доступных пользователей по имени или email.
`get_current_user`	Текущая identity, связанная с API key.
`get_api_key_info`	Метаданные API key: prefix, дата создания и время последнего использования.