reference
Use this if
優先 AI プロバイダーと MCP クライアントを接続して、チームが支援型トリアージと安全なレビュー ワークフローを実行できるようにします。
Audience: セキュリティプラットフォーム管理者および統合エンジニアTypical time: 20-30 分
開始前に
- 承認されたモデル プロバイダーを選択し、シークレット マネージャーに資格情報を保存します。
- 内部リスク ポリシーでどの AI タスクが許可されているかを確認してください。
- MCP クライアントを確保しますワークスペースの JWT 資格情報を安全に送信できます。
Guide walkthrough
1
ステップ 1
プロバイダーの資格情報を安全に構成する
モデル プロバイダーのシークレットを独自のシークレット マネージャーに保持し、BlackShield 構成から参照します。
- 承認されたモデル エンドポイントのプロバイダー認証情報を作成します。
- `credentials_ref` キーを使用して、`AI_SHIM_SECRET_VALUES` を通じて認証情報参照をマップします。
- チームが使用する予定の AI タスクのみを有効にします。
What success looks like
チームが使用する予定の AI タスクのみを有効にします。
2
ステップ 2
ガードレールを使用した AI 支援ワークフローを有効にします
高価値のワークフローから開始し、本番環境の決定について人間によるレビューを実施します。
- バックログの優先順位付け。
- 安全なコード レビュー サポートのために `pr_diff_analysis` を有効にします。
- リスク ポリシーに合わせてモデル、トークン、タイムアウト、および温度の制限を設定します。
What success looks like
リスク ポリシーに合わせてモデル、トークン、タイムアウト、および温度の制限を設定します。
3
ステップ 3
MCP クライアントを統合する
モデル推論を制御下に置きながら、BlackShield ツールを呼び出すように MCP クライアントを構成する。
- MCP エンドポイントを `/api/v1/mcp` に設定し、ワークスペース JWT を認証ヘッダーに含めます。
- R呼び出す前に `initialize` と `tools/list` を実行してください`tools/call`.
- `/api/v1/mcp/manifest` を使用して利用可能なツールのメタデータを検出します。
- プロバイダー キーを独自のランタイムに保持し、本番環境には人間の承認が必要です変更。
What success looks like
プロバイダー キーを独自のランタイムに保持し、本番環境には人間の承認が必要です変更。
Demonstration only
This configuration is designed for ease of use. To deploy scanner clients at scale, please plan your deployment architecture accordingly or contact us for enterprise best practices.
実行する
Exchange client credentials for a short-lived token
curl -X POST https://api.blackshield.chaplau.com/api/v1/ai-gateway/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "client_credentials",
"client_id": "your-client-id",
"client_secret": "your-client-secret"
}'Query OpenAI completions via the Gateway Proxy
curl -X POST https://api.blackshield.chaplau.com/api/v1/ai-gateway/openai/v1/chat/completions \
-H "Authorization: Bearer <your_short_lived_token>" \
-H "Content-Type: application/json" \
-d '{
"provider": "openai",
"model": "gpt-4o-mini",
"messages": [
{
"role": "user",
"content": "List the security requirements for the tenant onboarding flow."
}
]
}'Configure the Stdin/Stdout MCP Proxy in Cursor / VS Code / Claude Desktop
{
"mcpServers": {
"blackshield-gateway": {
"command": "blackshield-mcp",
"args": [
"--client-id", "<your-client-id>",
"--client-secret", "<your-client-secret>",
"--url", "https://api.blackshield.chaplau.com/api/v1/mcp"
]
}
}
}What success looks like
- MCP ハンドシェイクとツール/list が正常に完了します。
- AI 支援アクションにより、運用に影響を与える変更に対する人間の承認が維持されます。