APIMart MCP

npx add-mcp 'https://mcp.apimart.ai/mcp'

agent — APIMart MCP 模拟演示

«Помогите найти модель, подходящую для главного изображения продукта, сгенерировать рекламное изображение духов и сообщить мне результат задачи.»

1. 01 Понимание требований Определение задачи генерации изображения
2. 02 Выбор модели Сравнение возможностей и параметров
3. 03 Отправка задачи Вызов APIMart API
4. 04 Возврат результата Получение статуса и файлов

Схема завершения задачи

Агент подготавливает параметры по документации модели, отправляет задачу и получает результат. Здесь показан только процесс — запросы не отправляются, квота не расходуется. Смотреть другие примеры диалогов

Используйте list_models из APIMart MCP, чтобы вывести 5 доступных моделей, без генерации контента.

→ APIMart / list_models
  {"limit": 5}

模型展示名称（示例，非 API 模型 ID）：
01  GPT Image 2.5
02  Nano Banana Pro
03  Seedream 5.0 Pro
04  Z-Image Turbo
05  Midjourney

✓ 示例数据。实际数量与模型 ID 以当前 Key 的返回结果为准。

Три способа подключения — выбирайте под свои задачи

Выбирайте документацию, удалённый инструмент или локальный навык в зависимости от привычек. Конкретный набор операций зависит от соответствующего интерфейса, инструмента и клиента.

Подключение по шагам

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

APIMart Agent Tools

macOS · zsh · Codex desktop · production environment

Безопасная настройка API Key

Доступно для production

Сначала создайте действующий API Key в APIMart, затем выполните команду ниже в терминале zsh на macOS и скрытно введите Key по запросу.

Получить API Key

Команда в терминале

read -s "APIMART_API_KEY?APIMart API Key: "
echo
launchctl setenv APIMART_API_KEY "$APIMART_API_KEY"
unset APIMART_API_KEY

Реальный Key вставляйте только при запросе в терминале. Не записывайте его в команды, чаты или скриншоты; скомпрометированный Key следует аннулировать и создать заново.

Дополнительные пояснения и область применения

Эта настройка применяется к настольным приложениям, перезапускаемым в текущей сессии входа. После настройки полностью закройте и заново откройте Codex desktop. Если вы используете терминальную версию, выполните export APIMART_API_KEY после скрытого ввода Key, затем запустите Codex из того же терминала; не выполняйте unset из этой инструкции. Ниже приведён только пример формата ключа — выполнять или заменять его не нужно.

Пример формата ключа · выполнять не нужно sk-••••••••••••••••

Как выбрать — зависит от ваших привычек

Для быстрых справок выбирайте AI-документацию, для повседневных вызовов инструментов — MCP, для локальных скриптов и фиксированных процессов — Skill.

Способ подключения	Лучше всего подходит для	Установка и настройка	Где выполняется	Основные преимущества	На что обратить внимание	Быстрый старт
AI-документация llms.txt	Разовые запросы, генерация кода вызовов	Установка не требуется, копируйте промпт	Агент читает документацию и запускает код	Лёгкий старт, гибкие вызовы интерфейса	Нужна способность читать веб-страницы, для выполнения кода всё равно нужны учётные данные	Смотреть шаги подключения
MCP (рекомендуется)	Частые взаимодействия, ежедневное творчество	Настройка удалённого сервиса и Key	Удалённый MCP APIMart	Структурированные инструменты, локальный пакет MCP не нужен	Зависит от сети и поддержки клиента, доступны только предоставленные инструменты	Смотреть шаги подключения
Agent Skill (локальный пакет навыков)	Фиксированные процессы, стандартизация команды	Установка полного каталога через GitHub	Локальный скрипт вызывает APIMart API	Процессы переиспользуемы, независимы от MCP	Требуется Node.js, при обновлении может понадобиться переустановка	Смотреть шаги подключения

Что может сделать агент

Основные сценарии — поиск моделей, понимание документации и типовые задачи с изображениями и видео. Перед использованием убедитесь, что выбранная модель, инструмент или локальный клиент поддерживает нужную операцию.

Поиск моделей

Поиск доступных моделей под задачу, проверка возможностей и версий, подходящих под текущие требования.

Параметры и документация

Чтение входных параметров, инструкций и ограничений, понимание способа вызова модели.

Генерация изображений

Выбор модели, подготовка параметров, отправка задачи, проверка статуса и получение результата.

Генерация видео

Вызов видеомоделей, отслеживание прогресса задачи, статуса выполнения и итогового результата.

API Key не появляется в командах установки

Учётные данные передаются через переменные окружения, что снижает риск случайного сохранения Key в истории терминала, скриншотах или логах чата.

• Сначала документация, потом настройка учётных данных AI-документация помогает агенту понять интерфейс и не запускает вызовы моделей автоматически.
• Чтение через переменные окружения MCP и Skill читают Key из переменных окружения; не записывайте Key в промпты или команды установки.
• Сначала проверьте подключение запросом моделей Фактическая генерация тарифицируется по правилам аккаунта APIMart. После подключения сначала проверьте конфигурацию запросом списка моделей.

Частые вопросы

Выберите способ и начинайте

MCP и Skill работают независимо; AI-документация не требует установки — промпт можно копировать напрямую.