🧠 Model Context Protocol (MCP) Guide for Refund Protect Integration

🧠 Refund Protect 統合のための Model Context Protocol（MCP）ガイド

1. MCP の概要

**Model Context Protocol（MCP）**は、LLM エージェント（ChatGPT や Claude など）が共有コンテキストを通じて API やツールと動的に連携できるようにするプロトコルです。MCP は自然言語インターフェースとプログラム可能なシステムの間をつなぎ、構造化されたプロンプトを通じて、コードの実行、API 呼び出し、プラグインの利用をコンテキストに応じて行えるようにします。

公式ドキュメント

2. 公式 MCP サーバーの例

2.1 公式リファレンスサーバーでは、MCP の主要機能と SDK の使用方法を紹介しています。

• Slack：チャンネル管理とメッセージング機能
• Google Drive：Google Drive のファイルへのアクセスと検索機能
• GitHub：リポジトリ管理、ファイル操作、GitHub API との連携

その他の例

3. エージェントの設定

3.1 クライアントエージェントとは？

クライアントエージェントは、MCP 仕様を使用して外部のツールやサービスと連携するように設定された AI モデルまたはチャットボット（ChatGPT、Claude、DeepSeek）です。これらのエージェントはプロンプトを解釈し、MCP 対応ツールを通じてアクションを実行できます。

3.2 MCP 統合に対応しているエージェント

• Cursor
• Claude（Cursor 経由）
• Windsurf by Codeium
• ChatGPT（近日対応予定）

3.3 ChatGPT のサポート

MCP 対応 ChatGPTは近日対応予定です。統合後は、ChatGPT Pro 環境で同じ MCP コマンドを使用し、ツールのコンテキストを保持したまま、API とのやり取りを効率化できるようになります。

---

4. Refund Protect MCP サーバー

Refund Protect MCP サーバーは、自然言語を使用してProtect Group APIとやり取りできるAIサーバーエージェントです。公式APIでサポートされている見積もりの作成、取引、キャンセルなど、さまざまな機能を利用できます。

プロンプトエンジニアリングを活用することで、Refund Protect の統合方法をバイブコーディングできます。ソースコードへの Refund Protect コンテンツのインストールとレンダリングから、Protect Group API に接続する各種プログラミング言語やフレームワークでのサービス作成まで行えます。

---

5. MCP サーバーのセットアップ

AI エージェントごとに MCP サーバーの設定方法は異なります。以下の JSON を使用して Refund Protect サーバーを追加してください。

{
  "mcpServers": {
    "rp-mcp-server": {
      "command": "npx",
      "args": ["-y", "@abelpenton_dev/rp-mcp-server"]
    }
  }
}

5.1 Claude でのセットアップ

1. Claude デスクトップをダウンロードします。
2. Claude Desktop で「Settings」をクリックします。
3. Developer Section に移動します。
4. 「Edit Config」をクリックします。
5. claude_desktop_config.json ファイルに RP サーバーの設定を追加します。
6. アプリを再起動し、自然言語で Claude へのプロンプトを開始します。

5.2 Cursor でのセットアップ（開発者向け）

1. Cursor IDE をダウンロードします。
2. Cursor を開き、MCP Setting に移動します。
3. 「Add new global MCP Server」をクリックします。
4. mcp.json ファイルに RP サーバーの設定を追加します。
5. Ctrl + I でエージェントモードのチャットを開きます。
6. MCP 対応インターフェースでプロンプトを入力し、ツールとのやり取りを開始します。

---

6. Refund Protect API を使った対話型プロンプト

MCP ツールを通じて Refund Protect API を操作するには、以下のプロンプトを使用します。

プロンプトの例：

Refund Protect API の API 認証情報は以下のとおりです。 ベンダーコード：vendorCode シークレット：secret

7 月 15 日のフライトについて、540 EUR を支払いました。Refund Protect の見積もりを提示してください。

見積もり quoteID の詳細を教えてください。

生成した見積もりを使用して、Refund Protect の取引を作成してください。

予約参照番号 bookingReference の取引の詳細を教えてください。

予約参照番号 bookingReference の取引をキャンセルしてください。

---

7. Refund Protect 統合のバイブコーディング

インストール可能または埋め込み可能なコードを自動生成するには、以下のツールプロンプトを使用します。

プロンプトの例：

Refund Protect の JavaScript ウィジェットをインストールするコードと、ウィジェットをレンダリングするコードを生成してください。

Refund Protect の React コンポーネントをインストールしてレンダリングするコードを生成してください。

Refund Protect の見積もりリクエストを実装する Dotnet サービスを作成してください。

---

8. チャットの例

MCP 対応のプロンプトを使用した、実際の会話の例を紹介します。

User: I need a Refund Protect quote for my hotel booking on May 22. It cost 320 EUR.
Agent: Sure, fetching the quote for 320 EUR on May 22…
→ Executes refundProtectQuoteTool

User: Can you show me the details of that quote?
→ Executes refundProtectQuoteLookupTool

User: Book it using that quote.
→ Executes refundProtectSalesTool

User: Actually, cancel the booking. Use the reference code I gave earlier.
→ Executes refundProtectCancelTool

---

9. Refund Protect MCP サーバーで利用できるツール

Refund Protect MCP サーバーで利用できるツールは次のとおりです。

refundProtectQuoteTool – Refund Protect の見積もりを取得します。

refundProtectQuoteLookupTool – 既存の Refund Protect の見積もりの詳細を取得します。

refundProtectSalesTool – Refund Protect の見積もりを使用して取引を作成します。

refundProtectSalesLookupTool – 予約参照番号を使用して、取引の詳細を取得します。

refundProtectCancelTool – 予約参照番号を使用して取引をキャンセルします。

rpWidgetInstallation – Refund Protect JavaScript ウィジェットをインストールするコードを生成します。

rpWidgetRender – Refund Protect JavaScript ウィジェットをレンダリングするコードを生成します。

rpReactComponentInstallationTool – Refund Protect React コンポーネントをインストールするコードを生成します。

rpReactComponentRenderTool – Refund Protect React コンポーネントをレンダリングするコードを生成します。

apiQuoteImplementation – Refund Protect の見積もりリクエストを実装する C# サービスを作成します。