メインコンテンツへスキップ

Omise Model Context Protocol (MCP) サーバー

Omise Model Context Protocol (MCP) サーバーは、Claude Desktop や Continue などの AI アシスタントに Omise 支払い操作を直接統合できます。MCP サーバーを使用して、請求、顧客、返金、送金などを自然言語会話で管理できます。

概要​

Model Context Protocol (MCP) とは?​

Model Context Protocol (MCP) は Anthropic が開発した標準で、AI アシスタントが外部データソースとツールに安全に接続できます。MCP サーバーはユーザーに代わって実際のアクション実行に使用できる特定の機能を公開します。

Omise MCP サーバーは AI アシスタントと Omise API の間の橋となり、以下が可能になります：

  • 支払いデータを照会 - 請求、顧客、送金などを取得
  • トランザクションを作成 - 支払い処理、顧客作成、返金発行
  • リソースを管理 - 顧客情報の更新、スケジュール済み請求の キャンセル
  • ワークフローを自動化 - 自然言語を使用して複雑な支払い操作を調整

主な利点​

  • 自然言語インターフェース - 会話型コマンドで Omise と対話
  • 生産性向上 - コード作成なしで定期的な支払い操作を自動化
  • 安全な認証 - API キーはローカルに保存し、AI プロバイダーには送信されない
  • リアルタイム操作 - AI アシスタント経由で実際の支払い取引を実行
  • マルチツールサポート - Claude Desktop、Continue、Cline などで機能

インストール​

前提条件​

  • Node.js 18以上 - MCP サーバーを実行するために必要
  • Omise アカウント - API キー付き
  • MCP互換クライアント - Claude Desktop、Continue、または同様のツール

npm 経由でインストール​

npm install -g @omise/mcp-server

npx を使用​

npx @omise/mcp-server

設定​

Claude Desktop セットアップ​

Claude Desktop は MCP サーバーをサポートするネイティブデスクトップアプリケーションです。Omise MCP サーバーを設定するには：

  1. 設定ファイルを見つける

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. Omise MCP サーバーを追加

    設定ファイルを編集して Omise MCP サーバーを含める：

    {
      "mcpServers": {
        "omise": {
          "command": "npx",
          "args": ["-y", "@omise/mcp-server"],
          "env": {
            "OMISE_SECRET_KEY": "skey_test_your_secret_key_here",
            "OMISE_PUBLIC_KEY": "pkey_test_your_public_key_here"
          }
        }
      }
    }

  3. Claude Desktop を再起動

    新しい設定を読み込むため、Claude Desktop を閉じて開き直してください。

  4. 接続を確認

    新しい会話を開始して「Omise 支払いを一覧表示できますか?」と聞いてください。

利用可能なツール​

Omise MCP サーバーは以下のツールを AI アシスタントに公開します：

請求操作​

  • list_charges - 請求ページネーションリストを取得
  • get_charge - 特定の請求の詳細を取得
  • create_charge - 新しい請求を作成
  • capture_charge - 認可済み請求をキャプチャ
  • reverse_charge - キャプチャされていない認可済み請求を取消
  • update_charge - 請求メタデータを更新

顧客操作​

  • list_customers - ページネーション付きで全顧客をリスト
  • get_customer - 特定の顧客を取得
  • create_customer - 新しい顧客プロフィールを作成
  • update_customer - 顧客情報を更新
  • delete_customer - 顧客プロフィールを削除

カード操作​

  • list_cards - 顧客に関連するカードをリスト
  • get_card - 特定のカード詳細を取得
  • update_card - カード情報を更新
  • delete_card - 顧客からカードを削除

返金操作​

  • list_refunds - 請求の全返金をリスト
  • get_refund - 特定の返金詳細を取得
  • create_refund - 全額または部分返金を発行

送金操作​

  • list_transfers - 銀行口座へのすべての送金をリスト
  • get_transfer - 特定の送金詳細を取得
  • create_transfer - 手動送金を作成
  • update_transfer - 送金情報を更新

ソース操作​

  • list_sources - 支払いソースをリスト
  • get_source - 特定のソース詳細を取得
  • create_source - 新しい支払いソースを作成

残高操作​

  • get_balance - 現在のアカウント残高を取得
  • get_transaction - トランザクション詳細を取得

紛争操作​

  • list_disputes - すべての紛争をリスト
  • get_dispute - 特定の紛争詳細を取得
  • update_dispute - 紛争情報を更新

イベント操作​

  • list_events - Webhook デバッグ用の API イベントをリスト
  • get_event - 特定のイベント詳細を取得

使用例​

例のプロンプト​

設定後、自然言語で Omise と対話できます：

情報の取得：

「最後の 10 件の請求を表示してください」
「現在のアカウント残高はいくらですか?」
「請求 chrg_test_5v7h8gp2xqf0v0k4zy7 の詳細を取得」
「今月作成された全顧客をリスト」

リソースの作成：

