01
ツールをインストール
クライアントに合った設定を選んでください。サーバーはローカルの stdio で動作します。環境を設定した後にクライアントを再起動してください。
[mcp_servers.omniakey]
command = "npx"
args = ["--yes", "github:omniakey-com/omniakey-devtools#v0.1.0", "mcp"]
env_vars = ["OMNIAKEY_API_KEY"]claude mcp add --transport stdio omniakey -- npx --yes github:omniakey-com/omniakey-devtools#v0.1.0 mcp{
"mcpServers": {
"omniakey": {
"command": "npx",
"args": [
"--yes",
"github:omniakey-com/omniakey-devtools#v0.1.0",
"mcp"
]
}
}
}read -s OMNIAKEY_API_KEY
export OMNIAKEY_API_KEY$env:OMNIAKEY_API_KEY = [System.Net.NetworkCredential]::new('', (Read-Host 'OmniaKey API key' -AsSecureString)).Password03
生成せずに確認
MCP 接続を再読み込みしてから、エージェントに読み取り専用の確認を依頼します。キーが見つからない場合は、クライアントの環境変数を確認してください。
OmniaKey MCP または CLI が利用できることを確認し、アクセス可能なモデルとメディアリクエストの共通スキーマを表示してください。生成タスクは送信しないでください。モデルを探す
API キーで利用できるモデルを確認し、ドキュメントで機能と現在の料金を調べます。
リクエストを送信
同じ OmniaKey API でテキストと画像・動画・音声の非同期タスクを実行します。
途中から再開
タスク id を保存して状態を確認できます。ローカルのタイムアウトで生成が再実行されることはありません。
入力から結果まで
CLI をインストールし、サンプルを image.json として保存します。有料リクエストの前にモデルと料金を確認し、TASK_ID を返された id に置き換えてください。
omniakey submit --file image.json --idempotency-key YOUR_UNIQUE_TASK_KEY
omniakey task wait TASK_ID --timeout 300
omniakey task get TASK_ID04
サーバーが公開するツール
サーバーは 7 つのツールを登録します。検出、スキーマ、タスク読み取り、キャンセルはコンテンツを生成しません。チャットとタスク送信は料金が発生する場合があります。
| ツール | 動作 | API Key が必要 |
|---|---|---|
omniakey_models | API Key で利用できるモデルを、任意の検索語と件数指定で一覧表示します。 | はい |
omniakey_schema | ネットワークリクエストなしで、チャットまたはメディアの共通リクエスト形式を返します。 | いいえ |
omniakey_chat | 非ストリーミングのチャット補完を 1 回実行します。ユーザーが生成を求めたときだけ使用します。 | はい |
omniakey_submit_task | 安定した冪等キーで有料の画像・動画・音声タスクを送信します。 | はい |
omniakey_get_task | id でタスクを読み取ります。成功時は新しい署名付きアセット URL も返します。 | はい |
omniakey_wait_task | 最大 45 秒タスクを待ちます。ローカルのタイムアウトはタスクをキャンセルも再送もしません。 | はい |
omniakey_cancel_task | 既存タスクのキャンセルを要求します。処理中のままの場合があるため、状態を照会して確認します。 | はい |
05
その他のクライアント
VS Code は servers ブロックとパスワード入力でキーを渡します。Windows では cmd 経由で npx を起動すると stdio サーバーが正しく開始します。
{
"inputs": [
{
"type": "promptString",
"id": "omniakey-api-key",
"description": "OmniaKey API key",
"password": true
}
],
"servers": {
"omniakey": {
"type": "stdio",
"command": "npx",
"args": [
"--yes",
"github:omniakey-com/omniakey-devtools#v0.1.0",
"mcp"
],
"env": {
"OMNIAKEY_API_KEY": "${input:omniakey-api-key}"
}
}
}
}{
"mcpServers": {
"omniakey": {
"command": "cmd",
"args": [
"/c",
"npx",
"--yes",
"github:omniakey-com/omniakey-devtools#v0.1.0",
"mcp"
]
}
}
}06
トラブルシューティング
以下はパッケージ自身のドキュメントに基づく問題です。設定を変える前にクライアントの環境を確認してください。
クライアントが API Key を見つけられない
MCP クライアントのプロセスが OMNIAKEY_API_KEY を継承している必要があります。Dock やスタートメニューから開いた GUI クライアントは、ターミナルで export した変数を見られないことがあります。クライアント自身の環境設定にキーを設定するか、シェルから起動してください。
API が 401 を返す
キーがない、期限切れ、または選択したモデルの利用が許可されていません。ダッシュボードで新しいキーを作成し、変更を反映するためクライアントを再起動してください。
API が 403 または JSON 以外を返す
OMNIAKEY_BASE_URL が Web サイトやプロキシではなく API を指しているか、エッジのアクセス制御がリクエストを許可しているか確認してください。クライアントはすべての API 呼び出しで JSON を期待します。
送信がタイムアウトした
タスク id と冪等キーを保持してください。再送せず、既知の id を照会します。ローカルのタイムアウトはリモートタスクをキャンセルしません。
07
このツールについて
固定リリース v0.1.0
OmniaKey の開発者ツールはオープンソースで、タグ付きの GitHub パッケージとして公開されています。このページはそのリリースのコマンドと動作を記録しています。
- ライセンス
- MIT
- アーキテクチャ
- CLI または MCP クライアント → 共通クライアント → api.omniakey.com/v1
- テスト
- リポジトリの統合テストは、ローカル HTTP サーバーに対して CLI を、実際の stdio クライアント経由で MCP サーバーを実行します。有料生成は実行しません。
- キーの扱い
- このサイトが API Key を受け取ることはありません。CLI と MCP サーバーは環境変数からキーを読み、API エンドポイントにのみ送信します。
よくある質問
モデルの料金は変わりますか?
いいえ。既存の API キーと API の課金ルールを使用します。モデル一覧やローカルスキーマの確認では生成を実行しません。テキストやメディアの生成には料金が発生する場合があります。
待機がタイムアウトしたら?
リモートのタスクはキャンセルも再送信もされません。id を保存し、task get または task wait で続けて確認してください。ファイルのリンクが期限切れになった場合は、同じタスクから新しいリンクを取得できます。
ホスト型の MCP URL はありますか?
いいえ。MCP サーバーはクライアントが npx で起動するローカルの stdio で動きます。OmniaKey はリモート MCP エンドポイントを提供していません。
Agent は生成ファイルをダウンロードできますか?
いいえ。タスクツールはメタデータと署名付きアセット URL を返します。URL が有効な間に自分のツールでダウンロードしてください。
MCP サーバーはモデルが返したツール呼び出しを実行しますか?
いいえ。OmniaKey の操作をクライアントに公開するだけで、どの呼び出しを行うかはクライアントとユーザーが決めます。生成にはユーザーの明示的な要求が必要です。