Как подключить Connecteam к Meta Muse через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Connecteam, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Connecteam + Meta Muse

Connecteam, приложение для сотрудников без рабочего места в офисе: пользователи и пользовательские поля, табельные часы со сменами, итогами табелей и отметками прихода и ухода, смены планировщика, работы (jobs), формы и их заполнения, быстрые задачи, остатки и заявки на отсутствие и сообщения в чате. Connecteam API с API-ключом.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

CONNECTEAM_API_HOST, CONNECTEAM_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут, нужен владелец или администратор Connecteam.

1. В Connecteam откройте Settings > API Keys и нажмите Add API key. Скопируйте ключ в CONNECTEAM_API_KEY. Он даёт доступ ко всему аккаунту, поэтому обращайтесь с ним как с паролем.
2. Укажите в CONNECTEAM_API_HOST значение https://api.connecteam.com или https://api-au.connecteam.com, если вы входите через app-au.connecteam.com (австралийские аккаунты).
3. Установите коннектор: connecteam_get_account служит проверкой установки.

Для доступа к API нужен тариф Expert или выше для каждого хаба: Operations для табельных часов, планировщика, работ и задач; Communications для чата; HR & Skills для отсутствий. Пользователи, аккаунт и publishers работают с любым подходящим хабом.

Персональные данные: у пользователей есть имена, телефоны, адреса почты и пользовательские поля профиля, например день рождения, адрес или номера документов; записи времени могут содержать GPS-координаты. Запрашивайте только то, что нужно для задачи.

Сначала id: каждые табельные часы, каждый планировщик и каждая доска задач это отдельный экземпляр приложения. ИИ получает их id через connecteam_list_time_clocks, connecteam_list_schedulers и connecteam_list_task_boards, прежде чем вызывать инструменты, которым нужны timeClockId, schedulerId или taskBoardId.

Что он читает:

• Аккаунт и люди: connecteam_get_account, connecteam_list_users (фильтры по id, именам, почте, телефонам, статусу или времени изменения), connecteam_list_custom_fields, connecteam_list_custom_field_categories и connecteam_list_smart_groups.
• Табельные часы: connecteam_list_time_activities возвращает отмеченные смены, ручные перерывы и отсутствия по пользователям, не более 92 дней за вызов; connecteam_get_timesheet_totals возвращает часы по пользователю и дню с перерывами, сверхурочными, оплатой и статусами утверждения, отправки и блокировки.
• Планирование: connecteam_list_shifts (период в Unix-секундах), connecteam_get_shift, connecteam_list_shift_custom_fields и connecteam_list_user_unavailabilities.
• Работы (клиенты, объекты или проекты, к которым относят смены и отмеченное время): connecteam_list_jobs, connecteam_get_job и connecteam_list_job_custom_fields.
• Формы: connecteam_list_forms, connecteam_get_form (вопросы), connecteam_list_form_submissions и connecteam_get_form_submission со всеми ответами, включая изображения и ссылки на файлы.
• Задачи: connecteam_list_tasks и connecteam_list_task_labels.
• Отсутствия: connecteam_list_time_off_policy_types, connecteam_list_time_off_balances и connecteam_list_time_off_requests, который возвращает только утверждённые заявки, если не передать statuses.
• Чат: connecteam_list_conversations и connecteam_list_publishers.

Что он записывает:

• Табельные часы: connecteam_clock_in и connecteam_clock_out отмечают приход или уход пользователя сейчас или в заданный момент, при желании на работе или запланированной смене. connecteam_create_time_activities добавляет прошедшие смены или ручные перерывы (например, забытую отметку прихода), connecteam_update_time_activities исправляет их. Заблокированные или утверждённые дни отклоняются.
• Планирование: connecteam_create_shifts и connecteam_update_shifts; с isPublished true и notifyUsers true сотрудники видят смену и получают уведомление.
• Работы: connecteam_create_jobs (в том числе подработы с parentId) и connecteam_update_job (title обязателен).
• Задачи: connecteam_create_task и connecteam_update_task. API заменяет задачу целиком, поэтому ИИ каждый раз отправляет userIds, status и title; статус completed закрывает её.
• Отсутствия: connecteam_create_time_off_request (ожидающая или уже утверждённая заявка) и connecteam_update_time_off_request (утвердить или отклонить через status).
• Пользователи: connecteam_create_users (каждому нужны firstName, lastName, phoneNumber и userType; sendActivation отправляет SMS для активации), connecteam_update_users, connecteam_archive_users (обратимо: обновление с isArchived false) и connecteam_create_user_note.
• Чат: connecteam_send_message публикует сообщение в беседе, connecteam_send_private_message пишет одному пользователю, оба с id publisher из connecteam_list_publishers в качестве senderId. Сообщения доставляются сразу.

Отключены при установке: connecteam_delete_user, connecteam_delete_shift и connecteam_delete_task. Их действие нельзя отменить; администратор workspace включает их, когда они нужны команде. Архивирование пользователя это обратимая альтернатива.

Форматы данных: ответы имеют вид { "requestId": "...", "data": {...}, "paging": { "offset": n } }. Время смен, отметок и задач это Unix-метки в секундах с отдельным timezone по IANA; даты в фильтрах YYYY-MM-DD. Id пользователей целые числа; id смен, работ, задач и заявок строки. Пакетные записи (connecteam_create_users, connecteam_create_shifts, connecteam_create_jobs и обновления) принимают список и отвечают по каждому элементу.

Постраничный вывод: limit (по умолчанию 10; максимум зависит от инструмента, до 500) и offset. ИИ увеличивает offset на limit, пока страница не вернёт меньше элементов, чем limit.

Лимиты и частые ошибки: лимиты запросов действуют на аккаунт и тариф (Expert: 100 запросов в минуту и 10 000 в день), при превышении ответ 429. 401 или 403 означает неверный ключ, не тот адрес API (глобальный или австралийский) либо тариф или хаб без доступа к API; 404 неизвестный id; 422 ошибку валидации, поле указано в теле ответа.

Коннектор не рассчитывает зарплату, не редактирует формы и не отправляет ответы на них, не создаёт табельные часы, планировщики и доски задач.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Muse

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.

1. В Muse открой Settings → Connectors и выбери Add custom connector.
2. Вставь URL MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
4. В чате попроси Muse о том, для чего нужны инструменты Connecteam.

Настроить коннектор можно и из чата: в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.

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

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

• «Сколько часов отработал каждый сотрудник на прошлой неделе по табельным часам Склад, включая сверхурочные?»
• «Покажи открытые смены на завтра в планировщике Выездная бригада.»
• «Какие заявки на отсутствие ещё ожидают решения и какой остаток у каждого сотрудника?»
• «Выведи заполнения формы осмотра автомобиля за эту неделю с ответами.»
• «Создай на доске Магазин задачу для Daniel пополнить холодильную камеру до пятницы и опубликуй её.»

FAQ

Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде: в вебе, в приложениях для iOS и Android и в WhatsApp.

Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Microsoft Copilot