# Подключить к ИИ > MCP-сервер kinodata: настройки для Claude, Claude Code, Cursor и VS Code, инструменты и расход квоты. > Оглавление документации для агентов: https://kinodata.space/ru/llms.txt — вся документация одним файлом: https://kinodata.space/ru/llms-full.txt Подключите kinodata к Claude, Cursor или VS Code — и ассистент сам найдёт фильм, свяжет его ID во всех каталогах и откроет карточку, когда это понадобится в разговоре или в коде. Для этого у API есть MCP-сервер: он работает по открытому протоколу Model Context Protocol, через который ИИ-ассистенты вызывают внешние инструменты. Адрес сервера: ```text https://api.kinodata.space/mcp ``` MCP-сервер есть на всех тарифах, включая Free. Ключ тот же, что для API, — из личного кабинета. ## Как считаются запросы Каждый инструмент сервера делает обычные запросы к API v1.3 с вашим ключом. Поэтому квота, пределы и статистика в кабинете у API и MCP общие: - большинство инструментов стоят один запрос; - `resolve_ids` — по запросу на каждый ID и ещё один на всю пачку; - `get_person` — два запроса: карточка и первая страница фильмографии; - подключение и список инструментов квоту не тратят. Предел в секунду сервер соблюдает сам: запросы аккаунта идут не чаще, чем разрешает тариф, — со всех его ключей, из одного вызова и из нескольких сразу. Поэтому `resolve_ids` на 50 ID на Free (10 запросов в секунду) займёт около пяти секунд, но не оборвётся на середине. Когда квота на сутки кончается, инструмент отвечает текстом: сколько запросов было и когда квота обновится. Ассистент перескажет это сам. Пределы тарифов — на странице [Ключ и лимиты](https://kinodata.space/ru/docs/keys.md). ## Подключите клиент Сервер принимает ключ в заголовке `Authorization: Bearer <ключ>` или, как API, в `X-API-Key`. Ниже — настройки для каждого клиента; ключ в них берётся из переменной окружения `KINODATA_KEY`, как в [Быстром старте](https://kinodata.space/ru/docs/quickstart.md). ### Claude Code macOS и Linux: ```bash claude mcp add --transport http kinodata https://api.kinodata.space/mcp --scope user --header "Authorization: Bearer $KINODATA_KEY" ``` Windows, PowerShell: ```powershell claude mcp add --transport http kinodata https://api.kinodata.space/mcp --scope user --header "Authorization: Bearer $env:KINODATA_KEY" ``` Где: - `kinodata` — имя сервера в Claude Code. - `--scope user` — сервер доступен во всех ваших проектах и не попадает в файлы проекта. Проверьте подключение командой `/mcp` в Claude Code. ### Cursor Откройте файл `~/.cursor/mcp.json` и добавьте сервер: ```json { "mcpServers": { "kinodata": { "url": "https://api.kinodata.space/mcp", "headers": { "Authorization": "Bearer ${env:KINODATA_KEY}" } } } } ``` Cursor подставит ключ из переменной окружения `KINODATA_KEY`. Переменная должна быть видна самому Cursor: задайте её в системе, а не только в открытом терминале. ### VS Code Выполните команду **MCP: Open User Configuration** и добавьте в открывшийся `mcp.json`: ```json { "inputs": [ { "type": "promptString", "id": "kinodata-key", "description": "Ключ kinodata API", "password": true } ], "servers": { "kinodata": { "type": "http", "url": "https://api.kinodata.space/mcp", "headers": { "Authorization": "Bearer ${input:kinodata-key}" } } } } ``` VS Code спросит ключ при первом запуске сервера, в файле он не хранится. ### Claude В claude.ai и приложении Claude сервер подключается как свой коннектор: 1. Откройте **Customize → Connectors** и нажмите **Add custom connector**. 2. В поле адреса введите `https://api.kinodata.space/mcp`. 3. В **Authentication** выберите **No sign-in**. 4. В **Request headers** добавьте `authorization` со значением `Bearer ` и ваш ключ — целиком, со словом `Bearer` и пробелом. Раздел **Request headers** пока в бета-версии и виден не во всех аккаунтах. Если его нет, подключите сервер в Claude Code или в приложении Claude через мост `mcp-remote` (нужен Node.js). Файл `claude_desktop_config.json`: ```json { "mcpServers": { "kinodata": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.kinodata.space/mcp", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer ваш_ключ" } } } } ``` Пробелов вокруг двоеточия в `args` нет намеренно: на Windows приложение не экранирует пробелы в аргументах, и заголовок ломается. Пробел внутри `AUTH_HEADER` можно. ### ChatGPT ChatGPT пока не подключить: он не передаёт ключ в заголовке, а входа по OAuth у сервера нет. ## Инструменты | инструмент | что делает | |---|---| | `resolve_ids` | ID тайтлов во всех каталогах — до 50 ID за раз. | | `search_titles` | Фильмы и сериалы по названию на русском или английском, с опечатками. | | `get_title` | Карточка тайтла: названия, год, жанры, страны, оценки, описание, режиссёры и главные роли. | | `get_title_section` | Длинный раздел тайтла по страницам: актёры, съёмочная группа, награды, эпизоды, факты, цитаты, медиа, сайты, теги. | | `find_titles` | Тайтлы по условиям каталога: вид, жанры, страны, годы, оценка и число голосов, тег Кинориума, пресеты. | | `get_related_titles` | Похожие тайтлы и франшиза. | | `search_persons` | Актёры, режиссёры и другие люди кино по имени. | | `get_person` | Карточка человека: даты, возраст, рост, семья с полом родственников, награды по церемониям, факты, ссылки — каталоги, Википедия, Wikidata, сайт и соцсети, — и фильмография по страницам. | | `get_collection` | Подборки: их список или тайтлы одной подборки, например `daily-trending-titles` — в тренде сегодня. | Ответы компактные: пустые поля сервер не присылает, длинные списки отдаёт страницами. ## Что спросить - «Дай ID на Кинопоиске для tt0111161, tt0068646 и tt0468569». - «Корейские триллеры 2010-х с оценкой Кинопоиска выше 7,5». - «Кто снял „Сталкера“ и что ещё он снял после 1970 года?» - «Что сейчас в тренде и есть ли там аниме?» - «Сколько сезонов и эпизодов у „Во все тяжкие“?» ## Берегите ключ - Храните ключ в пользовательских настройках клиента или в переменной окружения. Не кладите его в `mcp.json` проекта, который уходит в репозиторий, и не вставляйте в чат с ассистентом. - Ключ передаётся только в заголовке. Адрес с ключом в строке запроса сервер отклоняет. - Описания и факты из каталогов — чужие тексты. Сервер убирает из них ссылки, картинки и HTML, но если ассистент вдруг предлагает действие «из описания фильма», не соглашайтесь. ## Если не подключается | ответ | когда | что делать | |---|---|---| | `401` | Ключа нет, он неверный или отозван. | Проверьте заголовок: `Authorization: Bearer` и ключ из кабинета целиком. | | `400` | Ключ передан в адресе. | Уберите его из адреса и передайте в заголовке. | | `429` | С вашего адреса за минуту пришло 30 запросов с неверным ключом. | Подождите минуту и проверьте ключ. | ## Дальше - [Ключ и лимиты](https://kinodata.space/ru/docs/keys.md) — пределы тарифов и как следить за остатком. - [ID во всех каталогах](https://kinodata.space/ru/docs/ids.md) — на этом эндпоинте работает `resolve_ids`.