Skavio PDF, OCR & Document Processing MCP

Skavio Processing API

Skavio MCP ツールを見つける

Cursor / Claude Desktop / Claude Code のセットアップ： リモート MCP 接続の手順 · そのまま使える Cursor JSON · 任意の Claude Desktop JSON。また、Skavio USDC マイクロ APIと、そのMCP クライアントガイドもご覧ください。

Skavio リモート MCP サーバー — AI エージェント向けの請求書 OCR と抽出、PDF テキスト抽出、ドキュメントの自動化、画像・メディア処理、文字起こし、会議ワークフローを提供します。公式 MCP Registryで見つけるか、互換性のある MCP クライアントをhttps://www.skavio.eu/processing/mcpに接続して OAuth を完了してください。または、明示的に発行された会社の MCP ベアラー認証情報を使用してください。処理には認証が必要です。

• MCP のセットアップと利用可能なすべてのツール
• MCP の料金と前払い USDC クレジット
• 公式 MCP サーバーマニフェスト
• x402 有料 USDC 検証マイクロ API · 機械可読な x402 検出情報

Processing MCP は会社単位の前払いクレジットを使用します。別個の x402 マイクロ API は、支払いが必要であることを示すレスポンスを返します。どちらも Skavio に秘密鍵を開示する必要はありません。

ドキュメント抽出、PDF・画像ツール、メディア処理、文字起こし、会議に対応する、会社単位の単一 API です。

• 製品と料金
• 開発者向けドキュメント（最新版）
• 会社ワークスペース：登録して API キーを作成
• OpenAPI v1 · 開発者ガイド
• Python クイックスタート · Node.js クイックスタート · 一括処理ガイド
• Postman 公開ドキュメント · コレクション
• DEV.to の連携記事
• Webhook の検証

API ルートのバージョン： /v1。コントラクトのスナップショット： 1.9.0 + Pricing V2、2026-10-04 に取得。

API 1.7.0 の新機能

• 月次の課金済み／予約済み使用量、個別の支払い履歴、上限付き CSV、キー別の帰属情報。
• API、バッチ、一括処理、有料 Web 登録のための、会社／キー単位のアトミックな予算。
• 有効期限付き API キー、きめ細かな権限、管理者専用のポリシー書き込み。
• キューの可視化、永続化されるアラート、未開始の単独ジョブのキャンセル、ガバナンス監査。
• 元のイベントを固定して使用する、失敗したジョブ／バッチ／一括処理の Webhook 配信の冪等な再試行。
• 構造化エラーと X-Request-Id による相関、ダッシュボードへのチェコ語／ドイツ語／英語の追加。

認証、UTC の月次ルール、制限、互換性については、使用量、予算、リカバリーガイドをご覧ください。

API 1.6.0 で導入された Storage Fabric

• プライベート S3 のソース／結果と、互換性のある従来のローカルファイル。
• 検証済みの直接アップロードと、承認済みの顧客クラウド URL からの再開可能なインポート。
• 会社単位の保持、アーカイブ、削除保留、オプトイン方式の個別バケットバックアップ。
• 手動による検証済みのバックアップ／復元、署名付き結果ダウンロード、暗号化されたインポート認証情報。
• 既存の Pricing V2、ジョブ、バッチ、一括処理のコントラクトは引き続きサポートされます。

エンドポイント、本番環境での制限、ブラウザーからのアップロード処理については、Storage Fabric ガイドをご覧ください。

API 1.5.0 で導入された一括処理機能

• 最大 100,000 件の一括マニフェストに対応し、変更不可のマニフェストページは 1～100 件、子アイテムの追加は上限付きで段階的に行えます。
• GET /v1/storage、宣言された入力／出力／スクラッチ領域の容量、および永続的なストレージ予約によるストレージを考慮した受け入れ。
• 大規模なワークロードで、成功済みアイテムを再送信せずに再開および失敗アイテムの再試行ができます。
• スケジューラーの状態、予約、チェックポイント、プロバイダーインテントの照合に対するクラッシュ／再起動からの復旧。
• 現在のプラットフォーム全体で同時実行されるジョブ数の上限 4 件を維持しながら、企業間で公平にスケジューリングします。
• シンプルなワークロード向けに、従来の100 件のバッチも引き続き利用できます。

