Mayar

Mayar Agent Plugin

AI エージェントをお使いの Mayar アカウントに接続します。このパッケージは、Mayar の公式ホスト型 MCP サーバー https://mcp.mayar.id/mcp を使用します。これにより、エージェントは請求書、支払いリンク、商品、顧客、取引、メンバーシップ、クーポン、Webhook、レビュー、QRIS、ライセンスコードを読み取り、管理できます。

これは Portable Agent Plugins v1 パッケージ（plugin.json、mcp.json、skills/）です。設定のみで構成されており、実行可能なコードは含まれていません。

要件

• Mayar アカウント。
• 本番用 API キー。Mayar ダッシュボードの Integration > Api Keys から取得してください （web.mayar.id/api-keys）。

Hermes Agent へのインストール

hermes plugins install mayarid/mayar-agent-plugin --no-enable
hermes plugins enable mayar

API キーを設定します（下記を参照）。Hermes を再起動します。その後、「Mayar を使ってください。account ツールを action balance で呼び出してください。」と尋ねます。有効なキーを設定していれば、残高が返されます。

Cursor へのインストール

このボタンを使うと、Mayar のホスト型 MCP サーバーが Cursor に追加されます。先に MAYAR_API_KEY を設定してください（下記を参照）。このリポジトリには .mcp.json の Cursor 設定ファイルも含まれています。

API キーの設定

Mayar は OAuth を使用しません。すべてのクライアントは、本番用 API キーを Authorization ヘッダーに含めて送信します。キーは Mayar ダッシュボードの Integration > Api Keys から取得してください （web.mayar.id/api-keys）。

Cursor

環境変数 MAYAR_API_KEY を設定します。「Cursor に追加」ボタンと .mcp.json は、キーを Authorization: Bearer ${env:MAYAR_API_KEY} として送信します。

Hermes

キーを ~/.hermes/.env に記述するか、プラグイン設定フォームで設定します。

MAYAR_API_KEY=your-production-key

Agent Plugins v1.0.0 では、mcp.json のリモートヘッダーにシークレットやプレースホルダーを設定できません。Hermes は、プラグイン拡張機能だけではまだこのキーを付加しません。Hermes がヘッダーを送信するように、次のブロックを Hermes の config.yaml に追加してください。同じ名前のエントリーがパッケージ内のサーバー設定を置き換えるため、trust: untrusted はそのままにしてください。

mcp_servers:
  mayar:
    url: https://mcp.mayar.id/mcp
    headers:
      Authorization: "Bearer ${MAYAR_API_KEY}"
    trust: untrusted

Claude Code

MAYAR_API_KEY を設定してから、次を実行します。

claude mcp add --transport http mayar https://mcp.mayar.id/mcp \
  --header "Authorization: Bearer $MAYAR_API_KEY"

コマンドを実行すると、シェルが $MAYAR_API_KEY を展開します。

その他のクライアント

同じサーバーは、Streamable HTTP に対応する任意の MCP クライアントで動作します。キーを Authorization ヘッダーに含めて送信してください。Bearer プレフィックスは省略できます。サーバー URL は https://mcp.mayar.id/mcp です。

ツール

各ドメインは、action 引数を取る1つのツールです。account、invoice、installment、customer、transaction、product、payment、membership、credit、coupon、webhook、review、qr、license、search_docs が用意されています。完全なリファレンスは mcp.mayar.id/docs をご覧ください。

開示事項

• すべてのツール呼び出しは https://mcp.mayar.id に送信され、そこでキーを使って Mayar 本番 API（api.mayar.id）が呼び出されます。
• 書き込み操作では実際のお金と本番データが使用されます。請求書、支払いリンク、商品、顧客、クーポンの作成または更新、メンバーシップのステータス変更、Webhook URL の変更、クレジットの追加または使用が行われる場合があります。
• このパッケージではサーバーに untrusted のマークが付けられています。Hermes は書き込み可能な呼び出しの前に、毎回確認を求めます。
• ツールから返されるアカウントデータ（顧客、取引、残高）は、モデルプロバイダーに送信されます。
• ツールの一覧は実行時にサーバーから取得されます。固定されたコミットには含まれません。
• プラグインは認証情報を保存しません。クライアントで MAYAR_API_KEY を設定してください。このパッケージの mcp.json に Authorization ヘッダーは含まれていません。

ライセンス

MIT