MCP-сервер для ИИ-агентов

Как это работает

• 1 Подключаете сервер — добавляете адрес https://tools.pixelplus.ru/api/mcp и свой ключ API в MCP-клиент. Это делается один раз, инструкции для популярных клиентов — ниже.
• 2 Агент узнаёт, что умеет — клиент сам получает каталог инструментов с описаниями и параметрами. Список проектов, справочники поисковых систем и регионов агент тоже запрашивает сам.
• 3 Вы формулируете задачу словами — «какие запросы просели после последнего съёма и почему», «добавь эти фразы в группу „Диваны“ и сними позиции». Агент выбирает инструменты, вызывает их и собирает ответ.
• 4 Долгие операции агент доводит до конца сам — проверки, отчёты и инструменты сервиса ставятся в очередь и возвращают report_id; агент опрашивает статус и забирает результат, когда он готов.

1Подключение

Claude Code

claude mcp add --transport http pixeltools https://tools.pixelplus.ru/api/mcp \
  --header "Authorization: Bearer {ключ-api}"

Claude Desktop

Откройте «Настройки → Разработчик → Изменить конфигурацию» и добавьте сервер в claude_desktop_config.json. Нужен установленный Node.js: пакет mcp-remote связывает приложение с удалённым сервером. После сохранения перезапустите Claude Desktop.

{
  "mcpServers": {
    "pixeltools": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://tools.pixelplus.ru/api/mcp",
        "--header", "Authorization:${PIXELTOOLS_AUTH}"
      ],
      "env": {
        "PIXELTOOLS_AUTH": "Bearer {ключ-api}"
      }
    }
  }
}

Cursor

Файл ~/.cursor/mcp.json — для всех проектов, или .cursor/mcp.json — для одного:

{
  "mcpServers": {
    "pixeltools": {
      "url": "https://tools.pixelplus.ru/api/mcp",
      "headers": {
        "Authorization": "Bearer {ключ-api}"
      }
    }
  }
}

Клиенты, где можно указать только адрес

Если клиент не позволяет задать заголовок, передайте ключ в адресе: https://tools.pixelplus.ru/api/mcp?key={ключ-api}. Такой адрес работает как пароль — не публикуйте его и не пересылайте.

2Что умеет агент

Инструменты сгруппированы так же, как разделы личного кабинета. Почти все инструменты проектов принимают project_id — агент берёт его из list_projects. Идентификаторы групп, запросов, событий и отчётов он тоже получает из ответов других инструментов, угадывать их не нужно.

3Каталог инструментов

Ниже — полный список, который сервер отдаёт агенту в tools/list: страница собирается из того же каталога, поэтому всегда совпадает с тем, что видит агент. Здесь у каждого инструмента краткое описание; полное — то, что читает агент, с ценой и составом ответа, — появится, если навести курсор на строку. Так же раскрываются параметры; жирным отмечены обязательные. Метка долгий — инструмент ставит задачу и отдаёт report_id, результат агент забирает повторным вызовом.

Тарификация

• Стоимость каждого платного инструмента указана в его описании — агент видит её до вызова.
• Стоимость проверок проекта можно узнать заранее: get_check_cost — позиции, частоты, рекомендации и итог; get_limits_forecast — расход на 30 дней по расписанию.
• Остаток лимитов — get_limits. Если лимитов не хватает, платная операция не запускается и агент получает ошибку с нужной суммой.

Ответы и ошибки

Результат инструмента — JSON, упакованный в текстовый блок. Ошибка инструмента (нет доступа к проекту, не хватает лимитов, неверный параметр) приходит обычным результатом с "isError": true и текстом: агент прочитает его и сам решит, что делать дальше.

Примеры

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

Рукопожатие

curl -X POST 'https://tools.pixelplus.ru/api/mcp' \
  -H 'Authorization: Bearer {ключ-api}' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Список инструментов

curl -X POST 'https://tools.pixelplus.ru/api/mcp' \
  -H 'Authorization: Bearer {ключ-api}' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Вызов инструмента

curl -X POST 'https://tools.pixelplus.ru/api/mcp' \
  -H 'Authorization: Bearer {ключ-api}' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_metrics","arguments":{"project_id":990}}}'

Ответ

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"update\":{\"id\":21762,\"date\":\"2026-10-01\"}, ... ,\"visibility\":{\"current\":41.2,\"previous\":39.8,\"diff\":1.4}}"
      }
    ],
    "isError": false
  }
}

Ограничения и рекомендации

• Начинайте разговор с агентом с проекта: он вызовет list_projects, затем get_project_summary и get_project_settings — так он узнает домен, подключённые поисковые системы и глубину съёма и не будет делать выводов о данных, которых в проекте нет.
• Выборки ограничены по размеру: агент видит, сколько записей подходит под фильтр, и сужает запрос, а не листает тысячи строк.
• Долгие операции — съём позиций, отчёты, мастер семантики, инструменты сервиса — не блокируют разговор: агент ставит задачу и возвращается за результатом по report_id. Готовый результат можно запрашивать повторно бесплатно.
• Удаление проекта, запросов, групп и выдачу доступов агент выполняет только по вашей прямой просьбе — подтверждайте такие действия в клиенте.
• Только в интерфейсе остаются передача владения проектом, загрузка файлов (импорт, логотип отчёта) и настройка вида страниц.