iReceipt.pro

iReceipt.pro — MCP のセットアップ

ホスト型の**Model Context Protocol（MCP）**サーバーを通じて、AI アシスタントをお使いの iReceipt.pro アカウントに接続します。iReceipt.pro は REST API を通じて HTML（Mustache）テンプレートを PDF、PNG、JPG、WEBP に変換します。MCP サーバーを使うと、アシスタントがテンプレートを作成し、チェックできます。ローカルでのセットアップも API キーも不要です。サーバーはリモートで、OAuth 2.1 によって保護されているため、iReceipt.pro アカウントで一度サインインするだけです。

• サーバー： ireceipt-pro
• トランスポート： ストリーミング可能な HTTP
• URL： https://mcp.ireceipt.pro/mcp
• 認証： OAuth 2.1（認可コード＋PKCE）— サインインを求められます。

できること

接続すると、アシスタントはプライベートテンプレートと公開ギャラリーを利用し、テンプレートを使用する前にチェックしたり、プレビューをレンダリングしたりできます。

ツール	機能
list_templates	プライベートテンプレートや公開ギャラリーの一覧を表示します（ID、名前、ページサイズ）。
get_template	テンプレートの HTML、サンプル引数、ページボックスを取得します。
create_template	プライベートテンプレートを作成します（プランのテンプレート上限内）。
update_template	プライベートテンプレートを部分的に更新します。
delete_template	プライベートテンプレートを完全に削除します。
validate_template	無料の静的チェックです。Mustache の構文、変数、レンダラーで問題となる要素を確認します（スクリプト、ネットワークアクセスなし）。
preview_template	保存済みまたは未保存の HTML を画像にレンダリングします。毎月の利用枠を 1 回分消費します。
get_template_guide	トピック別のテンプレート作成ガイドです。

---

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

/plugin marketplace add ireceipt-pro/mcp-setup
/plugin install ireceipt-pro@ireceipt-pro
/reload-plugins

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

マーケットプレイスを使わない場合は、サーバーを直接追加します。

claude mcp add --transport http ireceipt-pro https://mcp.ireceipt.pro/mcp

---

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

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

Claude Desktop / claude.ai コネクター

1. Settings → Connectors → Add custom connector を開きます。
2. 名前：iReceipt.pro
3. URL：https://mcp.ireceipt.pro/mcp
4. 保存してから接続し、プロンプトが表示されたらサインインします。

Cursor

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

{
  "mcpServers": {
    "ireceipt-pro": {
      "url": "https://mcp.ireceipt.pro/mcp"
    }
  }
}

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

{
  "servers": {
    "ireceipt-pro": {
      "type": "http",
      "url": "https://mcp.ireceipt.pro/mcp"
    }
  }
}

---

認証

サーバーは次の OAuth 2.1 機能を実装しています。

• 認可コードグラント＋PKCE（S256）、リフレッシュトークン。
• 動的クライアント登録（RFC 7591）— クライアントは自動的に登録されます。
• スコープ：templates:read、templates:write、templates:render、offline_access。
• ディスカバリードキュメント：
  • https://mcp.ireceipt.pro/.well-known/oauth-protected-resource
  • https://mcp.ireceipt.pro/.well-known/oauth-authorization-server
  • https://mcp.ireceipt.pro/.well-known/openid-configuration

同意画面は dashboard.ireceipt.pro に表示されます。トークンはお使いのアカウントに発行されるため、アシスタントが表示・変更できるのはお客様のテンプレートだけです。アシスタントの接続を解除するには、ダッシュボードの Agents を開いて Forget を押します。

ガイド付きのプロンプト（create_template、fix_template、template_guide）と template-guide リソースも公開されているため、アシスタントは適切なワークフローを自動的に見つけられます。

---

トラブルシューティング

• 401 Unauthorized／再度サインインを求められる — アクセストークンの有効期限が切れています。クライアントの接続／認可操作をもう一度実行してください。
• ツールが表示されない — クライアントで OAuth フローが完了していることを確認してください（Claude Code では、/mcp にサーバーが connected と表示されます）。
• プレビューがクォータに関するメッセージとともに失敗する — preview_template はプランの利用枠を消費します。ほとんどの問題は無料の validate_template で事前に検出できます。
• 別のアカウントにつながっている — ダッシュボードで接続を解除し（Agents → Forget）、再度接続してください。

サポート

• ウェブサイト：https://ireceipt.pro
• ダッシュボード：https://dashboard.ireceipt.pro
• API ドキュメント：https://api.ireceipt.pro
• サポート：[email protected]