一括処理ガイドまたはPython 一括処理クイックスタートから始めてください。 このリポジトリには、公開開発者キットが含まれています。ホスト型処理サービスの利用には、Skavio アカウントとクレジットが必要です。

最初の結果を得る

1. 登録し、企業プロフィールを作成して、企業ワークスペースで読み書きキーを生成します。キーは一度だけコピーできるため、サーバー側で保管してください。
2. マルチパートのフィールド files を使ってソースをアップロードします。
3. 処理を開始せずに POST /v1/estimate を呼び出します。
4. 返された estimated_credits を max_credits に設定します。
5. 安定した Idempotency-Key を指定して POST /v1/jobs を送信します。
6. 返されたジョブ ID を完了または失敗になるまでポーリングし、認証済みの結果パスからダウンロードします。

付属の請求書は合成データであり、顧客データを含まず、抽出テストに使用できます。

Python 3.10+

python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
# Set SKAVIO_API_KEY securely in your local environment.
export SKAVIO_IDEMPOTENCY_KEY="your-persisted-invoice-request-001"
python quickstart.py

Node.js 22+

# Set SKAVIO_API_KEY securely in your local environment.
export SKAVIO_IDEMPOTENCY_KEY="your-persisted-invoice-request-002"
node quickstart.mjs

どちらの例も sample-invoice.txt を使用します。別のソースに変更するには、SKAVIO_SOURCE に PDF／画像／テキストのソースを設定します。送信前にコストを見積もり、JSON 出力を results/ に書き込みます。 別のソースや変更したペイロードを意図的に処理する場合は、新しい冪等性キーを使用してください。 これらの例はサーバー側で利用を開始するためのものです。公式の Python および JavaScript SDK クライアントについては、sdk/README.md を参照してください。永続的なワークフローパイプラインについては、workflow-guide.md に記載されています。

Postman

コレクションをインポートするか、公開ワークスペースのコピーをフォークしてください。ご自身のローカル／プライベート環境変数 api_key を設定します。実際のキーを公開コレクションに保存しないでください。source_file にローカルソースを設定します。アップロード → 見積もり → 送信 → ジョブの状態 → ダウンロードの順に実行します。ジョブが終了状態になるまで 3～10 秒ごとにポーリングしてからダウンロードしてください。 リクエストでは API キーを使う処理エンドポイントを利用します。管理、キーの作成、請求、Webhook の登録には、ダッシュボードで対話型の企業管理者セッションを使用します。 新しい業務リクエストを行う前に、プライベート環境の upload_id、job_id、download_path、max_credits、idempotency_key をクリアしてください。同じ送信を再試行する場合は、冪等性キーをそのまま保持してください。

何を処理できますか？

ワークフロー	操作
ドキュメント	flow-extract → XLSX、CSV、JSON。選択したフィールド、根拠、レビュー用フラグ
PDF	結合、分割、ページの抽出／削除／回転、圧縮、透かし、ページ番号、パスワードによる保護／ロック解除、OCR
画像	サイズ変更／切り抜き／回転／反転、圧縮、形式変換、OCR
音声／動画	変換、トリミング、圧縮。動画の回転／解像度変更／ミュート
音声認識	transcribe、meeting

機能一覧には、正確な操作名が記載されています。最新の価格と上限を確認するには、GET /v1/capabilities を呼び出してください。 通常のファイルジョブで受け付けるソースは 1 つです。PDF の結合では 2～20 件の PDF を受け付け、Flow では複数のドキュメントソースを処理できます。Transcribe と Meeting で受け付けるメディアソースは 1 つです。バッチ処理では最大 100 件をサポートします。API 1.5.0 の一括マニフェストでは、段階的なディスパッチにより最大 100,000 件をサポートします。詳しくは bulk-guide.md を参照してください。単独ジョブでは任意の操作を連結できません。永続的な直線型の処理／レビュー／アーカイブパイプラインを利用できます。詳しくはワークフローガイドを参照してください。

