Интеграции

Как подключить Tunio MCP

Пошаговая инструкция по подключению Tunio MCP в Codex/Cursor и Claude Desktop.

Tunio MCP даёт AI-ассистенту прямой доступ к вашим стримам и операциям в Tunio: можно получать текущий трек, список станций и выполнять команды через инструменты MCP.

Что понадобится

  • Установленный Node.js (вместе с npx).
  • Доступ в интернет.
  • API key из раздела cp.tunio.ai/api-keys.

Никогда не публикуйте API key в скриншотах, репозиториях и чатах. Если ключ был раскрыт, отзовите его и выпустите новый.

Подключение в Codex / Cursor

  1. Откройте настройки MCP-серверов

    Перейдите в раздел добавления или редактирования MCP Server в вашем AI-клиенте.

  2. Укажите команду запуска

    В поле команды укажите npx, а аргументы добавьте по одному, отдельными строками:

    BASH
    -y
    mcp-remote
    https://agent.tunio.ai/mcp
    --header
    Authorization: Bearer YOUR_API_KEY
  3. Сохраните и обновите список инструментов

    Сохраните конфигурацию MCP и перезапустите клиент (или обновите список tools), чтобы появились инструменты Tunio.

Подключение в Claude Desktop

Схема подключения такая же, как в Codex/Cursor.

  1. Добавьте новый MCP Server

    Откройте раздел MCP в Claude Desktop и создайте новый сервер.

  2. Заполните команду и аргументы

    Укажите те же параметры:

    BASH
    command: npx
    args:
      - -y
      - mcp-remote
      - https://agent.tunio.ai/mcp
      - --header
      - Authorization: Bearer YOUR_API_KEY
  3. Перезапустите Claude Desktop

    После сохранения конфигурации перезапустите приложение и проверьте, что инструменты Tunio появились в списке.

Проверка, что всё работает

После подключения выполните любой простой вызов, например list_stations или get_user_context.

Если инструменты не появились:

  • Проверьте, что npx доступен в системе.
  • Проверьте корректность API key.
  • Убедитесь, что аргументы добавлены отдельными элементами, а не одной строкой.
  • Перезапустите AI-клиент.

Если тестовый вызов возвращает данные (например, список стримов), значит Tunio MCP подключён корректно.