Подключить Lokalise к Microsoft Copilot через MCP

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

Lokalise + Microsoft Copilot

Управление переводами в Lokalise через API v2: проекты с прогрессом по языкам, ключи и переводы с отметками проверки, языки, участники, задачи на перевод и проверку, экспорт файлов фоновыми процессами, комментарии, метаданные скриншотов, ветки, собственные статусы перевода и глоссарий.

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

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

LOKALISE_API_TOKEN

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

Настройка занимает около 2 минут. Нужен аккаунт Lokalise с доступом к проектам.

1. В Lokalise нажмите на фото профиля, откройте Profile settings > API tokens и создайте токен. Для читающих инструментов достаточно токена только для чтения; изменения требуют токена на чтение и запись.
2. Вставьте его в LOKALISE_API_TOKEN. Он передаётся в заголовке X-Api-Token и действует с вашими правами в каждом проекте.
3. Установите коннектор и запустите lokalise_list_projects, чтобы проверить токен.

Собственные MCP-серверы Lokalise: Lokalise также предоставляет MCP-серверы в бете (https://mcp.lokalise.com/mcp/project-management и /mcp/software-development, через OAuth или заголовок apikey). Этот коннектор работает с API v2 и вашим токеном.

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

• Проекты с типом, базовым языком и командой; с include_statistics: 1 прогресс, ключи, слова и проблемы QA по языкам. Языки проекта, все поддерживаемые Lokalise языки с ISO-кодом и формами множественного числа, собственные статусы перевода.
• Ключи с именем для каждой платформы, описанием, тегами, именами файлов, контекстом, лимитом символов и, с include_translations: 1, их текстами. Фильтры: имя ключа, тег, имя файла, платформа, без перевода, проблемы QA или архивные.
• Переводы, одна строка на ключ и язык, с фильтрами по языку, проверенным, неподтверждённым, непереведённым, проблемам QA или активной задаче.
• Участников с правами и языками, а lokalise_get_my_contributor возвращает владельца токена, от имени которого идёт запись.
• Задачи с типом, статусом, сроком, языками, исполнителями и прогрессом; файлы с числом ключей и последним импортом; комментарии по проекту или ключу; метаданные скриншотов со связанными ключами; ветки; термины глоссария с переводами, тегами и признаками.

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

• lokalise_create_keys добавляет новые строки с платформами и исходным текстом. lokalise_update_key и lokalise_bulk_update_keys меняют имена, описания, теги (merge_tags добавляет, а не заменяет), платформы, имена файлов, контекст, лимиты символов и переводы.
• lokalise_update_translation меняет один текст и его отметки «проверено», «не подтверждено» или собственный статус. Ключи с множественными формами принимают JSON-строку с формами (one, other, ...).
• lokalise_add_languages по ISO-коду; lokalise_add_contributors, который рассылает приглашения по email; lokalise_create_task для задачи translation, review или automatic_translation по части ключей и языков, назначенной пользователям или группам со сроком; lokalise_update_task, где {"close_task": true} закрывает задачу.
• lokalise_add_key_comments (вопрос переводчикам или контекст к строке), lokalise_create_branch, lokalise_create_glossary_terms (например, названия брендов, которые нельзя переводить, или запрещённые слова) и lokalise_update_glossary_terms.

Экспорт файлов: lokalise_download_files запускает экспорт в формате json, xliff, strings, xml, po, yaml и других и возвращает process_id. ИИ вызывает lokalise_get_process, пока status не станет finished, и передаёт вам zip-ссылку из details.download_url, которая через некоторое время истекает. Экспорт это POST, но проект он не меняет.

Отключён при установке: lokalise_delete_key, который удаляет ключ со всеми переводами без возможности отмены. Администратор workspace включает его, когда он нужен команде.

Идентификаторы и форматы: id проектов выглядят как 767946315e9866d013c1d0.08299127; для работы с веткой передайте <project id>:<branch name>. Id ключей, переводов, задач, языков и пользователей это числа. Языки задаются ISO-кодами, например en, de или pt_BR. Ответы со списками оборачивают элементы (projects, keys, translations, ...). Время приходит как YYYY-MM-DD HH:MM:SS (Etc/UTC) плюс Unix-..._timestamp. Признаки в фильтрах равны 0 или 1.

Постраничная выдача: limit и page; итоги приходят в заголовках x-pagination-total-count и x-pagination-page-count и показываются в _headers. Ключи и переводы также принимают pagination: cursor: ИИ передаёт значение x-pagination-next-cursor как cursor, пока оно не пропадёт. Термины глоссария листаются только через cursor.

Ограничения: 6 запросов в секунду на токен и на IP-адрес и не более 10 одновременных запросов на проект; 429 означает, что нужно замедлиться.

Частые ошибки: 401 означает неверный токен. 403 означает токен только для чтения при записи или нехватку прав в проекте. 404 означает неизвестный проект или элемент. 400 это ошибка валидации с названием поля; она же возникает, если значение X-Api-Token не является корректным токеном, например содержит пробелы или кавычки.

Коннектор не загружает файлы переводов (для этого нужен контент в base64) и скриншоты и не удаляет проекты, языки, задачи и термины глоссария.

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

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

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

• «Каков прогресс перевода проекта мобильного приложения по языкам?»
• «Какие ключи с тегом checkout ещё не переведены на немецкий и французский?»
• «Экспортируй веб-проект в JSON-файлы для de и it и дай ссылку на скачивание.»
• «Создай задачу на проверку испанских переводов ключей онбординга со сроком в следующую пятницу.»
• «Добавь «AnythingMCP» в глоссарий как название бренда, которое нельзя переводить.»

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