クレジットと料金管理

すべての Web ツールと API は、会社共通のプリペイドウォレットを使用します。このキットでは、無制限に処理できる権利は提供していません。 サーバーはバイト数、ページ数、メディアの長さを計測します。送信時に見積もり額を予約し、成功時にその固定額を請求し、失敗時には予約を解除します。 予想外に高額なリクエストを拒否するには max_credits を使用し、残高と予約を確認するには GET /v1/wallet を使用します。

操作	料金 V2
OCR 生テキスト（ocr-txt）	3 クレジット／ページ
OCR ドキュメント出力（ocr-docx / ocr-pdf）	10 クレジット／ページ
フロー抽出とエクスポート	25 クレジット／ページ
PDF／画像／Office／テキストファイルの操作	25 MB または 10 ページ単位で 2 クレジット。ソースごとに大きい方の基準を適用
文字起こし	開始した 1 分ごとに 8 クレジット
会議	開始した 1 分ごとに 15 クレジット
File Toolbox の音声／動画	開始した 1 分ごとに 4 クレジット

名目上、1 EUR = 1,000 クレジットです。チャージ：EUR10/10,000、EUR25/26,000、EUR50/53,000、EUR100/108,000、EUR250/280,000、EUR500/570,000。小売向けの EUR6.99/6,990 パックもご利用いただけます。

月額プラン：Starter EUR29/30,000 クレジット、Business EUR79/85,000、Pro EUR199/225,000、Enterprise EUR499/600,000。有料クレジットに有効期限はなく、月次クレジットは繰り越されます。現在、すべてのプランで同じデプロイメント処理制限が適用されます。

Web ツールと API は 1 つのウォレットを共有します。送信時に計測済みの見積もり額を予約し、成功時に一度だけ請求し、恒久的な失敗時には予約を解除します。一時的なプロバイダー障害の場合、ジョブは永続的なチェックポイントと予約済みクレジットを保持したままキューに入ります。すでに見積もり済みのジョブと購入済みのチェックアウト／サブスクリプションオファーには、当初の金額が適用されます。

正規の最新カタログ：GET /v1/pricing。送信前に必ず見積もりを行い、料金をハードコードするのではなく max_credits を使用してください。

信頼性と統合ルール

• queued → processing → completed | failed。送信時には HTTP 202 が返されます。
• 同じ冪等性キーで同一のジョブリクエストを再送すると、同じジョブが返されます。ペイロードを変更すると 409 が返されます。
• ビジネスリクエスト、正確なペイロード、キー、ジョブ ID をシステムに保存してください。応答が失われた場合は、元のキーを使って再試行してください。
• ジョブが失敗するとクレジットは解除されます。意図的に再試行する場合は、新しいキーを使用してください。
• プロバイダー障害やサービスの再起動が発生しても、永続的なジョブ／チェックポイントと予約は保持されます。恒久的な失敗の場合は予約が解除されます。
• Webhook は少なくとも 1 回配信されます。生のバイト列に対して HMAC を検証し、イベント ID で重複を排除してください。ポーリングも引き続き利用できます。
• 結果／ソースの保持期間はデフォルトで 7 日間です。Storage Fabric のポリシー、アーカイブ、保留設定でオブジェクトの保持を管理します。retain_until を確認し、有効期限が切れる前に結果を保存してください。
• 抽出結果が誤っている場合があります。根拠と確認フラグをチェックし、後続の会計処理に進む前に、明細項目をソースと照合してください。

制限（現在のデプロイメント）

キー／セッションあたり毎分 120 リクエスト、アップロードあたり最大 100 ファイル／500 MB、会社あたりソースストレージ 2 GB、PDF あたり 100 ページ、会社あたりキュー内ジョブ 100 件、会社あたりプラットフォーム上で実行中のジョブ 4 件、全体で 4 件。文字起こし／会議の入力は最大 10 時間、File Toolbox のメディアは最大 2 時間です。 これらは上限であり、スループットや SLA を保証するものではありません。429 および一時的な 5xx 応答を受けた場合は、バックオフしてください。現在、すべてのプランで同じ処理制限が適用されます。

