APIKO

APIKO MCP サーバー

Claude Code と Codex から APIKO の画像・動画モデルを使用できます。 サーバーは独自の APIKO API キーを使い、stdio 経由でローカル実行されます。エージェントはモデルとリクエストフィールドを検索し、定価を提示し、画像や動画を生成し、タスクの進捗を追跡し、キーの利用額を確認し、参照画像をアップロードできます。

生成料金は API 価格で APIKO の残高から差し引かれます。サーバーは、すべての有料リクエストの前に、まず見積もりを提示してユーザーの承認を待つようエージェントに指示します。

要件

• Node.js 18.17 以降
• https://apiko.app/dashboard/apikeys で取得した APIKO API キー

インストール

サーバーは npm パッケージ apiko-mcp として公開されており、npx -y apiko-mcp で実行できます。代わりにソースから実行するには：

git clone <this repo> apiko-mcp
cd apiko-mcp
npm install
npm run build        # writes dist/index.js

以下の npx -y apiko-mcp を node /absolute/path/to/apiko-mcp/dist/index.js に置き換えてください。

Claude Code（CLI とデスクトップアプリ）

claude mcp add apiko --scope user -e APIKO_API_KEY=sk-... -- npx -y apiko-mcp

--scope user を指定すると、サーバーは ~/.claude.json に保存されます。このファイルは Claude Code のデスクトップアプリ（Code タブ）からも読み込まれます。Claude Code で /mcp を実行し、apiko が接続されていることを確認してください。

Codex（CLI、IDE 拡張機能、デスクトップアプリ）

codex mcp add apiko --env APIKO_API_KEY=sk-... -- npx -y apiko-mcp

または、Codex CLI、IDE 拡張機能、ChatGPT デスクトップアプリで共用される ~/.codex/config.toml に以下を追加してください：

[mcp_servers.apiko]
command = "npx"
args = ["-y", "apiko-mcp"]
env = { APIKO_API_KEY = "sk-..." }

デスクトップアプリで node または npx が見つからないと表示される場合は、which node で確認したフルパスを使用してください。

料金をかけずに試す

サーバーの環境変数に APIKO_MCP_READ_ONLY=1 を追加してください（-e APIKO_MCP_READ_ONLY=1 または --env APIKO_MCP_READ_ONLY=1）。これにより生成ツールとアップロードツールが非表示になります。モデルの検索、見積もり、タスクの確認、キーの利用状況の確認は引き続き可能です。

環境変数

変数	デフォルト	意味
APIKO_API_KEY	必須	APIKO キーです。チャットに貼り付けないでください。
APIKO_MCP_READ_ONLY	オフ	1 にすると、generate_image、generate_video、upload_image が非表示になります。
APIKO_BASE_URL	https://api.apiko.app	API のベース URL です。
APIKO_SITE_URL	https://apiko.app	公開価格カタログの読み込み元です。
HTTPS_PROXY、HTTP_PROXY、NO_PROXY	未設定	設定されている場合のみ使用されます。Node 組み込みの fetch はこれらを無視するため、いずれかが設定されていると、サーバーはプロキシ対応クライアントに切り替わります。

ツール

ツール	料金	機能
search_models	無料	キーで使用できるモデルを、カテゴリ、定価、モードとともに一覧表示します。query と category で絞り込めます。
get_model	無料	1 つのモデルの input_schema（フィールド、列挙値、デフォルト値）、エンドポイント、モード、料金階層を表示します。
estimate_cost	無料	スキーマに照らして入力を検証し、送信せずに定価を見積もります。
generate_image	有料	画像を生成します。input.images に参照 URL が指定されている場合は画像を編集します。モデルが対応している場合は非同期で実行し、wait_seconds（デフォルトは 30）まで待機します。
generate_video	有料	動画タスク（POST /v1/videos）を送信し、その task_id を返します。
get_task	無料	タスクのステータス、進行状況、結果 URL、失敗理由を表示します。最大 45 秒間待機できます。
check_balance	無料	このキーの利用額と、設定されている場合はキー独自の利用上限を確認します。
upload_image	無料	ローカルの JPEG／PNG／WebP をアップロード（または公開画像 URL の画像をコピー）し、参照フィールド用の公開 img.apiko.app URL を返します。

一般的な手順：search_models → get_model → upload_image（ローカルの参照画像がある場合）→ estimate_cost → ユーザーが承認 → generate_image／ generate_video → get_task。

コストの見積もり

estimate_cost（および生成ツールの cost フィールド）は、次のいずれかを返します。

• estimated：料金が入力から直接決まる場合は数値です。resolution で選択する画像ごとの料金区分（または gpt-image-2 の明示的な WxH サイズ）、画像ごとの固定料金、resolution × duration による動画の秒単位料金が該当します。reference_video_seconds を指定すれば、参照動画も含まれます。
• needs_input：通常は参照動画の合計時間など、料金の算出に必要な情報が不足している場合です。範囲と、送信時に残高から確保される金額（hold_usd）も表示されます。タスクの精算時に、実際の請求額まで返金されます。
• token_billed：トークン単位で請求されます（GPT Image 2.5 Flare／Sunburst、テキストモデル）。indicative_usd の金額が表示される場合がありますが、確定見積もりではありません。
• unknown：公開料金がないか、信頼できる料金ルールがありません。無料として扱わないでください。

すべての金額は、apiko.app の公開カタログに基づく米ドルの定価です。精算時のゲートウェイの請求額が最終額です。失敗したタスクは自動的に返金されます。

生成ツールの max_cost_usd は、見積もり額または保証された上限額が上限を超える場合、あるいは信頼できる金額を算出できない場合、呼び出しを拒否します。

請求に関する注意事項

• generate_* を呼び出すたびに、有料タスクが作成されます。進捗確認のために再度呼び出すと二重に課金されるため、get_task を使用してください。
• client_request_id は、同じサーバープロセスの実行中に同じ呼び出しが二重に送信されるのを防ぎます。送信がタイムアウトした場合、サーバーは再試行しません。まず https://apiko.app/dashboard/usage を確認してください。
• 結果リンクは署名付きで、24 時間保持されます。アップロードした参照データは、リンクを知っている人なら誰でも閲覧でき、72 時間後に削除されます。
• check_balance が読み取るのはキーであり、アカウントではありません。apiko.app で作成したキーには個別の上限がなく、アカウント残高を使用します。残高はダッシュボードでのみ確認できます（https://apiko.app/dashboard/billing）。
• テキストモデルは search_models に表示されますが、このサーバー経由ではなく、OpenAI 互換 API https://api.apiko.app/v1 経由で呼び出します。

タイムアウト

Codex では、各 MCP ツール呼び出しのデフォルトのタイムアウトは 60 秒です。そのため、ここにあるツールが 45 秒を超えて待機することはありません。長時間かかるタスクは、完了まで get_task で確認します。まれにある同期専用の画像モデルでは、それ以上かかることがあります。使用する場合は、[mcp_servers.apiko] の tool_timeout_sec を大きくしてください。

開発

npm install
npm test            # builds, then runs the tests against a local mock API

src/tools.ts にツールのロジックがあり、src/server.ts はトランスポートに依存せず、そこから McpServer を構築します。src/index.ts は stdio のエントリーポイントです。テストから本番 API が呼び出されることはありません。