Omise Model Context Protocol (MCP)

AIエージェントがOmise MCPサーバーを使用してOmise APIと連携できるようにします。

Omise Model Context Protocol (MCP) サーバーは、AIエージェントが決済処理、顧客管理、財務業務のためにOmise APIと連携するための一連のツールを提供します。

CursorなどのAI搭載コードエディタやClaude Desktopなどの汎用ツールを使用している場合、当社のMCPサーバーをご利用いただけます。

前提条件

Omise MCPサーバーをインストールする前に、以下の前提条件がインストールされていることを確認してください。

必要なソフトウェア

Node.js 20+: JavaScript実行環境(npmパッケージマネージャーを含む)

注: TypeScriptおよびその他の依存関係は、omise-mcpディレクトリでnpm installを実行すると自動的にインストールされます。

インストール手順

インストール手順については、Node.jsのインストールを参照してください。

Omise APIキー

OmiseアカウントとAPIキーが必要です:

1. Omiseダッシュボードにアクセス
2. アカウントを作成またはログイン
3. 設定 → キーに移動
4. APIキーを取得:
   • テスト環境: pkey_test_およびskey_test_で始まるキーを使用
   • 本番環境: pkey_live_およびskey_live_で始まるキーを使用

重要: 開発中は常にテストキーを使用し、本番環境でのみライブキーを使用してください。

ローカルサーバー

お好みの開発環境のセットアップ手順に従って、ローカルOmise MCPサーバーを実行します。

Claude

Claude DesktopでOmise MCPをセットアップするには:

1. GitHubからomise-mcpをダウンロード
2. コマンドプロンプトでomise-mcpディレクトリに移動し、npm installを実行してすべての依存関係をインストールします。
3. Claude Desktopをダウンロードしてインストール
4. Claude Desktopを開き、設定に移動します。開発者をクリックし、次に設定を編集をクリックします。
   
5. claude_desktop_config.jsonファイルを編集します。内容は以下のようになります:

   {
     "mcpServers": {
       "omise-mcp-server": {
         "command": "/opt/homebrew/bin/npx",
         "args": [
           "tsx",
           "/path/to/your/omise-mcp/src/index.ts"
         ],
         "cwd": "/path/to/your/omise-mcp/",
         "env": {
           "NODE_ENV": "prod",
           "OMISE_ENVIRONMENT": "test",
           "OMISE_API_VERSION": "2019-05-29",
           "OMISE_PUBLIC_KEY": "<<YOUR_PUBLIC_KEY>>",
           "OMISE_SECRET_KEY": "<<YOUR_SECRET_KEY>>",
           "OMISE_BASE_URL": "https://api.omise.co",
           "OMISE_VAULT_URL": "https://vault.omise.co",
           "OMISE_TIMEOUT": "30000",
           "OMISE_RETRY_ATTEMPTS": "3",
           "OMISE_RETRY_DELAY": "1000",
           "SERVER_NAME": "omise-mcp-server-prod",
           "SERVER_VERSION": "1.0.0",
           "TOOLS": "all",
           "LOG_LEVEL": "info",
           "LOG_FORMAT": "json",
           "LOG_REQUESTS": "true",
           "LOG_RESPONSES": "false",
           "RATE_LIMIT_ENABLED": "true",
           "RATE_LIMIT_MAX_REQUESTS": "500",
           "RATE_LIMIT_WINDOW_MS": "60000"
         }
       }
     }
   }
   

   注: /path/to/your/omise-mcp/src/index.tsを、ダウンロードしたomise-mcpフォルダ内のindex.tsファイルへの実際のパスに置き換え、/path/to/your/omise-mcp/をomise-mcpフォルダへの正確なパスに置き換えてください。
   
   APIキー: <<YOUR_PUBLIC_KEY>>および<<YOUR_SECRET_KEY>>を実際のOmise APIキーに置き換えてください。これらはOmiseダッシュボード → 設定 → キーから取得できます。ライブアカウントの場合はライブキーを、テストアカウントの場合はテストキーを使用してください。

6. ファイルを保存して閉じます。
7. Claude Desktopを再起動します。
8. 設定 → 開発者に移動すると、Omise MCPサーバーが実行中でClaudeに接続されていることが確認できます。
   
9. Claudeチャットインターフェースから、検索とツールアイコンをクリックします。omise-mcp-serverが有効になっているはずです。
   

Cursor

CursorでOmise MCPをセットアップするには:

1. Cursor AIをダウンロード
2. Cursor APIにログイン
3. Cursor → 設定 → Cursor設定 → ツールとMCPに移動
4. MCPサーバーを追加をクリック
5. 以下のように設定を入力します:

   {
     "mcpServers": {
       "omise-mcp-server": {
         "command": "/path/to/npx",
         "args": [
           "tsx",
           "/path/to/your/omise-mcp/src/index.ts"
         ],
         "cwd": "/path/to/your/omise-mcp",
         "env": {
           "NODE_ENV": "prod",
           "OMISE_ENVIRONMENT": "test",
           "OMISE_API_VERSION": "2019-05-29",
           "OMISE_PUBLIC_KEY": "<<YOUR_PUBLIC_KEY>>",
           "OMISE_SECRET_KEY": "<<YOUR_SECRET_KEY>>",
           "OMISE_BASE_URL": "https://api.omise.co",
           "OMISE_VAULT_URL": "https://vault.omise.co",
           "OMISE_TIMEOUT": "30000",
           "OMISE_RETRY_ATTEMPTS": "3",
           "OMISE_RETRY_DELAY": "1000",
           "SERVER_NAME": "omise-mcp-server-prod",
           "SERVER_VERSION": "1.0.0",
           "TOOLS": "all",
           "LOG_LEVEL": "info",
           "LOG_FORMAT": "json",
           "LOG_REQUESTS": "true",
           "LOG_RESPONSES": "false",
           "RATE_LIMIT_ENABLED": "true",
           "RATE_LIMIT_MAX_REQUESTS": "500",
           "RATE_LIMIT_WINDOW_MS": "60000"
         }
       }
     }
   }
   

   注:

   • /path/to/npxをnpx実行可能ファイルへの実際のパス(例: /Users/username/.asdf/shims/npxまたは/opt/homebrew/bin/npx)に置き換えてください
   • /path/to/your/omise-mcp/src/index.tsをindex.tsファイルへの実際のパスに置き換えてください
   • /path/to/your/omise-mcpをomise-mcpフォルダへの実際のパスに置き換えてください
   • <<YOUR_PUBLIC_KEY>>および<<YOUR_SECRET_KEY>>をOmiseダッシュボード → 設定 → キーから取得した実際のOmise APIキーに置き換えてください

6. 設定を保存します
7. Cursorを再起動します
8. 設定 → Cursor設定 → ツールとMCPに移動します。Omise MCPサーバーが有効になっているはずです。
   

CLI

次のコマンドでMCPサーバーをローカルで起動します:

cd /path/to/your/omise-mcp
npx tsx src/index.ts

サーバーを実行する前に、OMISE_SECRET_KEYおよびOMISE_PUBLIC_KEY環境変数が設定されていることを確認してください。

設定パラメータ

設定パラメータを理解することで、特定のニーズに合わせてMCPサーバーをカスタマイズできます:

コア設定

URL設定

ネットワーク設定

サーバー設定

アクセス制御設定

アクセス制御機能:

• ツールホワイトリスト: TOOLS環境変数で指定されたツールのみがMCPクライアントに公開されます
• 厳密な検証: ツール名は起動時に50以上の利用可能なツールの完全なリストに対して検証されます
• ランタイム適用: 許可されていないツール呼び出しは構造化されたエラーメッセージで拒否されます
• 起動時検証: 無効なツール名が提供された場合、サーバーは起動に失敗します

例:

# すべてのツールを有効化
TOOLS=all

# 特定のツールのみを有効化
TOOLS=create_charge,retrieve_charge,list_charges

# 無効なツール名は起動失敗を引き起こす
TOOLS=invalid_tool # ❌ "Invalid tool names" エラーで失敗

環境別設定サンプル

開発環境:

{
  "NODE_ENV": "development",
  "OMISE_ENVIRONMENT": "test",
  "OMISE_PUBLIC_KEY": "pkey_test_...",
  "OMISE_SECRET_KEY": "skey_test_...",
  "TOOLS": "all",
  "LOG_LEVEL": "debug",
  "LOG_REQUESTS": "true",
  "LOG_RESPONSES": "true"
}

本番環境:

{
  "NODE_ENV": "production",
  "OMISE_ENVIRONMENT": "production",
  "OMISE_PUBLIC_KEY": "pkey_live_...",
  "OMISE_SECRET_KEY": "skey_live_...",
  "TOOLS": "create_charge,retrieve_charge,list_charges,create_customer,retrieve_customer",
  "LOG_LEVEL": "warn",
  "LOG_RESPONSES": "false",
  "RATE_LIMIT_MAX_REQUESTS": "1000"
}

ツール

サーバーは以下のMCPツールを公開します。プロンプトインジェクション攻撃を回避するため、Omise MCPを他のサーバーと使用する際は注意してください。特にチャージの作成や決済処理などの機密性の高い操作については、実行前に必ず操作内容を確認してください。フィードバックがある場合や、より多くのツールをご覧になりたい場合は、mcp@omise.coまでメールでお問い合わせください。

ログ設定

レート制限設定

利用可能なツール

Omise MCPサーバーは、Omise APIの機能にアクセスするための包括的なツールセットを提供します。各ツールは特定のAPIエンドポイントに対応し、決済、顧客、および関連リソースの管理を可能にします。