エラー

JSON エラーには detail が維持され、error_code、request_id、retryable が追加されます。X-Request-Id はリクエストの追跡に使用できます。エラーテキストとの照合ではなく、安定したコードを使用してください。検証エラーの応答に秘密情報が含まれることはありません。

HTTP	意味
401 / 403	認証、スコープ、または権限がないか無効です
402	クレジット不足です
404	オブジェクトが存在しないか、別の会社のオブジェクトです
409	状態／冪等性の競合、またはクレジット上限による拒否です
410	結果の有効期限が切れています
413 / 422	アップロード／ストレージの上限超過、またはソース／パラメーターが無効です
429	リクエスト／キューの上限に達しました
502 / 503 / 504	処理／プロバイダーが利用できないか、タイムアウトしました

セキュリティとサポート

HTTPS 経由で Authorization: Bearer <your-key> を使用してください。フロントエンドアプリ、URL、スクリーンショット、コミット、共有された Postman 環境にキーを決して公開しないでください。会社スコープのオブジェクト ID から、別の会社のデータにアクセスすることはできません。 ダッシュボードでキーの作成・無効化と Webhook の登録を行ってください。PDF のパスワードは秘密情報です。ペイロードをログに記録しないでください。 規制対象または機密性の高い入力を使用する前に、プライバシーと利用規約をご確認ください。ソースの処理には外部プロバイダーが関与する場合があります。バックアップやプロバイダーによる保持は、プラットフォーム上での削除とは別に扱われます。

統合に関する問題は、合成データによる再現のみを添えてこのリポジトリから報告するか、[email protected] まで非公開でご連絡ください。顧客の文書、キー、請求データを公開の Issue に添付しないでください。

バージョン管理

互換性のある追加機能は /v1 のまま提供されます。クライアントは未知のレスポンスフィールドを無視してください。破壊的変更にはメジャー API バージョンを適用するか、移行について事前に告知します。変更履歴。

ライセンス

この開発キットのサンプルコードとドキュメントは MIT ライセンスで提供されています。これはホスト型バックエンドのライセンスを付与するものでも、ホスト型サービスの無料利用を認めるものでもありません。サービスの利用には利用規約が適用され、クレジットに応じた料金が発生します。

バッチ処理 — API 1.5.0

広告されている任意の操作について、同じ処理パイプラインを通じて最大100件を送信できます。バッチでは1つの操作／オプションセットを使用し、通常の子ジョブを作成します。処理数は、会社ごとに同時実行4ジョブ、全体で同時実行4ジョブのままです。バッチによって100件が並列実行されるわけではありません。

1. POST /v1/uploads でファイルをアップロードし、アップロード ID を保持します。
2. {"operation":"jpg","upload_ids":["UPLOAD_A","UPLOAD_B"]} を使って POST /v1/batches/estimate で見積もりを取得します。
3. 同じペイロードを POST /v1/batches に送信します。max_credits には見積もりの合計を設定し、永続化した Idempotency-Key を指定します（8～128文字が許可されます）。
4. GET /v1/batches/{batch_id} をポーリングします。各 items[].job には、ステータス、クレジット、結果のダウンロードパスが含まれます。progress の範囲は0から1です。終了状態は completed、partial、failed です。
5. 完了後に GET /v1/batches/{batch_id}/results.zip でダウンロードします。アーカイブには成功した結果と manifest.json が含まれます。ファイルが見つからない場合や期限切れの場合は410が返されます。ZIP 出力は1 GBまでです。それを超える結果には、個別の認証済みダウンロードを使用してください。
6. 新しい永続化キーを使って POST /v1/batches/{batch_id}/retry-failed を呼び出し、失敗した項目の別請求バッチを作成します。再試行リクエストは元のバッチに紐づけられます。保持期間が切れる前に、成功した結果をダウンロードしてください。

