suprsonic-mcp

suprsonic-mcp

MCP-сервер для Suprsonic. Предоставляет любому ИИ-агенту десятки возможностей через одно подключение.

Быстрый старт

Подключитесь к размещённому серверу — ничего устанавливать не нужно:

• URL: https://suprsonic.ai/v1/mcp (Streamable HTTP)
• Заголовок: Authorization: Bearer omk_your_key (или x-api-key: omk_your_key, если клиент или шлюз использует Authorization для собственной авторизации)

Или запустите сервер на своём компьютере:

SUPRSONIC_API_KEY=omk_your_key npx -y suprsonic-mcp

Получите API-ключ на suprsonic.ai/app/api. Оба варианта предоставляют одинаковые инструменты по одинаковым ценам. Для просмотра списка инструментов ключ не нужен; вызов без действительного ключа возвращает собственную ошибку API с указанием, где получить ключ.

Пакет — suprsonic-mcp. В более ранних версиях этого README было указано @suprsonic/mcp: эта область npm принадлежит другой компании, поэтому никогда не устанавливайте этот пакет.

Размещённый сервер

Claude Code

claude mcp add --transport http suprsonic https://suprsonic.ai/v1/mcp --header "Authorization: Bearer omk_your_key"

Cursor

Добавьте в ~/.cursor/mcp.json (или в .cursor/mcp.json в проекте):

{
  "mcpServers": {
    "suprsonic": {
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer omk_your_key"
      }
    }
  }
}

VS Code

Добавьте в .vscode/mcp.json (VS Code один раз запросит ключ и сохранит его как секрет):

{
  "inputs": [
    { "type": "promptString", "id": "suprsonic-key", "description": "Suprsonic API key (omk_...)", "password": true }
  ],
  "servers": {
    "suprsonic": {
      "type": "http",
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:suprsonic-key}"
      }
    }
  }
}

Claude API (коннектор MCP)

Отправьте бета-заголовок anthropic-beta: mcp-client-2025-11-20 и добавьте в запрос Messages:

{
  "mcp_servers": [
    { "type": "url", "url": "https://suprsonic.ai/v1/mcp", "name": "suprsonic", "authorization_token": "omk_your_key" }
  ],
  "tools": [
    { "type": "mcp_toolset", "mcp_server_name": "suprsonic" }
  ]
}

OpenAI Responses API

Добавьте в tools запроса:

{
  "type": "mcp",
  "server_label": "suprsonic",
  "server_url": "https://suprsonic.ai/v1/mcp",
  "authorization": "omk_your_key",
  "require_approval": "never"
}

Smithery

Suprsonic представлен в Smithery как suprsonic. Добавьте его в свой набор инструментов Smithery и вставьте ключ, когда Smithery запросит его; Smithery передаст его размещённому серверу как x-api-key.

Локальный сервер (npx)

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "suprsonic": {
      "command": "npx",
      "args": ["-y", "suprsonic-mcp"],
      "env": {
        "SUPRSONIC_API_KEY": "omk_your_key"
      }
    }
  }
}

Та же запись работает в mcp.json Cursor.

Собственная конечная точка HTTP

Чтобы предоставлять HTTP-транспорт со своего компьютера, а не использовать размещённый сервер:

SUPRSONIC_API_KEY=omk_your_key npx -y suprsonic-mcp --http --port 3100

Затем подключитесь к http://localhost:3100/mcp.

Доступные инструменты

Кредиты списываются только за успешные вызовы. Если указана стоимость диапазоном, цена зависит от выбранного режима.

