Praxicraft Assess MCP

官方 Model Context Protocol 服务器，用于 Praxicraft Assess 公共 API。

连接 Cursor、Claude Code、Claude Desktop、Codex 或任何 MCP 客户端，让智能体在获得你的许可后，可以邀请候选人、管理评估和流程、注册 Webhook 并获取结果。

npx -y @praxicraft/assess-mcp

需要 Node.js 18+。 产品文档：docs.praxicraft.com/assess-mcp · 使用智能体构建

想要一次安装即可获得 API MCP + 文档搜索 + 技能？请使用 Assess Agent Plugin。

目录

• 两种连接方式

• 身份验证

• 快速开始

  • 托管 HTTP（Cursor / Claude Code）

  • Stdio（API 密钥）

• 智能体可以做什么

• 实时模式与测试模式

• 错误

• 要求与支持

• 许可证

Related MCP server: Oktopost MCP Server

两种连接方式

托管 OAuth 是 Cursor 和 Claude 中最简单的接入方式。当你需要 ct_test_ 密钥或非交互式环境时，请使用 stdio。

身份验证

托管（OAuth）

配置中无需 API 密钥。首次工具调用会打开浏览器同意界面。所有者、管理员和开发者可以批准。

托管会话始终为实时模式。

Stdio（API 密钥）

创建组织 API 密钥：

Assess → 开发者 → API 密钥 → 创建密钥 → 复制 ct_live_… 或 ct_test_…（仅显示一次）。

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

切勿提交 API 密钥。建议使用环境变量或密钥管理器。

API 密钥上的 IP 白名单适用于公共 API / stdio MCP 请求。它们不适用于托管 OAuth。如果其他密钥受 CIDR 限制，请为 stdio 使用一个白名单为空的专用密钥。

作用域和轮换：身份验证

推荐的作用域

快速开始

托管 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

智能体可以做什么

工具映射到 Assess 公共 API（/api/v1/public/…）。覆盖范围包括：

响应为扁平 JSON（与公共 API 格式相同——没有 { "data": … } 包装）。

提醒智能体遵守套餐限制，并根据 error.code 进行分支处理。

实时模式与测试模式

测试中的 candidate.passed 永远不会触发实时的 Slack 或 HTTPS 目标。请参阅实时模式和测试模式。

错误

公共 API 错误格式如下：

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

始终根据 error.code 进行分支处理。参考：错误

要求与支持

• Node.js 18+（stdio 包）

• 包含 API 密钥的 Assess 套餐（请参阅套餐限制）

• 产品文档：docs.praxicraft.com

• Agent Plugin（API + 文档 Knowledge MCP + 技能）：praxicraft-assess-agent-plugin

• 问题反馈：GitHub Issues

• 邮箱：support@praxicraft.com

部署托管 /mcp 服务的管理员：请参阅 DEPLOYMENT.md。

许可证

MIT