PDF to Markdown

PDF to Markdown — MCP セットアップ

[ホスト型の Model Context Protocol（MCP） サーバーを通じて、AI アシスタントを pdf2md に接続できます。PDF を、表や画像も含めて、きれいな Markdown に変換します。dudko.dev アカウントで一度サインインすればよく、API キーを貼り付ける必要はありません。

サーバーは pdf2md HTTP API への入り口であり、コンバーターではありません。ドキュメントがモデルやサーバーを経由することはありません。アシスタントがリクエストを作成し、PDF がある場所で実行します。

• サーバー： pdf-to-md
• トランスポート： ストリーマブル HTTP
• URL： https://pdf2md.dudko.dev/mcp
• 認証： auth.dudko.dev 経由の OAuth 2.1 — サインインを求められます。

できること

どちらも無料で使える 2 つのツールです。

ツール	機能
api_access	pdf2md API の仕組みを説明します。エンドポイント、オプション、制限、エラーについて確認できます。
api_request	変換オプション（convert、detect、text）を確認し、アカウント用の 15 分間有効な認証情報を含む、正確なリクエスト（URL、ヘッダー、curl コマンド）を返します。

---

Claude Code にインストールする（プラグイン）

/plugin marketplace add dudko-dev/pdf-to-md-mcp-setup
/plugin install pdf-to-md@pdf-to-md
/reload-plugins

その後、/mcp を実行し、プロンプトが表示されたらサインインを完了してください。

マーケットプレイスを使わずにインストールする場合は、サーバーを直接追加します。

claude mcp add --transport http pdf-to-md https://pdf2md.dudko.dev/mcp

---

他のクライアントから接続する

リモート URL もサインイン方法も同じです。異なるのは設定の場所だけです。

Claude Desktop / claude.ai コネクター

1. 設定 → コネクター → カスタムコネクターを追加を開きます。
2. 名前：PDF to Markdown
3. URL：https://pdf2md.dudko.dev/mcp
4. 保存してから接続し、プロンプトが表示されたらサインインします。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）：

{
  "mcpServers": {
    "pdf-to-md": {
      "url": "https://pdf2md.dudko.dev/mcp"
    }
  }
}

VS Code（GitHub Copilot / MCP）およびその他のクライアント

{
  "servers": {
    "pdf-to-md": {
      "type": "http",
      "url": "https://pdf2md.dudko.dev/mcp"
    }
  }
}

---

認証

このサーバーは OAuth 2.1 リソースサーバーです。最初の呼び出しでは、保護されたリソースのメタデータを示す WWW-Authenticate ヘッダーとともに 401 が返されます。

• https://pdf2md.dudko.dev/.well-known/oauth-protected-resource/mcp

このメタデータでは、認可サーバーとして https://auth.dudko.dev が指定されています（スコープ usage）。準拠している MCP クライアントはこれを自動的に検出するため、必要なのはサーバー URL だけです。dudko.dev アカウントでサインインしてください。トークンは https://pdf2md.dudko.dev/mcp を対象とするよう制限されており、他の場所では拒否されます。

サーバー自体は ファイルもコンテンツも保持しません。サーバーのツールが返すのは、サインインしたアカウント用の有効期間が短い認証情報（15 分間有効、この API 専用）を含む、すぐに実行できる HTTP リクエストです。アシスタントはファイルがある場所でそのリクエストを実行し、API は呼び出し元に直接応答します。各リクエストは他の API 呼び出しと同様にアカウントのプランに計上されます。MCP ツール自体は無料です。

---

トラブルシューティング

• 401 / 再度サインインを求められる — トークンの有効期限が切れています。クライアントで再接続してください。
• 「プランを使い切りました」 / 402 — アカウントの変換クォータを使い切っています。再試行しても解決しません。https://auth.dudko.dev/account を確認してください。
• /convert からの 422 — PDF はテキストレイヤーのないスキャン画像です。pdf2md は OCR を行いません。変換を実行する前に detect で確認できます。
• ツールが表示されない — クライアントでサインインが完了しているか確認してください（Claude Code では /mcp に connected と表示されます）。

サポート

• ウェブサイト： https://pdf2md.dudko.dev
• API ドキュメント： https://pdf2md.dudko.dev/api
• エージェント向け： https://pdf2md.dudko.dev/llms.txt
• お問い合わせ： [email protected]