フリップブックを自動生成するAIエージェントを作る

もし“今月のレポートをフリップブックとして公開する”という作業を、コンピューターが自分で片付けてくれたら—ダッシュボードも、アップロードも、共有リンクをメールにコピペする手間もなしに。それがドキュメント向けAIエージェントの魅力です。ほしい結果を伝えるだけで、エージェントが適切なツールを適切な順番で呼び出し、実現してくれます。

このチュートリアルでは、FlipLink MCPサーバーとClaudeを使って、その仕組みを作る方法を紹介します。エージェントは、生成したばかりのPDFレポートを受け取り、そこからフリップブックを作成し、公開し、共有リンクを返します—スケジュールに乗せてあとは放っておける、そんなタイプの作業です。あわせて、完全に無人で動くエージェントが現実的な限界にぶつかる場面や、シンプルなスクリプト（CLI）のほうが適している場面についても、正直にお伝えします。

シナリオ：月次レポートの自動公開

定期的なジョブを思い浮かべてください。毎月1日になると、何らかのパイプラインがreport.pdfを生成します—売上の数字、ニュースレター、取締役会向けの資料など。今は人がそれをダッシュボードにアップロードし、公開し、リンクをコピーして、どこかに貼り付けています。この一連の流れを、すべての手順を書き込まなくても各ステップを判断できるエージェントで自動化したい、というわけです。

エージェントに必要なのは、ファイルからフリップブックを作成し、公開し、共有リンクを取得できることです。FlipLink MCPサーバーを接続すれば、これらはモデルが直接呼び出せる実際のツールに対応します。

ステップ1 — MCPサーバーを接続する

Model Context Protocolは、AIクライアント（Claude、Cursorなど）が外部ツールを発見して呼び出すための仕組みです。FlipLink MCPサーバーは、FlipLink APIを、モデルが会話の中で使える一連のツールとして公開します。

詳しい手順については、MCPサーバーでFlipLinkをClaudeに接続するをご覧ください。手短に言えば—手動でインストールするものは何もなく、クライアントがnpxで起動します。

claude mcp add fliplink -e FLIPLINK_API_KEY=YOUR_API_KEY -- npx -y fliplink-mcp

または、mcpServersの設定ブロックとして（Claude Desktop、Cursor、Codex）：

{
  "mcpServers": {
    "fliplink": {
      "command": "npx",
      "args": ["-y", "fliplink-mcp"],
      "env": { "FLIPLINK_API_KEY": "YOUR_API_KEY", "FLIPLINK_MCP_MODE": "safe" }
    }
  }
}

ツールはFlipLinkの仕様から生成され、<noun>_<verb>という名前が付きます—そのためエージェントには、flipbook_create_by_file、flipbook_publish、flipbook_get_share_link、そしてトップレベルのヘルスチェックwhoamiなどが見えます。キーはgo.fliplink.meにサインインして取得してください。

ステップ2 — エージェントのプロンプトを書く

エージェントとは、要するにモデルとループの組み合わせです。ゴールを読み、どのツールを呼ぶか決め、結果を読み、次に何をするか決める—これをゴールが達成されるまで繰り返します。そのループの質は、ツール名・順番・成功条件を明確に示したプロンプトでほぼ決まります。

月次レポート用エージェントの、現実的なシステム／タスクプロンプトの例がこちらです。

SYSTEM:
You are a publishing agent for FlipLink. Your job is to turn a PDF report
into a published flipbook and return its share link. You have FlipLink MCP
tools available (names follow the pattern noun_verb).

Operating rules:
1. Start by calling `whoami` to confirm the API key works and check the
   remaining flipbook quota. If `whoami` fails, STOP and report the error.
2. Create the flipbook from the file with `flipbook_create_by_file`
   (field File = the PDF path; set Name and Title from the task).
3. Read the result. Every FlipLink response has a top-level `Result` field
   that is "OK" or "ERROR". If `Result` is "ERROR", STOP and report the
   `Message` — do NOT retry blindly or proceed.
4. On success, capture the returned flipbook ID.
5. Publish it with `flipbook_publish` using that ID. Check `Result` again.
6. Fetch the share link with `flipbook_get_share_link`.
7. Report back: the flipbook ID, the published share URL, and the quota left.

Never invent tool names or IDs. If a step has no clear next action,
stop and explain rather than guessing.

TASK:
Publish this month's report. File: ./reports/2026-06-report.pdf
Title: "June 2026 Report". Name: "june-2026-report".

このプロンプトがうまく機能する理由は二つあります。まず、エージェントに**Resultフィールドで分岐するよう**指示している点です—FlipLinkはアプリケーションエラーをHTTP 200かつResult: "ERROR"として返すので、単純な“呼び出しは200を返したか？”というチェックでは、失敗を黙って成功として扱ってしまいます。次に、すべての失敗パターンに明確な停止条件を与えている点です。これにより、無人での実行がリトライの無限ループに陥らずに済みます。

ステップ3 — 無人実行のためのガードレール

ここは現実をしっかり見据える必要があります。MCPのデフォルトモードはsafe（79ツール）です。読み取りと、元に戻せる書き込みを許可し、削除ツールと課金系ツールはなしです。今回の月次レポート用エージェントが行うのは、作成・公開・読み取りだけ—いずれもsafeモードの範囲に収まります—なので、このジョブではデフォルトのままで構わず、エージェントは引っかかりなく最初から最後まで動きます。

