Praxicraft Assess MCP

Официальный сервер Model Context Protocol для публичного API Praxicraft Assess.

Подключайте Cursor, Claude Code, Claude Desktop, Codex или любой MCP-клиент, чтобы агент мог приглашать кандидатов, управлять оценками и пайплайнами, регистрировать вебхуки и получать результаты — с вашего разрешения.

npx -y @praxicraft/assess-mcp

Требуется Node.js 18+. Документация продукта: docs.praxicraft.com/assess-mcp · Создание с агентами

Предпочитаете одну установку для API MCP + поиска по документации + навыков? Используйте Assess Agent Plugin.

Содержание

• Два способа подключения

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

• Быстрый старт

  • Размещённый HTTP (Cursor / Claude Code)

  • Stdio (API-ключ)

• Что могут делать агенты

• Live и Test режимы

• Ошибки

• Требования и поддержка

• Лицензия

Related MCP server: Oktopost MCP Server

Два способа подключения

Размещённый OAuth — самый простой путь в Cursor и Claude. Используйте stdio, когда вам нужен ключ ct_test_ или неинтерактивная среда.

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

Размещённый (OAuth)

В вашей конфигурации нет API-ключа. Первый вызов инструмента открывает экран согласия в браузере. Владельцы, администраторы и разработчики могут одобрить.

Размещённые сессии всегда работают в режиме live.

Stdio (API-ключ)

Создайте API-ключ организации:

Assess → Developer → API Keys → создайте ключ → скопируйте ct_live_… или ct_test_… (показывается один раз).

export PRAXICRAFT_API_KEY="ct_test_xxxxxxxxxxxxxxxx"
# optional
export PRAXICRAFT_API_BASE_URL="https://assess.praxicraft.com"

Никогда не коммитьте API-ключи. Предпочитайте переменные окружения или менеджер секретов.

IP-allowlist для API-ключей применяются к запросам Public API / stdio MCP. Они не применяются к размещённому OAuth. Используйте выделенный ключ с пустым allowlist для stdio, если другие ключи ограничены CIDR.

Области и ротация: Аутентификация

Рекомендуемые области

Быстрый старт

Размещённый HTTP (Cursor / Claude Code)

Добавьте в настройки MCP:

{
  "mcpServers": {
    "praxicraft-assess": {
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Пример для Claude Code:

{
  "mcpServers": {
    "praxicraft-assess": {
      "type": "http",
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Перезапустите клиент, затем попробуйте: «Перечисли мои оценки Assess и пригласи меня на первую активную».

Stdio (API-ключ)

{
  "mcpServers": {
    "praxicraft-assess": {
      "command": "npx",
      "args": ["-y", "@praxicraft/assess-mcp"],
      "env": {
        "PRAXICRAFT_API_KEY": "ct_test_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Из исходников (для контрибьюторов):

git clone https://github.com/praxicraft-platform/praxicraft-assess-mcp.git
cd praxicraft-assess-mcp
npm ci
npm test
npm run smoke

Что могут делать агенты

Инструменты соответствуют публичному API Assess (/api/v1/public/…). Покрытие включает:

Ответы — это плоский JSON (та же форма, что и в Public API — без обёртки { "data": … }).

Напоминайте агентам соблюдать лимиты плана и ветвиться по error.code.

Live и Test режимы

Тестовое событие candidate.passed никогда не попадает в live-назначение Slack или HTTPS. См. Live и Test режимы.

Ошибки

Ошибки Public API выглядят так:

{ "error": { "code": "SOME_CODE", "message": "…", "details": {} } }

Всегда ветвитесь по error.code. Справочник: Ошибки

Требования и поддержка

• Node.js 18+ (пакет stdio)

• Тарифный план Assess, включающий API-ключи (см. лимиты плана)

• Документация продукта: docs.praxicraft.com

• Agent Plugin (API + Knowledge MCP для документации + навыки): praxicraft-assess-agent-plugin

• Проблемы: GitHub Issues

• Эл. почта: support@praxicraft.com

Мейнтейнерам, разворачивающим размещённый сервис /mcp: см. DEPLOYMENT.md.

Лицензия

MIT