Документация MCP

The Model Context Protocol (MCP) allows AI assistants like Claude, GPT, and Cursor to interact directly with your Better Search Console data. Your assistant can list websites, check indexation status, analyze prompts, manage sitemaps, and much more — all through a standardized tool-calling interface.

Эндпоинт

MCP-сервер доступен по адресу:

https://api.better-search-console.com/_mcp

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

Поддерживаются три метода (в порядке приоритета):

Метод	Пример
`X-API-TOKEN` header	`X-API-TOKEN: your_token_here`
`Authorization: Bearer` header	`Authorization: Bearer your_token_here`
`?token=` query parameter	`/_mcp?token=your_token_here`

Найдите API-токен в настройках. Это 64-символьная шестнадцатеричная строка.

Поток OAuth

Для клиентов с поддержкой OAuth эндпоинт MCP также принимает стандартные токены OAuth 2.0 Bearer, полученные через процесс Google OAuth. Токен доступа, возвращённый после авторизации, сохраняется в записи пользователя и может использоваться как Bearer-токен.

Инструкции по настройке

Claude.ai (Web)

{
  "mcpServers": {
    "better-search-console": {
      "url": "https://api.better-search-console.com/_mcp?token=<YOUR_API_TOKEN>"
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "better-search-console": {
      "url": "https://api.better-search-console.com/_mcp",
      "headers": {
        "X-API-TOKEN": "<YOUR_API_TOKEN>"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "better-search-console": {
      "url": "https://api.better-search-console.com/_mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_TOKEN>"
      }
    }
  }
}

Лимиты запросов

Уровень	Запросов/мин	Запросов/день
Free	10	50
Starter	100	200
Pro	200	500
Master	Unlimited	Unlimited

Tool Reference (50 tools)

Примеры использования

Список ваших сайтов:

Tool: list-websites
Arguments: {}

Проверить индексацию URL:

Tool: check-url-indexation
Arguments: { "website_id": 1, "url": "https://example.com/page" }

Отправить URL на индексацию:

Tool: submit-urls-for-indexing
Arguments: { "website_id": 1, "url_ids": [10, 11, 12] }

Устранение неполадок

Проблема	Решение
401 Unauthorized	Убедитесь, что API-токен верен и включён в запрос.
429 Too Many Requests	Вы превысили лимит запросов. Подождите или улучшите план.
Инструмент не найден	Убедитесь, что название инструмента точно совпадает со справкой выше.
Соединение отклонено	Убедитесь, что URL хоста верен и доступен из вашей сети.
Неверные параметры	Убедитесь, что параметры соответствуют схеме. ID должны быть числами.