MCP-сервер (интеграции)

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Доступно для

Все планы Phrase в настоящее время предоставляются без дополнительной оплаты

MCP-сервер Phrase (сервер протокола контекста модели) подключает ИИ-ассистентов, таких как Claude, к Phrase. Он привносит языковой интеллект Phrase в эти инструменты, позволяя ассистентам работать с проектами, заданиями и переводами с использованием естественного языка. Сервер охватывает Phrase TMS, Phrase Strings и другие возможности Phrase, предоставляемые через API, и работает поверх этих отдельных продуктов, а не внутри одного из них.

Возможности

MCP-сервер привносит языковой интеллект Phrase в уже используемые ИИ-инструменты, позволяя работать с контентом, заданиями и переводами на естественном языке там, где выполняется работа. Типичные задачи включают:

Задавать вопросы о проектах и заданиях.
Устранение проблем с качеством в контенте без открытия отдельных файлов или языков.
Создание заданий или переназначение проектов.
Выполнение массовых обновлений вместо обновления по одному элементу за раз.
Создание, редактирование и удаление коннекторов Phrase TMS.

Варианты подключения

MCP-сервер поддерживает два метода подключения.

Удаленное подключение (рекомендуется)

Удаленное подключение использует вход в существующую учетную запись Phrase и не требует установки. Этот метод работает с ИИ-инструментами, поддерживающими подключение к удаленному серверу.

Доступность инструментов в подключенном ИИ-помощнике зависит от токена доступа OAuth, выданного при входе: он охватывает только те продукты Phrase, к которым у пользователя есть доступ в организации Platform, через которую установлено подключение. Если пользователь не имеет доступа к определенному продукту, например Phrase Strings, в рамках этой организации Platform, инструменты для этого продукта не будут функционировать, даже если они отображаются в списке. Например, инструмент поиска Strings может по-прежнему отображаться, но он выполняет поиск только по справочнику API Strings и не может получить доступ к данным проекта Strings.

Чтобы устранить проблему отсутствия доступа к продукту, сначала предоставьте пользователю доступ к продукту в рамках организации Platform. Затем отключите и снова подключите сервер MCP в инструменте ИИ, чтобы был выдан новый токен доступа, отражающий обновленный доступ.

Удаленное подключение проходит аутентификацию с использованием OAuth — единственного протокола аутентификации, поддерживаемого в настоящее время для этого метода. Пользовательские или сторонние инструменты для рабочих процессов, требующие аутентификации на основе заголовков вручную, в настоящее время не поддерживаются для удаленного подключения. Сюда входят токены носителя (bearer tokens), ключи API и учетные данные для взаимодействия между машинами (M2M).

Устаревшая аутентификация в VS Code

Visual Studio Code (VS Code) кэширует идентификатор клиента, зарегистрированный на MCP-сервере, привязывая его к URL-адресу сервера, а не к отображаемому имени. Если этот идентификатор клиента больше не существует на сервере Phrase, VS Code продолжает отправлять устаревший идентификатор вместо запуска новой регистрации. Это приводит к ошибке 400 Bad Request, сообщающей о несовпадении client_id и redirect_uri, вместо ожидаемого экрана согласия. Удаление и повторная установка записи сервера или ее переименование в mcp.json не очищают кэшированную регистрацию, поскольку кэш привязан к URL-адресу сервера.

Чтобы устранить эту проблему в VS Code 1.101 или более поздней версии, выполните следующие действия:

Откройте «Палитру команд» (Ctrl/Cmd+Shift+P) и выполните команду «Authentication: Remove Dynamic Authentication Providers», затем выберите сервер Phrase MCP в списке.
Откройте меню Учетные записи, найдите учетную запись, связанную с сервером Phrase, и откройте Manage Trusted MCP Servers, чтобы отозвать ее, или выйдите из этой учетной записи.
В представлении MCP или с помощью команды «MCP: List Servers» остановите и снова запустите подключение к серверу либо выполните команду «Developer: Reload Window».

Следующий вызов инструмента инициирует новую регистрацию и отображает экран согласия.

Примечание

Если эти действия не устраняют устаревшую регистрацию, удалите сохраненные данные аутентификации вручную из хранилища учетных данных операционной системы (ОС) (macOS Keychain, Диспетчер учетных данных Windows или libsecret в Linux) и из глобального хранилища VS Code. Это приведет к удалению аутентификации для всех остальных настроенных MCP-серверов.

Самостоятельно размещенное подключение (устарело)

Самостоятельно размещенное подключение работает на инфраструктуре, управляемой командой, и требует Node.js и файла конфигурации.

Начало работы

Полные инструкции по настройке для обоих вариантов подключения, включая команды для различных инструментов ИИ, можно найти в статье Developer Hub Phrase MCP Server.

После подключения ознакомьтесь с тщательно подобранным списком начальных промптов, организованных по задачам, в статье Developer Hub Server Starter Prompts.

Разрешения

При подключении владелец учетной записи выбирает уровень доступа, предоставляемый помощнику: просмотр данных, создание данных или изменение и удаление данных. Это применяется в дополнение к существующим разрешениям ролей Phrase, а не вместо них, поэтому помощник не может превышать права, уже предоставленные учетной записью.

Права, заданные ролью, и согласие на использование коннектора действуют независимо друг от друга: фактический доступ всегда определяется более строгим из этих двух ограничений. Например, пользователь с ролью «только просмотр» не может создавать, изменять или удалять данные через помощника, даже если в диалоговом окне согласия предоставлен доступ на создание либо на изменение и удаление данных.

Просматривайте или отзывайте доступ в любое время в настройках профиля Phrase на вкладке Согласия.

Существующее согласие нельзя отредактировать напрямую. Чтобы изменить уровень доступа, предоставленный помощнику, пользователь отзывает существующее согласие на вкладке «Согласия» и переподключается, снова выбирая желаемый уровень доступа в диалоговом окне согласия.

Каждый пользователь управляет своим согласием самостоятельно. Пользователь может просматривать и управлять только своим согласием; у администратора нет возможности просматривать согласия, предоставленные другими пользователями, или управлять ими.