mcp-altegio

mcp-altegio реализует MCP-сервер для Altenio API, позволяя управлять записями, клиентами, услугами, сотрудниками и расписанием через AI-ассистента. Сервер поддерживает стандартный транспорт stdio для локального использования и Streamable HTTP для облачных деплоев, что позволяет подключать MCP к Claude Desktop, Claude Code, Cursor и другим инструментам через локальные или удалённые каналы. Поставляется с 18 инструментами (CRUD-операции для записей и клиентов, управление услугами и сотрудниками, расписанием и финансами), умной подстановкой поиска и поддержкой как локального stdio, так и удалённого HTTP-транспорта. Пример использования включает поиск клиентов, работу с записями, бронирование услуг и получение доступных слотов, а также интеграцию через HTTP-режим для облачных деплоев.

Чтобы начать, запустите сервер через Bun (или используйте Docker) и подключитесь через выбранный транспорт. В конфигурации для Claude Desktop или других клиентов укажите соответствующий mcpServers блок, задав команду, аргументы и необходимые переменные окружения. В HTTP-транспорте сервер слушает на порту 3000 по умолчанию (можно переназначить через PORT) и предоставляет endpoint POST /mcp.

Основные команды и инструменты доступны через MCP SDK и реализованы в src/index.ts (stdio) и src/http.ts (HTTP). Используйте примеры интеграции в README для подключения через Claude Desktop/Code и другие клиенты, чтобы выполнять операции над записями, клиентами, услугами и расписанием.

prerequisites: - Bun >= 1.x или Docker

Установка локально (Bun):

1. Клонируйте репозиторий: git clone https://github.com/moro3k/mcp-altegio.git
2. Перейдите в директорию проекта: cd mcp-altegio
3. Установите зависимости через Bun: bun install
4. Настройте переменные окружения (см. раздел Конфигурация в README) и запустите сервер: bun run start

Если предпочитаете Docker:

1. Соберите образ: docker build -t mcp-altegio .
2. Запустите контейнер с необходимыми переменными окружения: docker run -e ALTEGIO_TOKEN=ваш_партнёрский_токен
   -e ALTEGIO_USER_TOKEN=ваш_пользовательский_токен
   -e ALTEGIO_COMPANY_ID=ваш_ID_компании
   -p 3000:3000
   --name mcp-altegio_runtime
   mcp-altegio bun run src/http.ts

Примечание: для локального запуска с stdio используйте Bun (или Docker) и следуйте инструкциям в разделе Быстрый старт README. Убедитесь, что у вас установлены и токены Altegio (партнёрский и пользовательский) и идентификатор компании, поскольку сервер потребует их на инициализации.

tips и рекомендации:

• Переменные ALTEGIO_TOKEN, ALTEGIO_USER_TOKEN и ALTEGIO_COMPANY_ID необходимы для аутентификации к Altegio API. Их можно передавать напрямую или через .env в cwd (для Bun транспорта).
• В режиме HTTP (Streamable HTTP) сервер запускается с командой bun run start:http или через Docker с соответствующими флагами окружения; порт по умолчанию 3000, но его можно переопределить через PORT.
• При использовании Docker обязательно укажите флаг -i (stdin) для stdio-транспорта в некоторых конфигурациях; в HTTP-транспорте это не требуется.
• Примеры подключения в README показывают форматы mcpServers для Claude Desktop, Claude Code, Cursor и HTTP-транспорта. Вы можете адаптировать их под свою среду.
• Если обновляете токены або ID компании, перезапустите MCP-сервер, чтобы изменения вступили в силу.
• Локально Bun-порт должен поддерживать TypeScript 5.7 и совместимый MCP SDK версии 1.26.