Зачем это нужно
В WordByWord.io встроен MCP-сервер — адрес, к которому подключаются ИИ-ассистенты для работы с вашими коллекциями и словами. Подключённый ассистент умеет создавать новые коллекции, добавлять туда слова из диалога, исправлять переводы и показывать статистику обучения.
Типичный сценарий — чтение текстов вместе с ассистентом. Например, вы отправляете ассистенту вакансию на испанском, просите перевести, а затем поручаете сохранить незнакомые слова. Ассистент сам напишет перевод на ваш язык, возьмёт пример из того же текста, укажет источник и пришлёт ссылку на готовую коллекцию. Слова окажутся в вашем аккаунте, и приложение поставит их в повторение наравне с остальными.
MCP (Model Context Protocol) — это открытый стандарт. Наш сервер работает с любыми клиентами, которые поддерживают удалённые MCP-серверы, а не только с теми, что перечислены ниже.
Адрес сервера
https://api.wordbyword.io/mcp
В ChatGPT этот адрес не понадобится — он встроен в приложение из каталога. Его указывают вручную только в клиентах, где MCP-серверы добавляют самостоятельно, например в Claude. Дальше клиент сам предлагает войти в аккаунт, запрашивает разрешения и получает список доступных действий.
Для работы нужен аккаунт WordByWord.io. MCP-сервер доступен на всех тарифах без отдельной подписки. На стороне ассистента действуют свои правила: уточните в документации клиента, на каких тарифах можно подключать приложения и пользовательские коннекторы.
Подключение к ChatGPT
WordByWord опубликован в каталоге приложений ChatGPT, поэтому настраивать вручную ничего не нужно: не понадобятся ни режим разработчика, ни адрес сервера.
- Откройте каталог приложений в ChatGPT: нажмите + в поле ввода сообщения и выберите Apps или перейдите в Settings → Apps & Connectors.
- Найдите WordByWord и нажмите Connect.
- Войдите на WordByWord.io в открывшемся окне и подтвердите доступ.
После этого приложение появится в списке приложений любого диалога. В корпоративных аккаунтах может потребоваться предварительное разрешение администратора.
Интерфейсы часто обновляются. Если пункты меню называются иначе, ищите слова «apps» или «connectors» в настройках.
Подключение к Claude
- Откройте настройки Claude и перейдите в раздел Connectors. В зависимости от версии интерфейса он находится в меню Settings или Customize. На тарифах Team и Enterprise владелец организации должен сначала добавить коннектор в общих настройках.
- Нажмите Add custom connector (добавить сторонний коннектор).
- Вставьте
https://api.wordbyword.io/mcpв поле для адреса сервера. Дополнительные поля для OAuth заполнять не нужно — сервер сам передаст клиенту все нужные данные. - Нажмите Add, а затем Connect. Откроется страница WordByWord.io, где нужно будет войти в аккаунт и разрешить доступ.
После этого инструменты WordByWord появятся в списке доступных функций Claude, и их можно будет использовать в диалогах.
Другие клиенты
Вы можете использовать любой клиент с поддержкой удалённого протокола MCP. Например, в Claude Code интеграция настраивается одной командой:
claude mcp add --transport http wordbyword https://api.wordbyword.io/mcp
Авторизация и права доступа
Коннектор не запрашивает ваш пароль от WordByWord.io. При добавлении запускается стандартный процесс OAuth: клиент перенаправляет вас на страницу авторизации нашего сервиса. Там вы входите в свой аккаунт и видите, какое именно приложение запрашивает доступ. Ассистент получит права только после вашего согласия.
Если позже вы решите переподключить того же ассистента, окно с запросом прав не появится, так как прошлое разрешение всё ещё действует. Чтобы закрыть доступ, удалите коннектор в настройках самого ассистента — это аннулирует его токен.
Ассистент видит только ваши коллекции и слова — ровно то же самое, что доступно вам на сайте. Он не может получить доступ к данным других пользователей, настройкам вашего аккаунта, информации о подписке или платёжным данным.
Что умеет ассистент
Доступно двенадцать действий. Клиенты делят их на категории по степени влияния на данные. Действия только для чтения обычно выполняются автоматически, а при попытке удалить или перезаписать информацию ассистент попросит вашего подтверждения.
| Действие | Что оно делает | Тип |
|---|---|---|
list_collections | Показывает список коллекций, количество слов в них и прогресс | только чтение |
get_vocabulary | Читает слова из одной коллекции или из всего словаря | только чтение |
search | Ищет по словарю с учётом названия коллекции, самого слова или его перевода | только чтение |
fetch | Открывает результат поиска целиком | только чтение |
get_learning_stats | Показывает текущую и рекордную серию дней, количество слов и статистику по статусам | только чтение |
get_languages | Выводит список поддерживаемых языков и их коды | только чтение |
create_collection | Создаёт новую приватную коллекцию | добавляет данные |
add_terms | Добавляет слова с переводами, примерами и источником | добавляет данные |
change_terms_status | Меняет статус изучения слов (например, отмечает их как выученные) | изменяет данные |
update_terms | Исправляет само слово, перевод или пример в уже существующих словах | перезаписывает данные |
delete_terms | Удаляет слова из коллекции | удаляет данные |
delete_collection | Удаляет коллекцию вместе со всеми словами внутри | удаляет данные |
request_feature | Отправляет разработчикам сообщение о том, какой функции не хватает | отправляет сообщение |
Статусы изучения соответствуют тем пяти, что используются в приложении: new, recognize, familiar, learned и known. Ассистент умеет менять их вручную, хотя обычно они обновляются автоматически по мере того, как вы повторяете сохранённые слова.
Удаление необратимо. Всегда проверяйте, что именно ассистент собирается удалить, прежде чем подтверждать действие.
Как формулировать запросы
Писать запросы можно на обычном языке — запоминать и указывать точные названия действий не нужно.
- «Сохрани незнакомые слова из этой статьи в мою испанскую коллекцию».
- «Создай коллекцию для немецких рабочих терминов и добавь туда эти десять слов».
- «Какие из моих итальянских слов всё ещё отмечены как новые?».
- «Исправь перевод слова Vorfahrt — там должно быть „право проезда“, а не „приоритет“».
- «Сколько дней длится моя серия занятий?».
Один запрос часто превращается сразу в несколько действий. Например, сначала ассистент найдёт нужную коллекцию, а уже потом добавит туда слова. Если вы разбираете конкретный текст или сайт, попросите ассистента указать источник, чтобы он сохранился в коллекции.