Инструмент	Назначение	Кредиты
search	Поиск в интернете с помощью SERP, синтеза ИИ или обоих вариантов	1-3
scrape	Извлечение содержимого любого URL в формате Markdown или HTML	1-5
profiles	Поиск и обогащение профессиональных профилей	3
emails	Поиск профессиональных адресов электронной почты	2
images	Создание изображений по текстовым запросам	3
tts	Преобразование текста в аудио с речью	2
stt	Транскрибация аудио в текст с временными метками	2
sound-generate	Создание звуковых эффектов и коротких музыкальных композиций по текстовым запросам (НЕ речь: для озвучивания используйте tts)	4
sms	Отправка SMS- или WhatsApp-сообщений. По умолчанию используется SMS (надёжная доставка). Для WhatsApp требуется согласие получателя: он должен написать на ваш бизнес-номер в течение последних 24 часов.	1
documents	Извлечение структурированных данных из URL или содержимого	3
companies	Обогащение данных о компании по домену	3
email-verify	Проверка, доставляется ли письмо, принимает ли адрес все сообщения или является ли он одноразовым	1
transcribe	Транскрибация аудио с разделением по говорящим и временными метками	3
invoice-parse	Извлечение структурированных данных из счетов и чеков	3
subtitle	Создание субтитров SRT/VTT из аудио или видео	2
file-convert	Преобразование документов, веб-страниц, таблиц и изображений между форматами	2
bg-remove	Удаление фона с любого изображения. Возвращает прозрачный PNG.	2
screenshot	Создание снимка отрисованной веб-страницы	1
code-execute	Выполнение кода в защищённой песочнице с предварительно настроенными средами	2
site-intel	Получение подробной информации о домене: WHOIS, DNS, SSL, технологический стек, безопасность электронной почты, хостинг	1-2
research	Многоэтапное углублённое исследование: поиск, извлечение данных, обогащение сведений о сущностях и подготовка отчёта с цитатами	10-35
video-info	Извлечение метаданных видео, доступных форматов и миниатюры из любого URL	1
video-download	Загрузка видео с любого URL и получение временной ссылки для скачивания	2-3
domains	Поиск доменных имён и подходящих для бизнеса доменных зон	1-5

Формат ответа

Каждый инструмент возвращает унифицированный объект ответа:

{
  "success": true,
  "data": {
    "results": [
      { "title": "OpenAI raises $6.6B", "url": "https://...", "snippet": "..." }
    ]
  },
  "error": null,
  "metadata": {
    "provider_used": "serperdev",
    "providers_tried": ["serperdev"],
    "response_time_ms": 1200,
    "request_id": "req_abc123"
  },
  "credits_used": 1
}

При ошибке значение success равно false, а error содержит подробности (см. ниже).

Обработка ошибок

Все ошибки имеют одинаковую структуру объекта. Если возможность недоступна, этот объект возвращается как error в приведённом выше ответе, при этом success устанавливается в false, а кредиты не списываются. При отклонении вызова (недействительный ключ, недостаточно кредитов, ограничение частоты запросов) возвращается HTTP 401, 402 или 429 с объектом в detail:

{
  "detail": {
    "type": "https://api.o-mega.ai/errors/insufficient-credits",
    "title": "Insufficient Suprsonic API credits",
    "status": 402,
    "detail": "This call needs 2 credits and your Suprsonic account has 0 left of its 200 free credits a month, which refill on November 12. This is your Suprsonic credit balance, not a provider's.",
    "is_retriable": false,
    "error_category": "billing",
    "alternative_action": "Pro gives 2,000 credits a month, 10 times the free plan: choose it at https://suprsonic.ai/app/subscription, or wait until November 12."
  }
}

Категории ошибок: transient (повтор безопасен), permanent (неверный запрос), authentication (недействительный ключ), billing (недостаточно кредитов), content_access (этот URL нельзя обслужить: он заблокирован, ограничен по региону или является приватным).

При использовании MCP ИИ-агент получает весь объект ошибки в ответе инструмента и может решить, повторять ли запрос, исходя из is_retriable и retry_after_seconds, а также сообщить вам, что предписывает alternative_action.

Полная справочная документация по API со всеми параметрами и примерами ответов: suprsonic.ai/apis