Unplain

Unplain MCP

アシスタントが電子書籍やレポートを執筆します。Unplain がデザインを施し、出版できる状態の PDF をお渡しします。

Unplain はホスト型のModel Context Protocolサーバーです。ドキュメントを依頼すると、アシスタントが執筆し、デザインを選び（または保存済みのブランドを適用し）、表紙を生成して、レイアウト済みの表紙、見出しから生成した目次、実際のページ番号、最後の行動喚起ページを含む完成版 PDF を書き出します。チャットを離れる必要も、デザインツールを開く必要もありません。

これにより、次の 2 つのことが可能になります。モデルに直接 PDF を作成させるのではなく、こちらを使う理由でもあります。

• 毎回同じ仕上がりになります。 ブランドテーマは保存されるため、10 冊目も 1 冊目と同じデザインになります。アシスタントがテーマを作成し、再利用できます。
• 修正にトークンはかかりません。 すべてのドキュメントは Unplain アカウント内の実際のプロジェクトで、ツールからエディターへのリンクが返されます。モデルにファイルを再生成させるのではなく、該当箇所をクリックして文章を修正できます。

Unplain はコンテンツを執筆しません。また、MCP 経由ではファイルのアップロードも受け付けません。文章はアシスタントが Markdown で提供します。.docx や .txt のアップロードはウェブアプリの機能であり、MCP の機能ではありません。

• エンドポイント： https://app.unplain.io/api/mcp
• トランスポート： Streamable HTTP
• 認証： Authorization: Bearer <api-key>（Authorization: <api-key> も使用できます）
• インストール： インストール不要
• ドキュメント： https://unplain.io/mcp
• 料金： 無料プランと Pro プランのすべてのプランに含まれます。https://unplain.io/pricing

このリポジトリはドキュメントです。サーバーはホスト型のため、インストールするパッケージも実行するソースもありません。問題や質問はお気軽にお寄せください。

公式 MCP Registry への公開については、PUBLISHING.mdをご覧ください。 マニフェストはserver.jsonです。

---

クイックスタート

1. API キーを取得する

アカウント設定で作成してください。キーは一度だけ表示されます。以下の操作は無料アカウントですべて利用できます。

2. サーバーを追加する

Claude Code

claude mcp add --transport http unplain https://app.unplain.io/api/mcp \
  --header "Authorization: Bearer unp_your_key_here"

詳しいガイド：https://unplain.io/mcp/claude-code

Codex

export UNPLAIN_API_KEY="unp_your_key_here"

codex mcp add unplain \
  --url https://app.unplain.io/api/mcp \
  --bearer-token-env-var UNPLAIN_API_KEY

詳しいガイド：https://unplain.io/mcp/codex

その他の場合

リモート MCP サーバーを追加でき、Authorization ヘッダーを送信できるクライアントであれば利用できます。次の 2 つの値が必要です。

Server URL:  https://app.unplain.io/api/mcp
Header:      Authorization: Bearer unp_your_key_here

お使いのマシン上で実行するサーバーにしか対応していないクライアントでは、まだ接続できません。

3. 接続を確認する

List the Brand Themes in my Unplain account and tell me which one is the default.

リストが空でも問題ありません。接続は有効ですが、テーマはまだ保存されていません。

4. 作成する

Write a short ebook called "The Email Welcome Sequence Playbook" with an intro
and five chapters. Use my default Brand Theme, then export the PDF.

---

ツール

ツールは 12 個あります。名前と動作は、CHANGELOG.mdに記載されたバージョン時点のものです。

ツール	説明
get_account	このキーに紐づくプランと、適用される制限を確認します。長い文章を書く前に呼び出すと便利です。
get_design_options	フォントカタログ、組み込みプリセット、各タイポグラフィ設定と間隔設定で許可される範囲を取得します。
list_brand_themes	保存済みのブランドテーマを一覧表示します。
create_brand_theme	色、フォント、リンクを設定した新しいブランドテーマを保存します。
update_brand_theme	テーマの名前、色、フォント、リンクを変更します。
create_ebook	タイトルと Markdown からプロジェクトを作成します。
list_ebooks	呼び出し元のプロジェクトを検索します。
get_ebook	プロジェクトを構造化されたアウトラインとして読み取ります。
update_ebook	段落、見出し、リストを書き換えたり、表紙の文言やスタイルを変更したり、テーマを適用したり、本文を差し替えたりします。
generate_cover_image	セクションの見出し、または指定内容をもとに、AI で表紙画像を作成します。
export_ebook	デザイン済みの PDF をレンダリングします。
get_export_status	実行中のエクスポートを確認し、ダウンロードリンクを取得します。

