KeyCore для ИИ-агентов

Сводка для агента

• Адрес MCP-сервера: https://key-core.ru/mcp, транспорт Streamable HTTP (локального stdio-сервера нет).
• Вход: OAuth (авторизация с PKCE, динамическая регистрация клиента, Client ID Metadata Documents) или API-ключ в заголовке Authorization: Bearer ….
• Discovery: /.well-known/oauth-protected-resource и /.well-known/oauth-authorization-server; ответ 401 содержит WWW-Authenticate с resource_metadata.
• Доступ: активный платный тариф и подтверждённая почта. На бесплатном тарифе MCP недоступен.
• Права: keycore:read, keycore:write, keycore:spend. Для первого подключения выдавайте только чтение.
• Деньги: платные инструменты списывают баланс аккаунта; ИИ-группировка стоит 8 копеек за фразу, остальные цены вернёт keycore_get_pricing.
• Документированного публичного REST API для внешних интеграций нет: для агентов поддерживаемый программный доступ — MCP.

Подробная инструкция для пользователя: подключение ИИ-ассистентов через MCP.

Как подключиться

Сначала откройте в кабинете «Настройки → ИИ-ассистенты». Адрес сервера вставляется в настройки MCP клиента, а не открывается в браузере (ответ 405 на GET ожидаем).

Claude Code, OAuth

claude mcp add --transport http keycore https://key-core.ru/mcp

Затем откройте /mcp в Claude Code, выберите KeyCore и пройдите вход в браузере.

Claude Code, API-ключ (.mcp.json)

{
  "mcpServers": {
    "keycore": {
      "type": "http",
      "url": "https://key-core.ru/mcp",
      "headers": { "Authorization": "Bearer ${KEYCORE_API_KEY}" }
    }
  }
}

Переменную окружения KEYCORE_API_KEY задайте на своём компьютере; ключ не вставляйте в файл, чат или команду.

Cursor

В настройках MCP добавьте удалённый сервер https://key-core.ru/mcp. Для OAuth не задавайте заголовок Authorization; для API-ключа используйте конфигурацию с вкладки Cursor в кабинете (в ней ключ подставляется как ${env:KEYCORE_API_KEY}).

Codex и другие клиенты

Подойдёт любой клиент с поддержкой Streamable HTTP: укажите https://key-core.ru/mcp и способ авторизации. Проверенных руководств именно для Codex и ChatGPT у нас нет: сверяйте формат с документацией клиента и не копируйте чужую конфигурацию без проверки.

WorkAI, API-ключ (.vscode/mcp.json)

{
  "inputs": [
    { "type": "promptString", "id": "keycore-api-key", "description": "API-ключ KeyCore", "password": true }
  ],
  "servers": {
    "keycore": {
      "type": "http",
      "url": "https://key-core.ru/mcp",
      "headers": { "Authorization": "Bearer ${input:keycore-api-key}" }
    }
  }
}

Безопасная первая проверка

Попросите агента: «Вызови keycore_ping, затем keycore_list_projects. Ничего не изменяй и не запускай платные операции».

Инструменты (34)

Чтение — keycore:read (11)

Просмотр проектов, фраз, групп, минус-слов, операций, баланса и цен.

• keycore_ping — Проверка подключения
• keycore_get_account — Аккаунт, баланс и лимит
• keycore_get_pricing — Цены операций
• keycore_list_projects — Список проектов
• keycore_get_project_overview — Обзор проекта
• keycore_search_phrases — Поиск фраз проекта
• keycore_list_groups — Группы проекта
• keycore_list_minus_words — Минус-слова проекта
• keycore_list_operations — Операции проекта
• keycore_get_operation_status — Статус операции
• keycore_list_ads — Тексты объявлений и расширений

Запись — keycore:write (14)

Бесплатные изменения: проекты, импорт фраз, группы, корзина, минус-слова.

• keycore_create_project — Создать проект
• keycore_import_phrases — Импорт фраз в проект
• keycore_manage_project — Переименовать проект или убрать в архив
• keycore_manage_groups — Управление группами
• keycore_manage_ads — Правка объявлений и расширений
• keycore_move_phrases — Перенести фразы в группу
• keycore_copy_phrases — Скопировать или перенести фразы в другой проект
• keycore_trash_phrases — Убрать фразы в корзину
• keycore_restore_phrases — Вернуть фразы из корзины
• keycore_preview_minus_words — Превью минус-слов
• keycore_apply_minus_words — Применить минус-слова
• keycore_preview_remove_minus_words — Превью снятия минус-слов
• keycore_manage_minus_words — Снять минус-слова
• keycore_apply_ai_grouping — Применить ИИ-группировку

Платные операции — keycore:spend (9)

Операции, списывающие баланс: Wordstat, ИИ-группировка, ИИ-минус-слова, SERP, объявления, выгрузка в Директ.

• keycore_collect_wordstat — Сбор фраз из Wordstat
• keycore_update_frequencies — Обновить частотность
• keycore_run_ai_grouping — ИИ-группировка фраз (8 коп. за фразу)
• keycore_find_minus_words_ai — ИИ-поиск минус-слов
• keycore_analyze_serp — SERP-анализ фраз
• keycore_track_positions — Проверка позиций сайта
• keycore_generate_ads — Генерация объявлений
• keycore_export_direct — Выгрузка в Директ
• keycore_cancel_operation — Остановить операцию

Долгие платные операции возвращают идентификатор операции: статус проверяйте через keycore_get_operation_status, а не повторяйте запуск.

Машиночитаемые материалы

• /llms.txt — карта сайта для LLM.
• /llms-full.txt — полный текст базы знаний и этой страницы одним файлом.
• Каждая статья базы знаний доступна в чистом Markdown: добавьте .md вместо завершающего слэша, например /help/getting-started/agents-mcp.md.
• /.well-known/mcp/server-card.json — карточка MCP-сервера.