Подключи MOCO MCP-сервер к Microsoft Copilot

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

MOCO + Microsoft Copilot

Дайте ИИ работать с вашим аккаунтом MOCO: находить проекты и клиентов, смотреть учтённое время по сотрудникам и проектам, проверять неоплаченные счета и загрузку команды, а также записывать время. Нужны поддомен MOCO и API-ключ из вашего профиля в MOCO.

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

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

MOCO_SUBDOMAIN, MOCO_API_KEY

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

1. В MOCO нажмите на свою фотографию профиля справа вверху, откройте в профиле вкладку Integrations и скопируйте личный API-ключ. Ему доступно ровно то, что может видеть и делать ваш пользователь MOCO.
2. Либо создайте ключ аккаунта в Settings → Extensions → API & Webhooks → API Keys с доступом только на чтение или полным доступом. Ключ только для чтения не может записывать время.
3. Вставьте ключ в MOCO_API_KEY.
4. Укажите в MOCO_SUBDOMAIN только первую часть адреса MOCO: для agency.mocoapp.com введите agency, без https:// и без .mocoapp.com. Тогда коннектор будет обращаться к https://agency.mocoapp.com/api/v1.
5. Установите коннектор. Шага Authorize with Provider нет: ключ хранится в зашифрованном виде и отправляется с каждым запросом.
6. Начните с moco_list_users: если он покажет ваших коллег с их ID, ключ и поддомен указаны верно.

Как не потерять авторизацию: коннектор использует ключ напрямую, так что входить заново не нужно. Если ключ в MOCO заменили или удалили, вставьте новый в MOCO_API_KEY.

Что видит ИИ: каждый список возвращает только те записи, которые доступны пользователю ключа. Если кажется, что проект или счёт пропал, дело обычно в правах доступа в MOCO, а не в коннекторе.

Запись времени: moco_create_activity единственный инструмент, который пишет в MOCO. Он создаёт одну запись времени для пользователя, которому принадлежит ключ: дата, ID проекта, ID задачи, длительность в целых секундах (2 часа это 7200) и необязательное описание. Проект ИИ находит через moco_list_projects, его задачи через moco_get_project. Каждый вызов создаёт новую запись, а повторный вызов запишет время дважды, поэтому ИИ сначала показывает дату, проект, задачу и длительность и ждёт вашего подтверждения.

Разрешения и режим только для чтения: чтобы коннектор только читал данные, отключите moco_create_activity на странице коннектора или используйте ключ аккаунта с доступом только на чтение. Не давайте ключ с полным доступом тем, кто должен только читать данные.

Отчёты и счета: moco_list_activities и moco_report_utilization всегда требуют дату начала и дату окончания (from и to, в формате YYYY-MM-DD). Записи времени можно ограничить одним сотрудником, одним проектом или только оплачиваемым временем; отчёт о загрузке сравнивает доступную и забронированную мощность команды. moco_list_invoices фильтрует по статусу (draft, created, sent, partially_paid, paid, overdue, ignored, можно несколько через запятую), дате счёта и компании.

Ограничения: списки отдают до 100 записей на страницу, и ИИ листает дальше до последней. На стандартных тарифах MOCO допускает около 120 запросов за две минуты; сверх этого приходит 429, тогда подождите немного и повторите.

Частые ошибки: 401 означает, что ключ неверный, удалён или относится к другому аккаунту MOCO, чем MOCO_SUBDOMAIN. Если не проходит ни один вызов, проверьте, что в MOCO_SUBDOMAIN указан только поддомен, а не полный адрес. 404 для отдельного проекта означает, что ID неверный или пользователь ключа не видит этот проект. Отклонённая запись времени называет поле, которое MOCO не принял, например задачу, которая не относится к проекту.

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

Шаг 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 — Добавьте коннектор в Microsoft Copilot

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

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты MOCO.
6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

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

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

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

• «Сколько часов команда записала на проект Website Relaunch в сентябре и сколько из них оплачиваемые?»
• «Какие счета сейчас просрочены или оплачены частично и каким клиентам они принадлежат?»
• «Какой была загрузка команды в прошлом месяце? Сравни доступную и забронированную мощность.»
• «Запиши сегодня 2,5 часа на проект сайта Acme за ревью макета главной страницы. Покажи мне запись, прежде чем её создавать.»

FAQ

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

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

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