Настройка подключения MCP
Подключитесь к инструментам учётной записи через аутентификацию, затем проверьте организацию и список инструментов.
Подключите ассистента к своей учётной записи Lingo.dev, затем проверьте, что выбрана нужная организация, с помощью запроса на чтение. Сервер действует от имени пользователя, вошедшего в Lingo.dev.
Подключение к учётной записи #
Укажите https://mcp.lingo.dev/mcp как URL удалённого сервера и выберите Streamable HTTP с OAuth. Запустите авторизацию в клиенте, войдите в нужную учётную запись Lingo.dev и разрешите подключение. Клиент находит сервер авторизации через конечную точку MCP и управляет учётными данными для доступа и его обновления.
Запрос MCP передаёт токен доступа пользователя в Authorization: Bearer <access-token>. Этот токен — не постоянный персональный ключ API. Он не привязан к одной организации. Серверная часть проверяет доступ пользователя к ресурсам, которые указывает каждый инструмент. Подробнее об этих полномочиях и работе с учётными данными — в разделе Учётные данные учётной записи.
Ключ API в x-api-key или в качестве значения bearer не позволяет пройти аутентификацию на этом размещённом сервере. Используйте клиент с поддержкой подключения через OAuth, а не копируйте ключ API в статический заголовок.
Ниже собраны параметры подключения. Эта таблица — не файл конфигурации для конкретного клиента:
{
"endpoint": "https://mcp.lingo.dev/mcp",
"transport": "Streamable HTTP",
"authentication": "OAuth user session"
}Сопоставьте эти значения с полями, которые поддерживает ваш клиент. Хранение учётных данных и синтаксис конфигурации зависят от версии. Конечная точка принимает MCP-запросы POST. Без действительного токена она возвращает 401 с метаданными для обнаружения OAuth. Запрос GET с аутентификацией возвращает 405 Method Not Allowed. Открытие URL в браузере не проверяет инициализированное подключение MCP.
Существующие URL размещённого сервера #
https://mcp.lingo.dev/main предоставляет те же инструменты с теми же полномочиями пользователя. Процесс обнаружения OAuth отличается от /mcp, поэтому для работающего подключения /main можно сохранить текущие настройки авторизации. При переходе на /mcp добавьте его как новое подключение и пройдите авторизацию OAuth для этого URL. Не используйте сохранённые настройки авторизации старого подключения с новым URL.
Прежний адрес https://mcp.lingo.dev/account возвращает 401, пока не получит действительный токен пользователя. Затем он возвращает 308 с перенаправлением на /main, сохраняя метод и тело запроса. Это перенаправление не восстанавливает аутентификацию по ключу API или прежний каталог инструментов, привязанный к организации. Если вы переносите подключение, в котором хранился ключ API, подключитесь заново через OAuth.
Завершите настройку новой организации #
При подключении с новой учётной записью нужно указать название организации в веб-приложении. Затем создателю организации нужно пройти там ещё три шага: подключить интеграции, добавить коллег и создать первый движок, который веб-приложение заполняет по данным сайта организации. Шаги с интеграциями и коллегами можно пропустить. Пока все три шага не пройдены, каждый инструмент, указывающий эту организацию, возвращает ошибку со списком оставшихся шагов и ссылкой на https://lingo.dev/orgs/<orgId>. Ссылка открывает шаг, на котором находится создатель организации. members_listMemberships по-прежнему показывает организацию, поэтому ассистент может найти её ИД.
Откройте ссылку, завершите настройку и повторите вызов. После этого ассистент работает как обычно и может создавать дополнительные движки с помощью engines_create или provisioningJobs_create. Эти требования не затрагивают приглашённых участников и организации, созданные до появления такой настройки.
Проверьте область доступа учётной записи #
- Откройте список инструментов клиента и найдите
members_listMembershipsиengines_list. - Вызовите
members_listMemberships, чтобы получить список организаций пользователя. Если организация одна, используйте её. Если их несколько, выберите нужную и сохраните её ИД для этой задачи. - Вызовите
engines_listсorgIdэтой организации, затем выберите ИД движка из возвращённогоdata. - Перед использованием каждого выбранного инструмента изучите его заявленную схему. Инструментам уровня организации нужно явно передать поле организации. Инструменты уровня объекта могут вместо него принимать ИД ресурса. Вносите изменения только в согласованных рамках задачи.
Для переключения между организациями из одного списка членства новое подключение OAuth не требуется. Передайте выбранный ИД в поле, указанное в схеме инструмента, например orgId или id организации. Сервер не подставляет фиксированную организацию из токена. Если вход выполнен не в ту учётную запись, подключитесь заново через настройки учётных записей в клиенте.
members_listMemberships #
Для этого вызова ИД организации не нужен. Необязательный параметр intent описывает задачу:
{
"intent": "Find the organization whose French translation guidance I should inspect."
}data в ответе содержит доступные организации с их ИД и названиями. Необязательные записи ssoRequired указывают на членство в организациях, для которых нужен вход через SSO, ещё не выполненный в этом сеансе. Войдите в Lingo.dev через поставщика удостоверений этой организации, затем подключитесь заново. Организация из ssoRequired пока недоступна для обычных вызовов уровня организации.
Если оба списка пусты, откройте https://lingo.dev/orgs/start, чтобы настроить первую организацию, затем повторите этот запрос на чтение. Не придумывайте ИД организации и не создавайте вторую организацию только потому, что для доступа к существующей нужен вход через SSO.
engines_list #
Замените org_example на ИД из ответа со списком членства в организациях:
{
"orgId": "org_example",
"intent": "Find the localization engine used for French translations."
}Для последующих запросов на чтение на уровне движка используйте ИД движка из возвращённого data. Это полные аргументы инструмента, а не обёртки тела HTTP-запроса. Наряду с полями конкретной операции инструменты используют необязательный параметр intent. Об операциях с учётной записью см. раздел Возможности.
Где настроить подключение в разных клиентах #
Синтаксис конфигурации и поддерживаемые транспорты смотрите в актуальной документации клиента. Этот выбор важен, даже если два клиента используют одну конечную точку.
Claude Code #
Выберите для /mcp удалённое HTTP-подключение с OAuth. Перед сохранением решите, где хранить подключение: в вашей пользовательской конфигурации или в проекте. Общие настройки проекта не должны содержать учётные данные. Каждому пользователю нужно авторизовать подключение к своей учётной записи. После включения проверьте список инструментов.
Codex #
Codex использует конфигурацию TOML, обычно в ~/.codex/config.toml. Настройте URL учётной записи через средства подключения к удалённому MCP, доступные в вашей версии. Не переносите JSON из другого клиента в TOML. Если вашей версии нужен транспортный мост, перед использованием проверьте, как он выполняет аутентификацию и хранит токены. Мост — ещё один процесс с доступом к учётным данным.
Cursor #
Выберите, где настроить подключение: в настройках пользователя или в файле проекта .cursor/mcp.json. Подключение на уровне проекта позволяет коллегам найти описание сервера, но не должно давать им доступ к самому ключу учётной записи. Каждому пользователю нужно авторизовать подключение к своей учётной записи.
Claude Desktop и claude.ai #
Lingo.dev есть в каталоге коннекторов Claude, поэтому URL или файл конфигурации не нужны. В Claude Desktop и на claude.ai шаги одинаковые:
- В разделе Настройки откройте Настройка под себя, затем Обзор.
- Найдите
Lingo.devи выберите Подключить у коннектора Lingo.dev. - На странице Авторизация в Lingo.dev войдите в нужную учётную запись и выберите Разрешить.
Claude хранит и обновляет учётные данные. После подключения проверьте список инструментов.
ChatGPT #
Доступность удалённых пользовательских приложений и поддержка OAuth зависят от учётной записи и версии клиента. Если эти возможности доступны, используйте URL /mcp и пройдите авторизацию с нужной учётной записью Lingo.dev.
Дайте агенту первую задачу с чёткими границами #
Первый запрос может быть таким:
Изучи французский глоссарий и инструкции выбранного движка локализации. Объясни, какие ресурсы подключены и охватывают ли они указанный мной термин продукта. Сначала предложи изменения и только потом вноси их. Эта задача не даёт разрешения на перевод, генерацию предложений, создание ключей или управление участниками.
Дополните инструкцию подтверждением действий на стороне клиента или подходящим списком разрешённых инструментов. Промпт задаёт рамки работы, но не отменяет права на запись, которые дают учётные данные.
Если не удалось обнаружить инструменты или выполнить первый запрос на чтение, сначала решите проблему с помощью раздела Устранение неполадок.