クレジットはバッチ全体に対して原子的に予約されます。各子ジョブは個別に精算され、成功した項目には課金され、失敗した項目の予約は解放されます。同じ送信を再実行しても、クレジットは再度予約されません。キーを再利用してリクエストを変更すると409が返されます。バッチ項目は、会社ごとのキュー内ジョブ数100件の上限に含まれます。

upload_ids（ソースごとに子ジョブを1つ作成）または items（明示的なグループ）を使用してください。両方は使用できません。PDF の結合では、各グループに2～20個の PDF が必要です。

{"operation":"pdf-merge","items":[{"upload_ids":["PDF_A","PDF_B"]},{"upload_ids":["PDF_C","PDF_D"]}],"webhook_mode":"both"}

グループ化した Flow の入力にも、同じ items 形式を使用します。任意指定の webhook_id は、自社に属している必要があります。webhook_mode には batch（親イベント）、items（子イベント）、または both を指定できます。親イベントは batch.completed、batch.partial、batch.failed です。同じ署名を検証し、イベント ID の重複を排除してください。親の配信 ID は子の配信 ID とは異なります。

GET /v1/batches は、最近の自社バッチを一覧表示します。DELETE /v1/batches/{batch_id} は、精算情報を保持したまま、終了したバッチの結果／ソース指定を削除します。ソースと結果の保持期間は7日間です。失敗が繰り返される場合のガードにより429が返されることがあります。失敗するソースを継続的に再送信せず、サポートにお問い合わせください。正確なペイロード、キー、返された ID を永続ストレージに保存してください。

バッチのスターター：Python · Node.js · バッチガイド。SKAVIO_API_KEY、SKAVIO_UPLOAD_IDS（アップロードから取得した JSON 配列）、永続化した SKAVIO_BATCH_IDEMPOTENCY_KEY を設定してください。サンプルはポーリングを行い、認証済みの結果パスを表示します。保持期間が切れる前に、アーカイブの結果をダウンロードしてください。

永続的なワークフローパイプライン

線形の処理／レビュー／アーカイブのステップ、チェックポイント付きの実行、ステップごとのクレジット精算に対応しています。ワークフローガイドをご覧ください。

公式 SDK クライアント

Python および Node.js クライアントは sdk/README.md にあります。このリポジトリから python3 -m pip install ./sdk/python または npm install ./sdk/javascript でインストールできます。現行の OpenAPI の92操作すべて、永続的な送信キー、中断後に再開できるポーリング、署名付き Webhook の検証、認証済みの結果ダウンロードに対応しています。パッケージは公開されています：pip install skavio-sdk==1.1.0 および npm install @skavio-llc/[email protected]。

API 1.9.0 の制御と通知

一括停止と一括キャンセルには Idempotency-Key が必要で、企業ごとの分離が適用されます。停止すると、新しい子ジョブの受け入れを防ぎます。受け入れ済みのジョブは処理を完了し、一度だけ確定します。キャンセルは取り消しできず、それ以降のディスパッチを防ぎます。GET /v1/notifications と GET /v1/notifications/settings はテナントの範囲に限定されます。PUT /v1/notifications/settings には、企業管理者の Web セッションが必要です。通知はデフォルトで無効になっています。メールの送信には、トランスポートの設定が必要です。確定済みイベントは重複が排除され、上限のある配信期間内に再試行されます。メールは現在の企業の請求先住所に送信され、cs/de/en に対応しています。

AI エージェント向け USDC 支払い検証

Skavio USDC Payment Verification — x402 API は、Circle のネイティブ USDC 送金を調査し、受取人と小数点以下を含む金額が完全に一致するかを照合して、ブロックチェーン証拠 PDF を生成します。加盟店の支払い照合、会計士による取引確認、エージェントのワークフローに利用できます。PDF 証拠は税務インボイスではなく、第三者による承認を保証するものでもありません。

