Maqui Analytics

Maqui Analytics MCP 服务

面向本地商家和代理机构的一站式营销分析 MCP，涵盖 Instagram、广告、网站流量、SEO 和评价。

服务 URL： https://app.somosmaqui.com/api/mcp

---

可以查询的内容

将 Maqui 连接到 AI 助手，用日常语言查询所有营销渠道——无需查看仪表板，也无需切换标签页。

渠道	可以查询的内容
Instagram	覆盖人数、互动率、热门帖子、粉丝增长、话题标签表现
Google Ads	按广告系列和关键词查看支出、CTR、CPC、转化次数、CPA、ROAS
Meta Ads	Facebook 和 Instagram 广告的支出、覆盖人数、潜在客户、消息、购买情况
Google Analytics 4	会话数、用户数、跳出率、热门页面、流量来源
Search Console	自然点击次数、展示次数、排名、热门查询和页面
Microsoft Clarity	会话数、互动情况、行为信号、热门页面和流量来源
评价	Google Business 和 Facebook 评分、回复率、近期评价
CRM / 潜在客户	按状态和来源查看销售渠道中的潜在客户
POS 销售	Fudo 餐厅按渠道划分的销售额（堂食、配送、柜台）

提示词示例

• “上个月我们的 Instagram 表现如何？与前一个月相比怎样？”
• “本季度哪个 Google Ads 广告系列的 ROAS 最高？”
• “本周排名前 5 的自然搜索查询是什么？”
• “显示过去 30 天内所有 1 星评价”
• “1 月份我们从 Meta Ads 和自然渠道分别获得了多少潜在客户？”

---

兼容的客户端

连接支持 Streamable HTTP 和 PKCE OAuth 授权的 MCP 客户端。Maqui 接受经批准的客户端注册，或来自经批准来源的 Client ID Metadata Documents。无法识别的客户端和回调 URL 将被拒绝；如需支持其他客户端，请联系 Maqui。

支持自定义 Authorization 标头的客户端也可以使用每个账户专属的 API 令牌。本地 stdio 桥接工具（例如 mcp-remote）支持此替代方式。

---

身份验证

公共端点提供 OAuth，支持资源发现、PKCE S256 和明确授权。使用 Maqui 账户登录，然后批准读取权限。OAuth 访问令牌会在一小时后过期。客户端请求 offline_access 时，刷新令牌会轮换，并在 30 天后过期；重复使用令牌会撤销整个令牌系列。旧版 OAuth 连接必须重新连接。

受保护资源元数据：https://app.somosmaqui.com/.well-known/oauth-protected-resource/api/mcp。 授权服务器元数据：https://app.somosmaqui.com/.well-known/oauth-authorization-server。

Maqui 管理面板仍可使用现有的 bearer API 令牌。每个 API 令牌仅适用于一个账户，有效期为一年，且可单独撤销。该端点在发现工具和查询数据时都需要有效令牌。Maqui 会授予对真实业务数据的访问权限。

合成演示

在 OAuth 授权页面选择 Probar solo con datos sintéticos，即可无需登录试用全部 22 个工具。演示响应会明确标记，并使用 2026 年 9 月的虚构示例。它们不会查询客户指标，更改 account_id 也无法将演示令牌切换为真实数据。所请求的日期范围会与固定的样本时段分开显示；演示不会应用所有筛选条件。

目录健康检查可以使用由经过身份验证的 Maqui 管理员签发的独立、可撤销演示持有者令牌，有效期为 30 天。在仪表板中，选择 Admin → Tokens MCP → Generar token demo para Glama，验证演示响应，然后配置目录的测试配置文件。切勿在 README 或代码仓库中公开该凭据。每个目录使用单独的凭据。

Glama connector 已于 2026 年 10 月 9 日验证为 Healthy，包含 22 个已索引工具，并在 Admin → Test Profile → API Key → Bearer Authentication 中使用合成演示。此测试配置文件使用演示持有者令牌；这并不能证明与 Glama 兼容 OAuth。请在演示令牌 30 天有效期届满前续期，以保持检查正常运行。

直接使用 Streamable HTTP

适用于接受远程 MCP URL 和自定义标头的客户端：

{
  "mcpServers": {
    "maqui": {
      "url": "https://app.somosmaqui.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

本地 stdio 桥接

适用于启动本地 MCP 进程的客户端（需要 Node.js）：

{
  "mcpServers": {
    "maqui": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.somosmaqui.com/api/mcp",
        "--header",
        "Authorization:Bearer ${MAQUI_TOKEN}"
      ],
      "env": {
        "MAQUI_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

请勿将真实令牌放入公开代码仓库或共享配置示例中。

---

面向代理机构

Maqui 专为管理多个客户的营销代理机构打造。每个客户账户都有隔离的数据集和独立的 API 令牌，不存在跨账户数据访问。

如果您管理多个客户，每位客户都会获得仅限访问其数据的专属令牌。客户关系结束后，可在管理面板中撤销该客户的令牌，其访问权限会立即停止，其他客户的令牌则继续有效。您可以在 AI 客户端中配置多个实例：

{
  "mcpServers": {
    "maqui-cliente-a": {
      "url": "https://app.somosmaqui.com/api/mcp",
      "headers": { "Authorization": "Bearer TOKEN_CLIENTE_A" }
    },
    "maqui-cliente-b": {
      "url": "https://app.somosmaqui.com/api/mcp",
      "headers": { "Authorization": "Bearer TOKEN_CLIENTE_B" }
    }
  }
}

---

关于 Maqui

Maqui 是面向餐饮、零售和服务业企业的营销分析平台。它每天从 Instagram、Google Ads、Meta Ads、Google Analytics、Search Console、Google Business 评论和 POS 系统同步数据，并通过对话界面让您查询这些数据。

→ somosmaqui.com