Безопасность MCP

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

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

Чтобы разобраться в переводе, сначала разрешите чтение нужной конфигурации и запросов. Для исправления согласуйте ресурс и ожидаемые изменения, прежде чем разрешать запись. Подтверждения и списки разрешённых операций в клиенте помогают соблюдать эту границу. Фраза «только чтение» в промпте не лишает учётные данные прав на запись.

Учётные данные учётной записи #

Сервер, размещённый по адресу https://mcp.lingo.dev/mcp, проверяет пользовательский токен доступа OAuth, переданный в заголовке Authorization: Bearer. Токен определяет, кто вошёл в систему. Подключение не создаёт постоянный персональный ключ API и не выбирает фиксированную организацию.

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

Размещённый сервер не принимает ключ API Lingo.dev через x-api-key или в качестве токена предъявителя.

Вызовите members_listMemberships, чтобы найти доступные пользователю организации. Затем явно передавайте ИД нужной организации каждому инструменту уровня организации в предусмотренном для этого поле. Одно подключение может давать доступ к нескольким организациям, поэтому используйте выбранный ИД на протяжении всей задачи. Инструменты уровня объекта определяют доступ по ИД ресурсов. Каждый вызов серверной части проходит проверку прав от имени пользователя. Наличие инструмента в списке не означает, что его разрешено использовать для любого ресурса.

/main предоставляет те же инструменты с аутентификацией, а /account перенаправляет аутентифицированный запрос на /main. Ни один из этих адресов не восстанавливает прежнюю модель с ключом организации. При переходе между URL размещённого сервера следуйте инструкциям по настройке подключения.

Чтобы прекратить работу с подключением, отключите его в клиенте и удалите сохранённые учётные данные. Не рассчитывайте, что удаление конфигурации клиента сразу аннулирует уже выданный токен доступа или что удаление ключа API завершит этот пользовательский сеанс. Отключение не отменяет предыдущие изменения и отправленные задания и не удаляет контент, уже переданный клиенту.

Предоставляйте только нужные для задачи права #

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

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

Прежде чем менять состав или права участников, проверьте текущий список участников и доступные роли и подтвердите нужные полномочия. members_setRole принимает userId участника, а members_remove — id записи об участии, а не адрес почты или ИД пользователя. Для изменения роли на уровне организации также нужен выбранный orgId. Следуйте текущей схеме инструмента и его требованиям к правам, а не копируйте аргументы прежней обёртки для работы с учётной записью.

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

Секреты в результатах и чтение закрытых данных #

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

Подробные данные запроса и проверки могут содержать исходный текст, переводы, контекст и материалы от проверяющих. Начните с небольшой страницы метаданных по задаче, а затем получите полный текст, нужный для исследования. Соблюдайте те же границы раскрытия данных, когда ассистент кратко излагает прочитанное или передаёт его другому инструменту.

Внешний поиск и контекст инструментов #

localization_search ищет информацию в базе знаний Lingo.dev о локализации. docs_fetch читает страницу по пути из результатов этого поиска, а не загружает данные по произвольному URL.

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

Текущие инструменты принимают необязательный параметр intent с описанием задачи пользователя. Он записывается для диагностики и не передаётся как поле тела запроса API. Аргументы и результаты инструментов тоже могут попасть в диагностические данные и историю диалога клиента. Не включайте секреты в описания задач и не рассчитывайте, что чтение не оставляет сохранённых копий.