MCP-сервер

Что такое MCP-сервер SocialGO?

MCP-сервер SocialGO предоставляет панель в виде набора инструментов для ИИ-агентов через Model Context Protocol. После подключения ассистент может просматривать каталог услуг, оформлять и отслеживать заказы, запрашивать дозаправки и управлять балансом, без какого-либо связующего кода. Это тонкий слой чтения и действий поверх того же API, что использует ваша панель управления, поэтому агенты остаются в рамках лимитов и тарифов вашего аккаунта.

Он работает с любым клиентом с поддержкой MCP, включая Claude Desktop, Claude Code, Cursor и ваших собственных агентов, построенных на MCP SDK.

Добавьте его в свой клиент

Сервер поставляется в виде пакета @socialgo/mcp и работает через stdio с помощью npx, поэтому ничего устанавливать или хостить самостоятельно не нужно. Добавьте следующую запись в конфигурацию вашего MCP-клиента:

{
  "mcpServers": {
    "socialgo": {
      "command": "npx",
      "args": ["-y", "@socialgo/mcp"],
      "env": {
        "SOCIALGO_API_KEY": "your_api_key_here"
      }
    }
  }
}

С Claude Code вы можете зарегистрировать его одной командой в терминале:

claude mcp add socialgo -- npx @socialgo/mcp

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

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

Сервер считывает единственную переменную окружения, SOCIALGO_API_KEY. Сгенерируйте ключ в настройках аккаунта, держите его в секрете и никогда не коммитьте в систему контроля версий. Каждый вызов инструмента аутентифицируется и авторизуется этим ключом, а заказы списываются с соответствующего баланса аккаунта. Смените ключ в панели управления в любой момент, чтобы отозвать доступ.

Основные инструменты

Сервер поддерживает небольшой, стабильный набор инструментов, охватывающий весь жизненный цикл заказа:

• search_services — Находите услуги по платформе, типу или ключевому слову, точка входа для любого рабочего процесса.
• get_service — Получайте полные сведения об одной услуге: тариф, минимальное/максимальное количество и поддерживаемые опции.
• create_order — Оформляйте заказ на услугу по целевой ссылке или имени пользователя.
• order_status — Проверяйте текущий статус, прогресс и оставшееся количество заказа.
• balance — Считывайте текущий баланс аккаунта и валюту.
• refill — Запрашивайте дозаправку подходящего заказа, объём которого упал ниже доставленного.
• cancel — Отменяйте заказ, который ещё можно отменить, и возвращайте оставшиеся средства.
• list_orders — Просматривайте недавние заказы постранично с их текущим статусом.
• add_funds — Создавайте намерение пополнения, чтобы добавить баланс на аккаунт.

Принцип «сначала поиск, потом действие»

Типичная SMM-панель содержит тысячи услуг на десятках платформ. Регистрация по одному инструменту на каждую услугу переполнила бы список инструментов агента, раздула контекстное окно и сделала модель медленнее и менее точной. SocialGO полностью избегает этого.

Вместо этого каталог находится за единственным инструментом обнаружения. Агент сначала вызывает search_services, чтобы сузить тысячи вариантов до нескольких релевантных совпадений, осматривает один с помощью get_service и только затем действует через create_order. Те же девять инструментов охватывают весь каталог, как бы он ни рос, добавление новых услуг на бэкенде никогда не меняет набор инструментов, который видит агент.

Полный поток выглядит так:

1. search_services({ query: "instagram followers" })
   → returns a short list of matching services with ids + rates

2. get_service({ id: "<id>" })
   → confirms rate, min/max and options before spending

3. create_order({ id: "<id>", link: "<target>", quantity: 1000 })
   → returns an order id

4. order_status({ id: "<order_id>" })
   → poll until completed

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