GPT-Image 2.6 Flare と Sunburst が登場1 枚 $0.025 から

オープンソース · 開発者ツール

OmniaKey MCP:エージェントからモデルへ

ローカル MCP サーバーでコーディングエージェントを OmniaKey に接続します。

使い始める
Node.js 22+ · npm · Gitソースを見る

01

ツールをインストール

クライアントに合った設定を選んでください。サーバーはローカルの stdio で動作します。環境を設定した後にクライアントを再起動してください。

~/.codex/config.toml
[mcp_servers.omniakey]
command = "npx"
args = ["--yes", "github:omniakey-com/omniakey-devtools#v0.1.0", "mcp"]
env_vars = ["OMNIAKEY_API_KEY"]

02

API キーを接続

ターミナルの非表示入力にキーを貼り付けて Enter を押し、この環境からエージェントを起動してください。キーをプロンプトやリポジトリに含めないでください。

API キーを取得
Bash / zsh
read -s OMNIAKEY_API_KEY
export OMNIAKEY_API_KEY

03

生成せずに確認

MCP 接続を再読み込みしてから、エージェントに読み取り専用の確認を依頼します。キーが見つからない場合は、クライアントの環境変数を確認してください。

Agent
OmniaKey MCP または CLI が利用できることを確認し、アクセス可能なモデルとメディアリクエストの共通スキーマを表示してください。生成タスクは送信しないでください。
01

モデルを探す

API キーで利用できるモデルを確認し、ドキュメントで機能と現在の料金を調べます。

02

リクエストを送信

同じ OmniaKey API でテキストと画像・動画・音声の非同期タスクを実行します。

03

途中から再開

タスク id を保存して状態を確認できます。ローカルのタイムアウトで生成が再実行されることはありません。

入力から結果まで

CLI をインストールし、サンプルを image.json として保存します。有料リクエストの前にモデルと料金を確認し、TASK_ID を返された id に置き換えてください。

CLI · image.json → id → assets
omniakey submit --file image.json --idempotency-key YOUR_UNIQUE_TASK_KEY
omniakey task wait TASK_ID --timeout 300
omniakey task get TASK_ID

04

サーバーが公開するツール

サーバーは 7 つのツールを登録します。検出、スキーマ、タスク読み取り、キャンセルはコンテンツを生成しません。チャットとタスク送信は料金が発生する場合があります。

ツール動作API Key が必要
omniakey_modelsAPI Key で利用できるモデルを、任意の検索語と件数指定で一覧表示します。はい
omniakey_schemaネットワークリクエストなしで、チャットまたはメディアの共通リクエスト形式を返します。いいえ
omniakey_chat非ストリーミングのチャット補完を 1 回実行します。ユーザーが生成を求めたときだけ使用します。はい
omniakey_submit_task安定した冪等キーで有料の画像・動画・音声タスクを送信します。はい
omniakey_get_taskid でタスクを読み取ります。成功時は新しい署名付きアセット URL も返します。はい
omniakey_wait_task最大 45 秒タスクを待ちます。ローカルのタイムアウトはタスクをキャンセルも再送もしません。はい
omniakey_cancel_task既存タスクのキャンセルを要求します。処理中のままの場合があるため、状態を照会して確認します。はい

05

その他のクライアント

VS Code は servers ブロックとパスワード入力でキーを渡します。Windows では cmd 経由で npx を起動すると stdio サーバーが正しく開始します。

.vscode/mcp.json
{
  "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}"
      }
    }
  }
}

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 の操作をクライアントに公開するだけで、どの呼び出しを行うかはクライアントとユーザーが決めます。生成にはユーザーの明示的な要求が必要です。

OmniaKey のほかの使い方