# MCP でエージェントに接続する

[HTML](https://pdfcraft.ai/ja-JP/docs/getting-started/mcp/)
[Site index](https://pdfcraft.ai/llms.txt)

AI エージェントから PDFCraft を使って PDF・EPUB を変換、翻訳できます。


リモート MCP に対応した AI エージェントに PDFCraft を接続すると、PDF から Markdown や EPUB への変換、PDF・EPUB の翻訳を依頼できます。残高の確認、料金の見積もり、変換結果の取得も可能です。

## 接続を設定する

1. [OOMOL Console](https://console.oomol.com/api-key) で自分の API Key を作成します。
2. エージェントの設定でリモート MCP サーバーを追加します。URL は `https://api.pdfcraft.ai/v1/mcp`、トランスポートは Streamable HTTP を指定します。
3. ヘッダーに `Authorization: Bearer YOUR_API_KEY` を追加し、`YOUR_API_KEY` を自分のキーに置き換えます。

以下の JSON は接続に必要な情報です。設定項目の名前はクライアントによって異なるため、それぞれの URL と HTTP ヘッダーの設定欄に値を入力してください。

```json
{
  "url": "https://api.pdfcraft.ai/v1/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}
```

キーはクライアントの保護された設定に保存してください。会話に貼り付けたり、ファイルの URL に含めたりしないでください。変換には PDFCraft のクレジットを使用します。[こちらからチャージ](https://pdfcraft.ai/ja-JP/recharge/)できます。

## 対応状況を確認する

サービスは Streamable HTTP と MCP プロトコルバージョン `2026-07-28` を使用します。このバージョンに対応し、Bearer 認証ヘッダーを設定できるクライアントが必要です。2025 年版の古い初期化・セッション手順には対応していません。

対話式の OAuth ログインは提供していません。OAuth が必須で、Bearer API Key を設定できないクライアントは直接接続できません。

## 最初の変換を試す

接続すると、エージェントは利用できるツールと説明を取得できます。まず `get_capabilities` を呼び出して、対応形式、言語、操作手順を確認するよう依頼してください。例えば、次のように伝えます。

> この PDF を EPUB に変換して。始める前に残高を確認して、料金を見積もってください。

アップロードには、エージェントがファイルの内容を読み取れる必要があります。ローカルのパスだけでは、リモートサーバーはファイルを読み取れません。その後、タスクの作成、アップロード、処理の開始、進捗の確認、ダウンロードリンクの取得を行えます。後から再開できるよう、タスクの UUID を保存してください。

通常は完全版をダウンロードします。未払い分が原因でダウンロードできない場合は、チャージ後に同じタスクのリンクを取得し直してください。不完全なファイルは、明示的に指定し、その版が利用できる場合に限って提供されます。

アプリケーションから直接利用する場合は、[REST API リファレンス](https://pdfcraft.ai/ja-JP/docs/api/overview/)をご覧ください。