破壊的なアクションは話が別です。もしエージェントがフリップブックを削除したり、価格や売上に触れたりする必要があるなら、fullモード（87ツール）で動かさなければなりません。fullモードでは、削除ツールと課金系ツールは最初の呼び出しでは決して実行されません。サーバーは1行のプレビューと、有効期限の短いconfirm_token（厳密な引数に紐づき、5分で失効）を返し、アシスタントはそのトークンを付けて再度呼び出す必要があります。このゲートはサーバー側に存在します—FlipLink API自体は変更されていません。

“完全に自律的”という言葉が何を意味するのか、正直に整理しておきましょう。

• safeモードで「読み取り→作成→公開」を行うエージェントは、無人でクリーンに動かせます。行うことのどれにもゲートはかかりません。
• ものを削除するエージェントは、引っかかりがないことと無人であることを、同時には満たせません。confirm-tokenのゲートは意図的に置かれています。破壊的なステップは人が承認するか、あるいはハーネスをfullモードで動かし、プレビュー→confirm-token→再呼び出しというハンドシェイクをコードで明示的に処理するか、どちらかです。フリップブックが確認なしに勝手に削除される、という前提でパイプラインを設計してはいけません—そうはなりませんし、そこが肝心なところです。

モードの全体像とconfirm-tokenの流れについては、MCPサーバーの安全性とガードレールをご覧ください。各ツールはMCPアノテーション（readOnlyHint、destructiveHint、idempotentHint）も持っているので、慎重に作られたハーネスは、何かを呼び出す前にリスクを判断できます。

🚀

FlipLinkを無料で試す

PDFを数秒で変換。登録もクレジットカードも不要 — アップロードするだけです。

Drop your PDF here or click to browse

最大40MB

$39 からの有料プランなら、上限が 150 MB に広がります。

ステップ4 — スケジュールに乗せる

手動で安定して動くようになったら、タイマーに乗せましょう。やり方はクライアントによります—タスクプロンプトを渡してClaudeをヘッドレスで起動するcronジョブ、スケジュールされたワークフロー、あるいは独自のオーケストレーションなど。その仕組みは本記事の範囲外ですが、大事なのは、スケジュール実行を安全にするのはプロンプトとモードであって、スケジューラー自体ではない、ということです。作成・公開のジョブではエージェントをsafeモードに保てば、確認の壁にぶつかることなく無人で実行できます。

ステップ5 — 出力を検証する

“エージェントがうまくいったと言った”を鵜呑みにしてはいけません。実際の成果物を検証しましょう。

• エージェントの最終報告には、フリップブックIDと共有URLが含まれているはずです。そのURLを開いてください—公開されたフリップブックが表示されるはずです。
• 作成の前後でwhoamiのクォータを確認しましょう。これで、作成処理が黙ってエラーになったのではなく、実際にスロットを1つ消費したことが分かります。
• すべてのツール結果にResultフィールドが付いているので、よくできたエージェントは失敗時に正確なMessageを表示します。実行結果がResult: "ERROR"を報告したら、再実行ではなくメッセージを読んでください—クォータの上限やファイルサイズ超過は、リトライしても解消しません。

CLIのほうが適している場面

ここまでの内容に対する、正直な反論がこれです。CIで動かす、ヘッドレスで決定論的なジョブには、たいていLLMエージェントなど不要です。

AIエージェントが真価を発揮するのは、タスクに判断が必要なとき—何かにどんなタイトルを付けるか決める、曖昧な入力に反応する、あなたが完全には書き出していないステップをつなぐ、といった場面です。けれども「この特定のファイルを取り、フリップブックを作り、公開し、リンクを表示する」には、曖昧さがまったくありません。そのためにLLMを動かすと、何の見返りもないままコスト・レイテンシ・非決定性が増え、しかも同じResult分岐は結局自分で処理しなければなりません。

その用途には、FlipLink CLIを使いましょう。MCPサーバーやAPIと同じ仕様から生成されているのでズレようがなく、しかもクリーンな終了コード（0は成功、1はリクエストエラー、2はアプリケーションエラー）を返すので、CIはパース不要でそのまま分岐できます。

fliplink config set-key "$FLIPLINK_API_KEY"
ID=$(fliplink flipbook create ./reports/2026-06-report.pdf \
  --title "June 2026 Report" --name june-2026-report --json | jq -r '.ID')
fliplink flipbook publish "$ID"
fliplink flipbook share-link "$ID"

これで月次ジョブはすべて完了、モデルは不要です。継続的インテグレーションの中で動かす場合も含めた完全なパイプラインについては、CI/CDでフリップブックの公開を自動化するをご覧ください。

目安はこうです。判断が必要なタスクにはAIエージェントを、毎回同じであるべきタスクにはCLIを使う。 多くのチームは両方を使い分けています—その場限りの「これを公開しておいて」という依頼にはエージェントを、スケジュールされた機械的な実行にはCLIを、という具合です。

作り始めよう

ドキュメント向けAIエージェントは、公開作業から手作業の中間部分を取り除きます。結果を伝えれば、エージェントがツールを呼び出します。FlipLink MCPをsafeモードにしておけば、作成・公開を行うエージェントが引っかかりなく最初から最後まで動きます—そして破壊的なアクションが絡む場面では、confirm-tokenのゲートが、無人実行を危険にではなく誠実に保ちます。

準備はいいですか？MCPサーバーを接続し、エージェントをレポートに向け、公開される様子を見てみましょう。決定論的なCIの道筋なら、CLIドキュメントが役立ちます。エンドポイントの完全な一覧はAPIリファレンスにあります。

関連記事

• MCPサーバーでFlipLinkをClaudeに接続する
• MCPサーバーの安全性とガードレール
• 自然言語によるフリップブックの自動化
• CI/CDでフリップブックの公開を自動化する
• FlipLink CLIドキュメント
• FlipLink APIリファレンス