Unplain MCP

あなたのアシスタントが電子書籍やレポートを執筆します。Unplain がデザインを施し、公開可能な PDF を仕上げて返します。

Unplain はホスト型の Model Context Protocol サーバーです。ドキュメントを依頼すると、アシスタントが執筆し、デザインを選び（または保存済みのブランドを適用し）、表紙を生成し、構成済みの表紙・見出しから作成された目次・実際のページ番号・締めくくりのコールトゥアクションページを備えた完成済み PDF を書き出します。チャットから離れる必要も、デザインツールを開く必要もありません。

そこから二つのことが導かれます。これこそが、モデルに直接 PDF を依頼するのではなく、これを利用する理由です。

• 毎回同じ結果が得られます。 ブランドテーマは保存されるため、10 個目のドキュメントも 1 個目と一致します。アシスタントが作成して再利用できます。

• 修正にトークンがかかりません。 すべてのドキュメントは Unplain アカウント内の実際のプロジェクトであり、ツールはエディタのリンクを返します。文を修正するには、モデルにファイルの再生成を依頼するのではなく、そのリンクをクリックします。

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

• エンドポイント: https://app.unplain.io/api/mcp

• トランスポート: Streamable HTTP

• 認証: Authorization: Bearer <api-key>（ベアの Authorization: <api-key> も受け付けます）

• インストール: インストール不要

• ドキュメント: https://unplain.io/mcp

• 料金: すべてのプラン（Free および Pro）に含まれます。https://unplain.io/pricing

このリポジトリはドキュメントです。サーバーはホスト型のため、インストールするパッケージも実行するソースもありません。問題や質問はこちらで受け付けています。

公式 MCP レジストリへの公開については、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.

Related MCP server: MCP MD2PDF Server

ツール

12 個のツールがあります。名前と動作は CHANGELOG.md のバージョンの時点のものです。

実際に重要な注意点

• 編集はアトミックかつバージョン検証付きです。 アシスタントが、その間に Web アプリで行った変更を上書きすることはできません。古い書き込みは、作業の上に適用されるのではなく拒否されます。

• デザインは指定ではなく記述で行えます。 「無機質なモノクロのレポート」や「上品な独立系文芸雑誌」といった記述は、推測ではなく Unplain が実際にサポートするものから選ばれた実際の設定に解決されます。

• カタログ外のフォントは代替されず拒否されます。 アプリで見えるものがそのまま PDF に反映されます。

• 表紙の生成は既存の割り当てを使用します。 アプリのボタンが使用するものと同じです。MCP 専用の割り当てはありません。既存の表紙の上書きには明示的な承認が必要なため、同じリクエストを繰り返しても、黙って 2 回目の生成が消費されることはありません。

• ダウンロードリンクは署名付きで期限があります。 プロジェクトは保存されているので、URL を保持するのではなく、再度エクスポートしてください。

プランと制限

MCP はインターフェースであり、ティアではありません。キーはその背後にあるアカウントとまったく同じ機能を持ち、Web アプリで作業してもアシスタント経由で作業しても、同じ制限が適用されます。

表紙、目次、コールトゥアクションページはページ数の制限にカウントされません。現在の料金: 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 つのキーを保持し、他のキーに影響を与えずに 1 つを失効させられるようにしてください。

トラブルシューティング

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

サポート

• ドキュメント: https://unplain.io/mcp

• メール: info@unplain.io

• 問題: このリポジトリを使用してください

ライセンス

このリポジトリのドキュメントと例は MIT ライセンスです。Unplain サービス自体は、利用規約 と プライバシーポリシー に準拠します。