Как подключить Zenkit к Microsoft Copilot через MCP

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

Zenkit + Microsoft Copilot

Подключите ИИ к Zenkit: просмотр рабочих пространств и коллекций, чтение полей, записей, участников и активности, поиск по всему аккаунту, а после вашего подтверждения создание и изменение записей и публикация комментариев.

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

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

ZENKIT_API_KEY

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

Настройка занимает около 2 минут, нужен только ваш аккаунт Zenkit.

1. В Zenkit нажмите на свой аватар, чтобы открыть профиль, и перейдите в Integrations.
2. В разделе API Key создайте новый ключ и скопируйте его.
3. Вставьте его в ZENKIT_API_KEY как есть, без пробелов и без названия заголовка.
4. Установите коннектор и запустите zenkit_get_current_user: он покажет пользователя, которому принадлежит ключ.

Ключ действует от вашего имени: он открывает всё, что можете открыть вы, во всех рабочих пространствах. Новый ключ делает старый недействительным, поэтому коннектор перестанет работать, пока вы не вставите новый. Если ИИ должен видеть только часть пространств, используйте отдельного пользователя Zenkit, который состоит только в них.

Один API для всех приложений Zenkit: Zenkit Base, Zenkit To Do, Zenkit Projects и Hypernotes работают с одними и теми же данными, поэтому один ключ открывает и списки дел, и проектные доски, и базы данных.

Как устроен Zenkit: рабочее пространство содержит коллекции (в API они называются списками), а у коллекции есть поля и записи. В зависимости от вида запись выглядит как задача, карточка, строка или заметка. ИИ начинает с zenkit_list_workspaces_with_lists, читает поля коллекции через zenkit_list_fields, а затем листает записи по 50 штук или ищет по тексту во всём, что вам доступно.

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

Спрашивает перед каждым изменением: zenkit_create_entry добавляет запись, zenkit_update_entry меняет значения полей (для меток, исполнителей и связанных записей можно заменить, добавить или убрать значения), а zenkit_comment_on_entry публикует комментарий от вашего имени. Это общие данные, и подписчики записи могут получить уведомление, поэтому ИИ показывает, что изменится, и ждёт вашего согласия. Поля с формулами и поля даты создания и изменения доступны только для чтения.

Отключено при установке: zenkit_archive_entries. Он переносит записи в архив, откуда их можно восстановить в приложении Zenkit. Администратор может включить его осознанно. Ни один инструмент ничего не удаляет окончательно.

Ограничения: Zenkit допускает 200 запросов в минуту на пользователя и 500 в минуту на IP-адрес. ИИ предпочитает одну отфильтрованную страницу множеству отдельных запросов, а ошибка D2 (Limit reached) означает, что нужно подождать минуту и повторить.

Частые ошибки: 401 означает, что ключ неверный или его заменил более новый. 403 означает, что у вас нет доступа к этому пространству или коллекции. 404 означает неизвестный ID. C21 означает, что Zenkit не принимает параметр или значение, обычно ключ поля, которого в этой коллекции нет.

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

Шаг 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 агента: попроси о том, для чего нужны инструменты Zenkit.
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 не подойдёт.

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

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

• «Какие открытые задачи в коллекции Marketing нужно закрыть на этой неделе и кто за них отвечает?»
• «Переведи задачу Обновить страницу цен в статус Готово и добавь метку Сайт. Сначала покажи изменение.»
• «Создай запись в коллекции Bugs: кнопка оформления заказа не работает в Safari, приоритет Высокий, исполнитель Лиза.»
• «Найди во всех моих пространствах Zenkit записи, где упоминается проект Иванова.»
• «Что изменилось за последние 7 дней в коллекции Product Roadmap и кто что прокомментировал?»

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