Mayar

Mayar Agent Plugin

将 AI Agent 连接到你的 Mayar 账户。此软件包使用 Mayar 官方托管的 MCP 服务：https://mcp.mayar.id/mcp。借助它，Agent 可以读取和管理发票、付款链接、产品、客户、交易、会员资格、优惠券、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（见下文）。此仓库还包含一个 Cursor 配置文件 .mcp.json。

设置 API 密钥

Mayar 不使用 OAuth。每个客户端都会在 Authorization 标头中发送你的生产环境 API 密钥。在 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 的 config.yaml，以便 Hermes 发送该标头。同名条目会替换软件包中的服务，因此请保留 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"

运行命令时，Shell 会展开 $MAYAR_API_KEY。

其他客户端

任何支持 Streamable HTTP 的 MCP 客户端都可以使用同一服务。在 Authorization 标头中发送密钥。Bearer 前缀为可选项。服务 URL 为 https://mcp.mayar.id/mcp。

工具

每个领域对应一个带有 action 参数的工具：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