リモート MCP に対応した AI エージェントに PDFCraft を接続すると、PDF から Markdown や EPUB への変換、PDF・EPUB の翻訳を依頼できます。残高の確認、料金の見積もり、変換結果の取得も可能です。
接続を設定する
- OOMOL Console で自分の API Key を作成します。
- エージェントの設定でリモート MCP サーバーを追加します。URL は
https://api.pdfcraft.ai/v1/mcp、トランスポートは Streamable HTTP を指定します。 - ヘッダーに
Authorization: Bearer YOUR_API_KEYを追加し、YOUR_API_KEYを自分のキーに置き換えます。
以下の JSON は接続に必要な情報です。設定項目の名前はクライアントによって異なるため、それぞれの URL と HTTP ヘッダーの設定欄に値を入力してください。
{ "url": "https://api.pdfcraft.ai/v1/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" }}キーはクライアントの保護された設定に保存してください。会話に貼り付けたり、ファイルの URL に含めたりしないでください。変換には PDFCraft のクレジットを使用します。こちらからチャージできます。
対応状況を確認する
サービスは Streamable HTTP と MCP プロトコルバージョン 2026-07-28 を使用します。このバージョンに対応し、Bearer 認証ヘッダーを設定できるクライアントが必要です。2025 年版の古い初期化・セッション手順には対応していません。
対話式の OAuth ログインは提供していません。OAuth が必須で、Bearer API Key を設定できないクライアントは直接接続できません。
最初の変換を試す
接続すると、エージェントは利用できるツールと説明を取得できます。まず get_capabilities を呼び出して、対応形式、言語、操作手順を確認するよう依頼してください。例えば、次のように伝えます。
この PDF を EPUB に変換して。始める前に残高を確認して、料金を見積もってください。
アップロードには、エージェントがファイルの内容を読み取れる必要があります。ローカルのパスだけでは、リモートサーバーはファイルを読み取れません。その後、タスクの作成、アップロード、処理の開始、進捗の確認、ダウンロードリンクの取得を行えます。後から再開できるよう、タスクの UUID を保存してください。
通常は完全版をダウンロードします。未払い分が原因でダウンロードできない場合は、チャージ後に同じタスクのリンクを取得し直してください。不完全なファイルは、明示的に指定し、その版が利用できる場合に限って提供されます。
アプリケーションから直接利用する場合は、REST API リファレンスをご覧ください。