「カードトークン tokn_test_123 で 10000 THB の請求を作成」
「メール customer@example.com で新しい顧客を作成」
「請求 chrg_test_5v7h8gp2xqf0v0k4zy7 の全額返金を発行」

リソースの更新：

「顧客 cust_test_123 を電話番号 +66812345678 で更新」
「請求 chrg_test_5v7h8gp2xqf0v0k4zy7 をキャプチャ」
「請求 chrg_test_5v7h8gp2xqf0v0k4zy7 にメタデータ order_id: 12345 を追加」

セキュリティに関する考慮事項​

API キーストレージ​

重要なセキュリティ実施：

  1. API キーをコミットしない - バージョン管理に保存しない
  2. 開発ではテストキーを使用 - skey_test_* キーを常に使用
  3. 設定ファイルを保護 - 設定ファイルの権限を制限
  4. 環境固有キー - テスト/本番には異なるキーを使用
  5. 定期的なキーローテーション - 本番キーを定期的にローテーション

ファイル権限を設定​

MCP 設定のファイル権限を設定：

# macOS/Linux
chmod 600 ~/Library/Application\ Support/Claude/claude_desktop_config.json

# 権限を確認
ls -la ~/Library/Application\ Support/Claude/claude_desktop_config.json

ベストプラクティス​

開発ワークフロー​

  1. 常にテストモードを使用

    開発中は全てテストキーを使用
    実際のデータでテストしない

  2. 実行前に確認

    請求金額と顧客詳細を確認
    MCP で生成されたトランザクションを記述メタデータで追跡

  3. エラーを適切に処理

    操作が失敗した場合、Claude にエラーを説明させる
    API ドキュメントでエラーコードの意味を確認

プロンプトエンジニアリング​

最高の結果を得るために明確で具体的なプロンプトを記述します：

良いプロンプト：

「最後の 10 件の成功した請求を表示」
「カードトークン tokn_test_123 で 5000 THB の請求を作成」
「請求 chrg_test_456 の 50% を返金」

効果が薄いプロンプト：

「いくつかの請求を表示」
「支払いを実行」
「その請求を修正」

トラブルシューティング​

MCP サーバーが読み込まれない​

症状： Claude Desktop に Omise ツールが表示されない

解決方法：

  1. 設定ファイルの構文を確認（有効な JSON）
  2. ファイルパスがオペレーティングシステムと一致することを確認
  3. Node.js がインストール及びアクセス可能であることを確認
  4. Claude Desktop を完全に再起動
  5. コンソールログでエラーメッセージを確認

認証失敗​

症状： 「無効な API キー」またはエラー

解決方法：

  1. API キーが正しいことを確認（余分なスペースがない）
  2. 正しい環境（テスト vs ライブキー）を確認
  3. Omise ダッシュボードでキー権限を確認
  4. JSON でキーが適切にクォーテーションされていることを確認
  5. Omise API で直接キーをテスト

FAQ​

MCP と直接 API 統合の違いは何ですか?

MCP は AI アシスタントを通じて Omise API への自然言語インターフェースを提供し、直接 API 統合はコード記述が必要です。MCP は以下に最適：

  • 単発操作及びテスト
  • カスタマーサポートタスク
  • 財務照合
  • ラピッドプロトタイピング

直接 API 統合は以下に適しています：

  • 本番支払いフロー
  • 大量操作
  • カスタムビジネスロジック
  • 完全な制御
MCP を本番環境で使用できますか?

はい、ですが注意が必要です。MCP は運用タスク、カスタマーサポート、管理操作に適しており、顧客向け支払いフローには直接 API 統合を使用してください。常に：

  • ライブキーは必要な場合のみ使用
  • 適切なアクセス制御を実装
  • すべての操作を監査
  • ユーザーにセキュリティベストプラクティスについて教育
  • 定期的に使用状況を監視
どの AI アシスタントが Omise MCP サーバーをサポートしていますか?

Omise MCP サーバーは MCP 互換クライアントで機能：

  • Claude Desktop - Anthropic ネイティブデスクトップアプリ
  • Continue - VS Code 用オープンソース AI コードアシスタント
  • Cline - VS Code 拡張機能
  • その他 MCP クライアント - MCP 標準を実装するツール

関連リソース​

Omise ドキュメント​

MCP リソース​

クライアントドキュメント​

次のステップ​

はじめよう​

  1. MCP サーバーをインストール

    npm install -g @omise/mcp-server

  2. Claude Desktop を設定

    Omise MCP サーバーを設定に追加

  3. 接続をテスト

    Claude にアカウント残高を取得するよう依頼

  4. 機能を探索

    異なるプロンプトと操作を試す

高度な使用法​

  • ワークフローを自動化 - 複数ステップ操作を作成
  • カスタムプロンプトを構築 - 一般的なタスク用テンプレートを開発
  • CI/CD と統合 - 自動テストに MCP を使用
  • チーム トレーニング - ベストプラクティスを共有

その他の参考資料​

ヘルプが必要ですか?​

AI で支払い操作を自動化する準備はできていますか? 今すぐ MCP サーバーをインストールしてください!