Подключить к ИИ

Подключите kinodata к Claude, Cursor или VS Code — и ассистент сам найдёт фильм, свяжет его ID во всех каталогах и откроет карточку, когда это понадобится в разговоре или в коде. Для этого у API есть MCP-сервер: он работает по открытому протоколу Model Context Protocol, через который ИИ-ассистенты вызывают внешние инструменты.

Адрес сервера:

https://api.kinodata.space/mcp

MCP-сервер есть на всех тарифах, включая Free. Ключ тот же, что для API, — из личного кабинета.

Как считаются запросы#

Каждый инструмент сервера делает обычные запросы к API v1.3 с вашим ключом. Поэтому квота, пределы и статистика в кабинете у API и MCP общие:

• большинство инструментов стоят один запрос;
• resolve_ids — по запросу на каждый ID и ещё один на всю пачку;
• get_person — два запроса: карточка и первая страница фильмографии;
• подключение и список инструментов квоту не тратят.

Предел в секунду сервер соблюдает сам: запросы аккаунта идут не чаще, чем разрешает тариф, — со всех его ключей, из одного вызова и из нескольких сразу. Поэтому resolve_ids на 50 ID на Free (10 запросов в секунду) займёт около пяти секунд, но не оборвётся на середине.

Когда квота на сутки кончается, инструмент отвечает текстом: сколько запросов было и когда квота обновится. Ассистент перескажет это сам. Пределы тарифов — на странице Ключ и лимиты.

Подключите клиент#

Сервер принимает ключ в заголовке Authorization: Bearer <ключ> или, как API, в X-API-Key. Ниже — настройки для каждого клиента; ключ в них берётся из переменной окружения KINODATA_KEY, как в Быстром старте.

Claude Code#

macOS и Linux:

claude mcp add --transport http kinodata https://api.kinodata.space/mcp --scope user --header "Authorization: Bearer $KINODATA_KEY"

Windows, 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 и добавьте сервер:

{
  "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:

{
  "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:

{
  "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 у сервера нет.

Инструменты#

Ответы компактные: пустые поля сервер не присылает, длинные списки отдаёт страницами.

Что спросить#

• «Дай ID на Кинопоиске для tt0111161, tt0068646 и tt0468569».
• «Корейские триллеры 2010-х с оценкой Кинопоиска выше 7,5».
• «Кто снял „Сталкера“ и что ещё он снял после 1970 года?»
• «Что сейчас в тренде и есть ли там аниме?»
• «Сколько сезонов и эпизодов у „Во все тяжкие“?»

Берегите ключ#

• Храните ключ в пользовательских настройках клиента или в переменной окружения. Не кладите его в mcp.json проекта, который уходит в репозиторий, и не вставляйте в чат с ассистентом.
• Ключ передаётся только в заголовке. Адрес с ключом в строке запроса сервер отклоняет.
• Описания и факты из каталогов — чужие тексты. Сервер убирает из них ссылки, картинки и HTML, но если ассистент вдруг предлагает действие «из описания фильма», не соглашайтесь.

Если не подключается#

Дальше#

• Ключ и лимиты — пределы тарифов и как следить за остатком.
• ID во всех каталогах — на этом эндпоинте работает resolve_ids.