Настройка MCP

01 Что такое TubeMine MCP

TubeMine MCP - это удалённый сервер Model Context Protocol, который позволяет вашему ИИ-ассистенту забирать комментарии YouTube прямо в чате. Базовые модели не умеют получать комментарии YouTube сами, поэтому TubeMine закрывает этот пробел и отдаёт вашей модели сырые данные. Весь анализ делает уже ваш ИИ.

02 Аутентификация

Все клиенты используют API-ключ (v1). Передавайте ключ в заголовке Authorization: Bearer в конфиге клиента или команде подключения, ровно как показано в каждом разделе настройки ниже.

Claude Code, ChatGPT и Cursor получат вход в один клик через OAuth в будущем релизе. Пока они используют тот же API-ключ, что и все остальные клиенты.

Получить и управлять ключом можно на странице Доступ для ИИ-ассистента. Там же можно обновить ключ (это отзовёт старый на всех подключённых клиентах) или отозвать отдельного клиента.

03Настройка: Claude Code

Выполните это один раз в терминале. Замените YOUR_KEY на свой API-ключ.

claude mcp add --transport http TubeMine https://tubemine.tech/api/mcp --header "Authorization: Bearer YOUR_KEY"

Вход в один клик через OAuth для этого клиента скоро появится. Сейчас используйте API-ключ.

04Настройка: ChatGPT

Выполните эти шаги в клиенте и вставьте API-ключ, когда попросит.

1. Settings > Apps > Advanced > Developer mode
2. Create app, set MCP server URL https://tubemine.tech/api/mcp
3. Choose API key auth and paste tm_sk_...

Вход в один клик через OAuth для этого клиента скоро появится. Сейчас используйте API-ключ.

05Настройка: Cursor

Добавьте запись TubeMine в файл конфигурации ниже. Замените YOUR_KEY на свой API-ключ и перезапустите клиент.

Откройте этот файл: ~/.cursor/mcp.json

{
  "mcpServers": {
    "tubemine": {
      "url": "https://tubemine.tech/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Вход в один клик через OAuth для этого клиента скоро появится. Сейчас используйте API-ключ.

06Настройка: Codex

Добавьте запись TubeMine в файл конфигурации ниже. Замените YOUR_KEY на свой API-ключ и перезапустите клиент.

Откройте этот файл: ~/.codex/config.toml

[mcp_servers.tubemine]
url = "https://tubemine.tech/api/mcp"
bearer_token_env_var = "TUBEMINE_MCP_KEY"

07Настройка: Gemini CLI

Добавьте запись TubeMine в файл конфигурации ниже. Замените YOUR_KEY на свой API-ключ и перезапустите клиент.

Откройте этот файл: ~/.gemini/settings.json

{
  "mcpServers": {
    "tubemine": {
      "httpUrl": "https://tubemine.tech/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

08Настройка: Claude Desktop

Добавьте запись TubeMine в файл конфигурации ниже. Замените YOUR_KEY на свой API-ключ и перезапустите клиент.

Откройте этот файл: claude_desktop_config.json

{
  "mcpServers": {
    "tubemine": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://tubemine.tech/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_KEY"
      ]
    }
  }
}

09Настройка: Hermes

Добавьте запись TubeMine в файл конфигурации ниже. Замените YOUR_KEY на свой API-ключ и перезапустите клиент.

Откройте этот файл: ~/.hermes/config.yaml

mcp_servers:
  tubemine:
    url: "https://tubemine.tech/api/mcp"
    headers:
      Authorization: "Bearer YOUR_KEY"

10Настройка: OpenClaw

Выполните это один раз в терминале. Замените YOUR_KEY на свой API-ключ.

openclaw mcp add TubeMine --url https://tubemine.tech/api/mcp --header "Authorization: Bearer YOUR_KEY"

11 Использование и лимиты

MCP использует ту же месячную квоту комментариев, что и веб-приложение. Это не отдельная квота. Вызов, который забирает комментарии, списывает их с вашего месячного лимита так же, как анализ в дашборде.

• Free5 000 комментариев в месяц. Достаточно, чтобы попробовать инструмент и для лёгкого использования.
• Pro100 000 комментариев в месяц для более тяжёлых регулярных задач.

Жёсткого лимита на один вызов сегодня нет. Мы просим лишь, чтобы использование оставалось в рамках fair-use, чтобы сервис был быстрым для всех.

TubeMine читает комментарии через официальный YouTube Data API, у которого есть общая дневная квота. В редкие загруженные дни эта квота может закончиться. Тогда вызов вернёт понятную ошибку с просьбой попробовать завтра. Вашей месячной квоты комментариев это не касается.

12 Решение проблем

Большинство проблем сводится к одному из этого.

• Ключ недействителен или отозванУбедитесь, что скопировали ключ целиком и что он передаётся как Authorization: Bearer YOUR_KEY. Если вы недавно обновили ключ, старый больше не работает. Обновите или создайте новый ключ на /ai-access и вставьте новый.
• Клиент не видит инструментовБольшинство клиентов читают конфиг MCP при запуске. Полностью закройте и снова откройте клиент после правки конфига, чтобы он подхватил новый сервер.
• Отсутствуют обработчики GET, POST или DELETEЭто значит, что клиент обратился не к тому адресу. Убедитесь, что URL сервера ровно https://tubemine.tech/mcp, без хвостового пути, и используется HTTP-транспорт.

Не помогло? Напишите на hello@tubemine.app с указанием клиента и ошибки, и мы поможем.