Praxicraft Assess MCP

Praxicraft Assess Public API 向け公式 Model Context Protocol サーバー。

Cursor、Claude Code、Claude Desktop、Codex、または任意の MCP クライアントに接続して、エージェントが候補者の招待、アセスメントとパイプラインの管理、Webhook の登録、結果の取得を、あなたの許可のもとで実行できるようにします。

npx -y @praxicraft/assess-mcp

Node.js 18+ が必要です。 製品ドキュメント: docs.praxicraft.com/assess-mcp · エージェントで構築する

API MCP + ドキュメント検索 + スキルを1つのインストールでお求めですか? Assess Agent Plugin をご利用ください。

目次

• 2つの接続方法

• 認証

• クイックスタート

  • ホスト型 HTTP (Cursor / Claude Code)

  • Stdio (API キー)

• エージェントができること

• ライブモードとテストモード

• エラー

• 要件とサポート

• ライセンス

Related MCP server: Oktopost MCP Server

2つの接続方法

ホスト型 OAuth は Cursor と Claude で最も簡単な方法です。ct_test_ キーが必要な場合や、非対話型環境の場合は stdio を使用してください。

認証

ホスト型 (OAuth)

設定に API キーは不要です。最初のツール呼び出しでブラウザの同意画面が開きます。オーナー、管理者、開発者 が承認できます。

ホスト型セッションは常にライブモードです。

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 キーをコミットしないでください。環境変数またはシークレットマネージャーを使用することをお勧めします。

API キーの IP 許可リストは Public 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 Public API (/api/v1/public/…) に対応しています。対象範囲は次のとおりです:

レスポンスはフラットな JSON です (Public API と同じ形式 — { "data": … } ラッパーはありません)。

エージェントには、プラン制限 を尊重し、error.code で分岐するよう促してください。

ライブモードとテストモード

テストの candidate.passed がライブの Slack や HTTPS 宛先に届くことはありません。ライブモードとテストモード を参照してください。

エラー

Public 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