Подарки и близкие — в разговоре с вашим AI-агентом
Подключите Gift Mate через MCP и попросите Codex или Claude Code запомнить день рождения, добавить желание или подобрать подарок по интересам близкого.
1. Создайте токен в профиле
- Войдите в Gift Mate и откройте профиль нажатием на своё имя.
- В разделе «AI-агенты» задайте название подключения, например «Codex на ноутбуке», и нажмите «Создать токен».
- Скопируйте токен. Он показывается только один раз.
Токен разрешает агенту читать и изменять ваши данные о близких и подарках. Создавайте отдельный токен для каждого подключения. Не вставляйте его в разговор с агентом или в репозиторий.
Токен действует 180 дней, истекает после 60 дней без использования и отзывается кнопкой «Отозвать» в профиле. После отзыва следующий запрос агента получит отказ.
2. Передайте токен приложению
Задайте переменную окружения GIFT_MATE_TOKEN на своём компьютере. Например, в терминале macOS или Linux:
export GIFT_MATE_TOKEN='ВСТАВЬТЕ_СВОЙ_ТОКЕН'
Запускайте Codex или Claude Code из этого же терминала. Переменная действует только в нём и запущенных из него приложениях. Для постоянной настройки используйте свой менеджер секретов; учитывайте, что введённая команда может сохраниться в истории терминала.
Адрес сервера: https://giftmate.online/api/mcp. Транспорт: Streamable HTTP. Авторизация: Authorization: Bearer <токен>.
3. Подключите Codex
Добавьте в ~/.codex/config.toml:
[mcp_servers.gift_mate]
url = "https://giftmate.online/api/mcp"
bearer_token_env_var = "GIFT_MATE_TOKEN"
Перезапустите Codex с доступной переменной GIFT_MATE_TOKEN. У приложения, запущенного из Dock или меню, может не быть переменных вашего терминала.
3. Или подключите Claude Code
Добавьте сервер в файл .mcp.json вашего проекта. Если файл уже есть, добавьте запись gift_mate в существующий объект mcpServers:
{
"mcpServers": {
"gift_mate": {
"type": "http",
"url": "https://giftmate.online/api/mcp",
"headers": {
"Authorization": "Bearer ${GIFT_MATE_TOKEN}"
}
}
}
}
Перезапустите Claude Code и проверьте подключение командой /mcp. Подтвердите использование сервера, если приложение спросит.
Эта настройка предназначена для Claude Code. Подключение через раздел коннекторов обычного чата Claude может требовать OAuth; такой вход здесь пока не поддерживается.
Что можно попросить
- «Добавь маму в близкие. Она любит керамику, день рождения — 12 мая».
- «Запиши годовщину родителей на 20 сентября как одно событие для двоих».
- «Добавь эту кофемолку в мой вишлист и отметь, что я особенно её хочу».
- «Посмотри интересы Саши и сохрани три идеи подарка».
- «Покажи желания близкого и забронируй выбранный подарок».
Доступны добавление, чтение, изменение и удаление близких, предпочтений, событий, желаний, идей и истории подарков. Можно менять название и публичность своего вишлиста, отзывать ссылку, создавать приглашения, бронировать чужие желания и снимать свои брони.
Как и на сайте, владелец вишлиста не видит, какие его желания забронированы, а близкие не видят ваши личные заметки о них. Настройки входа, уведомлений и удаление аккаунта остаются на сайте.
Если подключение не работает
- 401 / unauthorized: проверьте переменную окружения; если токен истёк или отозван, создайте новый.
- Нет инструментов: проверьте адрес с окончанием
/api/mcp, транспорт HTTP и перезапустите агент. - 404 при работе с записью: она удалена или не принадлежит вашему аккаунту. Попросите агента заново прочитать список.