TypeScript / JavaScript · v0.2.1
Keyless AI SDK
公式packageは @keyless-ai/sdk です。Node.js 18以降のサーバー環境で利用します。
利用者向けCowork導入とは別の開発者用経路です
SDKではサーバー用途に分離したKeyless API keyを使い、ブラウザへ埋め込みません。providerの生API keyはコードや環境変数へ置きません。
Install
npm install @keyless-ai/sdk
API-key MCP
createClient()は KEYLESS_API_KEY を読み、短期MCP sessionへ交換します。通常のMCP呼び出しに長期keyは送りません。
import { createClient } from "@keyless-ai/sdk";
const client = await createClient();
const tools = await client.listTools();
const result = await client.callTool(
"global.anthropic.main",
"messages",
{
model: "claude-sonnet-5",
max_tokens: 128,
messages: [{ role: "user", content: "Hello from Keyless." }]
}
);
console.log(result.audit_id, result.result);
主要メソッド
| Method | 用途 |
|---|---|
createClient(config?) | 認証して利用可能なclientを作成 |
startSession() | MCP sessionを開始しalias情報を取得 |
listTools() | 利用可能なMCP toolsとalias情報を取得 |
callTool(alias, method, body?) | Keyless経由でprovider処理を実行 |
getAliases() | 取得済みalias情報を返す |
hasAlias(alias) | aliasが利用可能か確認 |
Action Firewall
決済、取引、データ変更、デプロイなどの統制付き操作にはDashboard session modeを使います。
| Method | 用途 |
|---|---|
getActionCatalog() | 統制対象の操作一覧 |
getPolicyTemplates() | 推奨policy template一覧 |
applyPolicyTemplate(template) | policy templateを適用 |
getPolicyAutopilotReport() | guardrail coverageを確認 |
applyPolicyAutopilot() | 不足する標準guardrailを適用 |
simulateAction(action) | 影響、risk、rollbackを実行前に確認 |
executeAction(action) | policy、budget、approval、auditを通して実行 |
設定
| Variable | 用途 |
|---|---|
KEYLESS_API_KEY | API-key MCP mode |
KEYLESS_URL / KEYLESS_BASE_URL | platform URL。既定は https://app.keyless-ai.com |
KEYLESS_ACCESS_TOKEN | 取得済みDashboard access token |
KEYLESS_PROJECT_ID | Dashboard session modeのproject UUID |