MCP-сервер и инструменты

Помимо Chat Completions, AgentHere предоставляет MCP-сервер (Model Context Protocol) с набором инструментов: анализ изображений и видео, OCR и транскрибация аудио, генерация изображений и видео, веб-поиск и чтение страниц. Его можно подключить к Claude Desktop, Cursor и любому клиенту с поддержкой MCP.

Адрес

• Эндпоинт: https://agenthere.ru/api/mcp
• Транспорт: Streamable HTTP (POST) и SSE (GET).
• Аутентификация: заголовок Authorization: Bearer ah_ВАШ_КЛЮЧ (ключ proxy или config).

URL можно получить программно через /api/developer/info.

Инструменты

Сервер предоставляет восемь инструментов в шести категориях: зрение, аудио, генерация изображений, генерация видео, веб-поиск и чтение страниц.

Понимание (медиа → текст)

• analyze_image (модель glm-5v-turbo) — анализ одного или нескольких изображений и ответ на вопрос по ним: описания, извлечение UI/кода, диаграммы, графики, скриншоты, а также извлечение текста из документов и скриншотов;
• analyze_video (модель glm-4.6v) — анализ видео и ответы на вопросы о его содержимом, сценах и событиях;
• transcribe_audio (модель glm-asr-2512) — транскрибация речи из аудиофайла в текст (WAV/MP3, до 25 МБ).

Генерация (текст → медиа)

• glm_generate_image (модель glm-image) — генерация изображения по текстовому описанию, возвращает постоянный URL изображения;
• glm_generate_video (модель cogvideox-3) — запуск генерации короткого видео по текстовому описанию и/или опорному изображению; сразу возвращает task_id;
• glm_get_generation — опрос задачи glm_generate_video до готовности URL видео (бесплатно).

Веб

• web_search (модель search-prime) — веб-поиск с возвратом структурированных результатов (заголовки, URL, сниппеты);
• web_reader — загрузка и чтение веб-страницы, возвращает содержимое в формате markdown или текст.

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

Добавьте сервер в файл конфигурации mcp.json:

{
  "mcpServers": {
    "agenthere": {
      "url": "https://agenthere.ru/api/mcp",
      "headers": {
        "Authorization": "Bearer ah_ВАШ_КЛЮЧ"
      }
    }
  }
}

После перезапуска инструменты AgentHere появятся в списке доступных — модель сможет вызывать их автоматически.

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

В настройках MCP добавьте новый сервер с тем же URL и заголовком авторизации. Cursor будет предлагать инструменты зрения, OCR, генерации и поиска при работе с кодом, скриншотами и документами.

Тарификация

Каждый вызов инструмента проверяет баланс и учитывает расход токенов и задержку — как и чат. При нулевом балансе вызов отклоняется. Подробнее — в «Токены и оплата».

Загрузка медиа

Для инструментов, принимающих изображение, видео или аудио, загрузите файл через POST /api/mcp/media/upload (ключ proxy или config) — эндпоинт вернёт ссылку на медиа ({kind}/{filename}) или публичный URL, который передаётся в инструмент. Анализ изображений также принимает публичный HTTPS-URL напрямую.