• HTTP Verify：0.02 ネイティブ USDC、Match：0.03 USDC、PDF：0.05 USDC。支払いは x402 v2 を通じて Base 上で別途決済されます。調査は Base、Polygon、Arbitrum、Optimism、Ethereum、Avalanche、およびファイナライズ済みの Solana に対応しています。
• API クイックスタート、スキーマ、エラー、クライアント設定 · 3 つのルートのディスカバリー · OpenAPI。
• Skavio USDC Payment Verification & Proof MCP、バージョン 1.1.2。安定したレジストリの名前空間とツール ID に変更はありません。https://www.skavio.eu/mcp（Streamable HTTP）を使って接続してください。
• MCP には、有料のブロックチェーン／ドメインツールが 4 つ（verify_native_usdc、match_native_usdc_payment、usdc_transfer_evidence_pdf、domain_dns_tls_audit）、無料のディスカバリーツールが 2 つ、独立した認証が必要な AgentTools の処理／ジョブ／ウォレット中継機能が 12 個あります。DNS/TLS 監査は 0.05 USDC で、脆弱性スキャンではありません。
• ウォレットの x402 拡張機能がない標準的な MCP クライアントは、自動で支払うことができません。 ディスカバリーは無料です。有料 MCP の再試行では params._meta["x402/payment"] が保持され、HTTP の再試行では PAYMENT-SIGNATURE が使われます。秘密鍵やシードフレーズは絶対に送信しないでください。サーバーを追加しても、資産のカストディや自動支出が有効になることはありません。
• PayAPI は、HTTP Verify、0.02 USDC、受取人／金額の完全一致 Match、0.03 USDC、ブロックチェーン PDF 証拠、0.05 USDC について、個別の最新リスティングと過去の決済レシートを公開しています。各ルートは 2026-10-17 に個別に読み戻し、過去の Base USDC レシートもそれぞれ読み取り専用で確認しました。このドキュメント更新にあたり、新たな支払いは行っていません。これはブロックチェーン証拠であり、税務インボイスではありません。
• RPC の可用性とファイナリティは結果に影響します。固定のレイテンシ SLA は保証されません。EVM リクエストには 32 バイトの 0x ハッシュを、Solana にはトランザクション署名を使用します。Match では、受取人のウォレットと、小数点以下 6 桁以内の正の USDC 金額を表す正確な文字列を指定します。

Cursor .cursor/mcp.json：

{"mcpServers":{"skavio-usdc":{"url":"https://www.skavio.eu/mcp"}}}

Claude Code：

claude mcp add --transport http skavio-usdc https://www.skavio.eu/mcp

Node.js と、レビュー済みの stdio-to-HTTP ブリッジを使った Claude Desktop：

{"mcpServers":{"skavio-usdc":{"command":"npx","args":["-y","mcp-remote","https://www.skavio.eu/mcp"]}}}

このブリッジはサードパーティ製パッケージをダウンロードする場合があり、ウォレットによる支払い機能は提供しません。現在の Desktop リモートコネクターでは、HTTPS URL を直接受け付ける場合があります。

最初の未払いリクエスト（署名や送金は行われません）：

curl -i 'https://www.skavio.eu/x402/v1/usdc/verify?tx_hash=0x98809948204426c574b6f0aabdec03baa996b5c43ce28cc9ca704fa5d07e592e&network=base'

HTTP 402 が返されることを確認し、PAYMENT-REQUIRED をデコードします。x402 ウォレットクライアントに承認する前に、正確な金額、Base USDC アセット、受取人を確認してください。その後、同じリクエストを再試行してください。応答が不明確な場合は、安易に再度支払うのではなく、復旧状態を確認してください。

別の Skavio PDF, OCR & Document Processing MCP、バージョン 0.2.7 は、https://www.skavio.eu/processing/mcp で会社の OAuth と共有のプリペイドクレジットを使用します。Processing ドキュメント では、会社による所有と計測対象のジョブについて説明しています。オプションの AgentTools 中継機能では、呼び出し元自身のキーと現在のバックエンドの可用性が必要です。冪等性キーを保持し、ステータスをポーリングして結果をダウンロードし、SHA256 を検証してください。HTTP /x402/v1/processing は引き続き無効です。