実際に使ううえで重要な注意点

• 編集はアトミックに行われ、バージョンが確認されます。 アシスタントが、作業中にウェブアプリで行った変更を上書きすることはありません。古いバージョンからの書き込みは、作業内容に適用されず拒否されます。
• デザインは細かく指定するのではなく、言葉で説明できます。 「厳格なモノクロのレポート」や「洗練された独立系文芸誌」と伝えると、推測ではなく、Unplain が実際にサポートしている設定から選ばれます。
• カタログにないフォントは代替されず、使用が拒否されます。 アプリで表示されるものが、そのまま PDF に反映されます。
• カバーの生成には、既存の利用枠が使われます。 アプリ内のボタンで使うものと同じ利用枠です。MCP 専用の利用枠はありません。既存のカバーを上書きするには明示的な承認が必要なため、繰り返しリクエストしても、2回目の生成が知らないうちに実行されることはありません。
• ダウンロードリンクには署名が付与され、有効期限があります。 プロジェクトは保存されるので、URL を保管するのではなく、必要に応じて再度エクスポートしてください。

---

プランと制限

MCP はインターフェースであり、料金プランではありません。キーで利用できる機能は、そのキーに紐づくアカウントとまったく同じです。また、ウェブアプリを使う場合もアシスタントを介する場合も、同じ制限が適用されます。

	Free	Pro
エクスポートした PDF のコンテンツページ数	5	無制限
保存できるプロジェクト数	5	無制限
ブランドテーマ	1	25
AI カバー	生涯で1回	期間ごとに30回
「Made with Unplain」バッジ	常に表示	取り外し可能

カバー、目次、行動喚起のページはページ数の上限に含まれません。 現在の料金：https://unplain.io/pricing

---

プロンプトの例

さらに詳しい例は examples/prompts.md をご覧ください。まずはいくつかご紹介します。

Take the Markdown in notes.md and create an Unplain ebook called "Q3 Growth
Report". Use my default Brand Theme, then wait for the export and give me the
PDF link.

Open my Unplain ebook "Q3 Growth Report", read the outline, rewrite the
introduction so it opens with a concrete number instead of a general claim,
then export a fresh PDF.

Analyse the churn data in ./data, write it up as a report with an executive
summary, three findings and a recommendation, then create it in Unplain using
my "Acme" theme and export the PDF.

---

キーを安全に保つ

パスワードと同じように扱ってください。

• Codex は環境変数からキーを読み込むため、設定ファイルにキーを記載せずに済みます。
• Claude Code の -s project は、プロジェクトのルートに .mcp.json を作成します。実際のキーを記載したファイルをコミットしないでください。 プレースホルダーを使い、各自が自分のキーを設定してください。キーは、そのキーが属するアカウントで使用されます。
• アカウント設定からキーを無効化できます。無効化はただちに反映されます。クライアントごとにキーを1つずつ使い、ほかのクライアントに影響を与えずに個別に無効化できるようにしてください。

---

トラブルシューティング

症状	原因
すべてのツール呼び出しが失敗する	キーがサーバーに届いていません。ヘッダーは Bearer （末尾にスペースあり）の後にキーを指定し、URL の末尾は /api/mcp にしてください。末尾にスラッシュを付けてはいけません。キーが無効な場合は 401 が返され、多くのクライアントでは接続失敗として報告されます。
ツールが表示されない	クライアントを再起動してください。新しいサーバーはセッション開始時に検出されます。
Codex がキーを見つけられない	Codex は起動時に環境変数を読み込みます。シェルのプロファイルでキーをエクスポートし、そのキーが設定されたシェルから Codex を起動してください。
「No Brand Themes」と表示される	接続は機能していますが、テーマがまだ保存されていません。アシスタントに作成を依頼するか、組み込みのプリセットからデザインしてください。
エクスポート時に電子書籍が長すぎると表示される	Free ではコンテンツページを最大5ページまでエクスポートできます。内容を短くするか、プランをアップグレードしてください。いずれの場合もプロジェクトは保存されます。
リクエストが多すぎる	作成とエクスポートには、アカウントごとのレート制限があります。1分ほど待ってください。

詳細：https://unplain.io/mcp

---

サポート

• ドキュメント：https://unplain.io/mcp
• メール：[email protected]
• 問題の報告：このリポジトリをご利用ください

ライセンス

このリポジトリのドキュメントとサンプルは MIT ライセンスで提供されています。Unplain サービス自体には、利用規約およびプライバシーポリシーが適用されます。