Appexbots можно подключить к ИИ-ассистенту — Claude, ChatGPT, Cursor, Claude Code и другим клиентам с поддержкой MCP. Агент работает с вашими ботами, магазином, каталогом, заказами и клиентами с теми же правами, что и вы в личном кабинете: например, «заведи 20 товаров из этого прайса», «переведи каталог на английский», «покажи заказы за неделю и напиши клиентам, чьи заказы задерживаются».
Подключение занимает пару минут: создаёте API-ключ в личном кабинете, скачиваете конфиг и вставляете его в настройки своего ассистента.
.json) или скопируйте его. Восстановить ключ нельзя, только создать новый.Ключ равнозначен паролю от личного кабинета в рамках выбранных прав. Не публикуйте его и не пересылайте в открытых чатах. Утёкший ключ отзовите в том же разделе — агент потеряет доступ мгновенно.
В диалоге созданного ключа и в скачанном конфиге есть всё нужное:
…/mcp/key/apx_… (с выбранным набором — …/mcp/key/apx_…/x/catalog) для клиентов, которые не умеют передавать заголовки (Claude.ai, ChatGPT);mcpServers — готовая настройка для Cursor, Claude Code, Claude Desktop, VS Code;Appexbots, Remote MCP server URL: вставьте URL коннектора. Авторизацию не настраивайте — ключ уже внутри ссылки.Appexbots, MCP Server URL: вставьте URL коннектора, Authentication: No authentication.Подходит, если нужен GPT, которым будет пользоваться вся команда.
…/mcp/openapi-catalog.json).…/mcp/openapi.json содержит около 80 и не импортируется — берите группы отдельными actions: …/mcp/openapi-catalog.json, …/mcp/openapi-orders.json, …/mcp/openapi-merchant.json, …/mcp/openapi-bots.json (ссылки есть на странице …/mcp/docs).apx_….https://appexbots.com/privacy.claude mcp add --transport http appexbots https://app.appexbots.com/app/mcp --header "Authorization: Bearer apx_..."
Готовая команда с вашим ключом есть в конфиге (поле appexbots.claudeCode).
mcp.jsonСкопируйте блок mcpServers из скачанного конфига в файл настроек клиента (Cursor: ~/.cursor/mcp.json или Settings → MCP → Add; VS Code: .vscode/mcp.json, ключ servers):
{
"mcpServers": {
"appexbots": {
"type": "http",
"url": "https://app.appexbots.com/app/mcp",
"headers": { "Authorization": "Bearer apx_..." }
}
}
}
Клиенты, которые понимают только stdio, подключаются через mcp-remote:
{
"mcpServers": {
"appexbots": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.appexbots.com/app/mcp", "--header", "Authorization: Bearer apx_..."]
}
}
}
В браузере Telegram файлы не скачиваются: в диалоге ключа нажмите Скопировать конфиг и сохраните текст на компьютере, либо откройте личный кабинет в обычном браузере.
Сервер отдаёт около 80 инструментов. Claude и ChatGPT с этим справляются, а небольшим моделям (Qwen, Llama, GigaChat, окно 32k) такой список занимает половину контекста, и они начинают путать параметры. Для них подключайте агента к адресу с нужным набором:
…/mcp/x/catalog — товары, категории, картинки, переводы;…/mcp/x/orders,crm — заказы, чат, клиенты, промокоды, рассылки;…/mcp/x/merchant,bots — настройки магазина и бота;…/mcp/x/reports — дашборд и отчёты;/readonly, чтобы скрыть все пишущие инструменты: …/mcp/x/catalog/readonly.Наборы можно перечислять через запятую; инструменты контекста (whoami, справочники) входят в каждый. С ключом в ссылке — …/mcp/key/apx_…/x/catalog; клиенты с заголовками могут вместо адреса передать X-MCP-Toolsets: catalog,orders и X-MCP-Readonly: true. Набор только сужает права ключа: инструмент вне набора вернёт понятную ошибку с подсказкой, к какому адресу подключиться.
Ошибки агент получает в тексте ответа: какой параметр неверен, какие значения допустимы и как исправить, поэтому даже небольшая модель обычно поправляется сама.
Скажите агенту, что он управляет вашим магазином в Appexbots, и попросите начать с whoami — он сразу получит идентификаторы магазина и бота. Хорошая практика: попросить агента искать товар перед созданием (чтобы не плодить дубли) и переспрашивать перед удалением, рассылками и изменением цен.
В клиентах с поддержкой сценариев (prompts) есть готовые команды: импорт каталога с сайта, перевод каталога, недельный отчёт, настройка нового магазина. Для остальных клиентов тексты сценариев лежат на странице …/mcp/docs.
Полный список инструментов с параметрами и группами прав: https://app.appexbots.com/app/mcp/docs (страница доступна на английском, русском и тайском). Коротко:
Намеренно недоступны через агента: смена токена бота, управление менеджерами, секреты платёжных систем и служб доставки, биллинг.