Meertrack

@meertrack/mcp

适用于 Meertrack 的模型上下文协议服务。你可以在 Claude、Cursor、Claude Code、VS Code、Windsurf、Cline、ChatGPT 或任何支持 MCP 的地方询问你的 Agent：“我的竞争对手本周发布了什么？”

将 Meertrack v1 REST API 封装为 8 个只读工具和 3 个提示词工作流。无需更改后端，沿用相同的 mt_live_ 密钥和速率限制。

---

选择传输方式

	本地（stdio）	远程（Streamable HTTP）
设置时间	30 秒（粘贴一个 JSON 块）	10 秒（粘贴一个 URL）
适用于	Pro 个人用户；所有 Claude Desktop 计划；笔记本电脑上的任意 IDE	团队版/企业版自定义连接器；Claude.ai 网页版；支持远程连接的 IDE
运行位置	你的设备（npx -y @meertrack/mcp）	Meertrack 的 Fly.io 集群（https://mcp.meertrack.com/mcp）
身份验证	MEERTRACK_API_KEY 环境变量	OAuth 2.1（浏览器流程，推荐）或 Authorization: Bearer mt_live_… 标头
计划限制	支持 Claude Pro、Team、Enterprise	Claude Desktop 的“添加自定义连接器”仅限 Team/Enterprise

如果你使用 Claude Pro，请选择本地（stdio）方式。 Claude Desktop 设置中的“添加自定义连接器”按钮仅对 Team/Enterprise 开放，在 Pro 计划中粘贴 https://mcp.meertrack.com/mcp 不会有任何效果。

获取 API 密钥

在 Meertrack 应用的 Settings → API Keys 中创建生产密钥。密钥以 mt_live_ 开头。只有生产密钥可用；没有 mt_test_ 类型的密钥。

速率限制。 每个 API 密钥共享上游强制执行的 每分钟 60 次请求额度。如果你同时从多个客户端运行 MCP（Claude Desktop + Cursor + 后台 Agent），它们会共用同一额度。为每台工作站或每个 Agent 创建单独的密钥，以隔离额度。429 工具错误消息包含便于阅读的重置时间和原始 X-RateLimit-Reset 时间戳，Agent 可据此自动退避。

---

本地安装：推荐默认方式

所有本地模式客户端使用相同的形式：npx -y @meertrack/mcp，并在环境中设置 MEERTRACK_API_KEY。不同之处在于配置文件和外层 JSON 键。

下方每种配置文件的可直接使用副本都位于 examples/ 中。

Claude Desktop（所有计划）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS） 或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "meertrack": {
      "command": "npx",
      "args": ["-y", "@meertrack/mcp"],
      "env": {
        "MEERTRACK_API_KEY": "mt_live_..."
      }
    }
  }
}

注意：Claude Desktop 只会在启动时重新读取此文件。请完全退出 （macOS 上按 ⌘Q）后重新打开。仅重新加载窗口是不够的。

Cursor

编辑 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "meertrack": {
      "command": "npx",
      "args": ["-y", "@meertrack/mcp"],
      "env": {
        "MEERTRACK_API_KEY": "mt_live_..."
      }
    }
  }
}

Claude Code（CLI）

claude mcp add meertrack npx -y @meertrack/mcp \
  --env MEERTRACK_API_KEY=mt_live_...

VS Code（GitHub Copilot MCP）

编辑 .vscode/mcp.json（每个工作区一份）或对应的用户设置文件：

{
  "servers": {
    "meertrack": {
      "command": "npx",
      "args": ["-y", "@meertrack/mcp"],
      "env": {
        "MEERTRACK_API_KEY": "mt_live_..."
      }
    }
  }
}

注意：VS Code 使用 servers，而不是 mcpServers。如果使用 Claude Desktop 的键，Copilot MCP 选择器将无法找到你的服务。

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "meertrack": {
      "command": "npx",
      "args": ["-y", "@meertrack/mcp"],
      "env": {
        "MEERTRACK_API_KEY": "mt_live_..."
      }
    }
  }
}

注意：Windsurf 的远程连接器使用 serverUrl，而不是 url。 对于上方的 stdio 配置，其结构与 Claude Desktop 完全相同。

Cline（VS Code 扩展）

打开 Cline 设置面板 →“MCP Servers”→ 粘贴：

{
  "mcpServers": {
    "meertrack": {
      "command": "npx",
      "args": ["-y", "@meertrack/mcp"],
      "env": {
        "MEERTRACK_API_KEY": "mt_live_..."
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

---

远程安装：Team/Enterprise + claude.ai web

所有远程客户端都指向同一个 URL：

https://mcp.meertrack.com/mcp

支持两种身份验证方式：

• OAuth 2.1（推荐） — 符合规范的 MCP 客户端会在 /.well-known/oauth-protected-resource/mcp 发现授权服务器（RFC 9728 §3.1；也会在根路径 /.well-known/oauth-protected-resource 提供服务，以兼容探测根路径的客户端），在 https://meertrack.com/oauth/register 执行动态客户端注册，然后完成受 PKCE 保护的完整授权 → 令牌流程。用户点击“连接”，在 meertrack.com 登录，在许可页面点击“允许”，即可完成。无需处理密钥。访问令牌是有效期为 1 小时的 JWT（RS256，aud=https://mcp.meertrack.com/mcp）；刷新令牌会根据 OAuth 2.1 §4.3.1 轮换。
• Authorization: Bearer mt_live_… — 为自定义连接器、CLI 脚本以及尚未实现 OAuth 发现的客户端粘贴静态 API 密钥。

两种方式最终连接到同一工作区；请选择客户端支持的方式。

Claude Desktop（仅限 Team / Enterprise：“添加自定义连接器”）

设置 → 连接器 → 添加自定义连接器 → 粘贴上方的 URL。 不要粘贴 Bearer 令牌 — 将令牌字段留空，然后点击“添加”。 Claude Desktop 会打开浏览器窗口，引导用户前往 meertrack.com 登录并授权；点击“允许”后，连接器会自动显示 8 个工具。

Pro 版不会显示“添加自定义连接器”按钮；请改用上方的 stdio 方式。

Claude.ai web（连接器）

在 Web 应用的“连接器”面板中执行上述相同操作。

Cursor（远程 MCP）

{
  "mcpServers": {
    "meertrack": {
      "url": "https://mcp.meertrack.com/mcp",
      "headers": {
        "Authorization": "Bearer mt_live_..."
      }
    }
  }
}

ChatGPT MCP 连接器

在 ChatGPT 的“添加 MCP”对话框中粘贴 URL 和 Bearer 令牌。注意：ChatGPT 目前对 Bearer 的支持有限；完整的 OAuth 支持计划在 Phase 11 中实现。

n8n / Zapier / …任何 Streamable HTTP 客户端

• 端点：https://mcp.meertrack.com/mcp
• 方法：POST
• 请求头：Authorization: Bearer mt_live_…、Accept: application/json, text/event-stream、MCP-Protocol-Version: 2025-11-25

---

8 个工具

所有工具均为只读，且名称都采用 snake_case。集合返回使用 list_ 前缀；行详情返回使用 get_（单个 ID 或一批 ID）。每个列表响应都包含 pagination.next_cursor 和 pagination.has_more，Agent 必须将 next_cursor 作为 cursor 传回，以获取下一页。

领域	工具	封装的接口	说明
身份	whoami	GET /me	确认工作区、订阅和速率限制快照。请首先调用。
竞争对手	list_competitors	GET /competitors	默认使用 expand=full，让 Agent 无需往返请求即可获取社交媒体和页面信息。
竞争对手	get_competitor	GET /competitors/{id}	个人资料，以及每个跟踪版块中的近期条目（博客、定价、招聘、广告等），并为每个版块设置上限。
动态	list_activities	GET /activity	核心“发布了什么”动态流。默认 limit=50，以避免超出工具结果大小限制。
动态	get_activity_items	GET /activity/items	批量深入查询：获取 1–100 个行 ID 的完整负载；无法解析的 ID 会在 not_found 中返回。
摘要	list_digests	GET /digests	使用游标分页的每周摘要。没有 total 字段（与动态不同）。
摘要	list_latest_digests	GET /digests/latest	无参数；一次获取“本周发生了什么”。
摘要	get_digest	GET /digests/{id}	某个竞争对手在某个时段的完整摘要和主题。

完整的输入、输出和错误代码文档位于工具描述中，MCP 客户端会以内联方式显示这些内容。

3 个提示词

Claude Desktop / Cursor / Claude Code / 任意支持提示词的 MCP 客户端中的斜杠命令。每个命令都会串联工具调用，完成一个完整的工作流。

提示词	参数	调用链
/weekly_recap	无	list_latest_digests → 按竞争对手生成摘要 + 重点
/competitor_deep_dive	competitor_name	list_competitors → get_competitor → list_activities（过去 30 天）
/whats_new	days?（默认值为 7）	从 now - N days 开始调用 list_activities，并按竞争对手分组

调用示例

• /weekly_recap
• /competitor_deep_dive competitor_name="Acme"
• /whats_new days="14"

请参阅 examples/prompts.md，其中按使用场景（每周回顾、功能规格调研、价格比较、董事会演示文稿准备）分类列出了十几个可复制粘贴的用户提示词。

---

故障排除

上游 API 返回错误时，MCP 工具响应会在错误文本中显示上游的 code。请按以下方式处理：

上游 code	含义	解决方法
unauthorized	密钥无效、已撤销或已过期	在 Settings → API Keys 中生成新密钥并更新配置
competitor_inactive	此工作区中的竞争对手已归档	在控制面板中重新启用该竞争对手
forbidden_competitor	你传入的 id 不属于此工作区	先调用 list_competitors，查找有效的 id
rate_limited	已达到每分钟 60 次请求的上限	等待错误消息中的重置时间，或为另一个客户端生成第二个密钥
not_found	此工作区中没有此记录	id 有误，或属于其他工作区
invalid_parameter / invalid_cursor	输入无效	查看错误消息；游标会过期，因此请从头重新列出

其他常见问题

• Claude Desktop 未加载你的配置 → 退出并重新启动应用，不要只关闭窗口。配置会在启动时读取。
• command not found: npx → 安装 Node ≥ 20。MCP 会固定 engines.node。
• 远程 URL 返回 401，且带有 WWW-Authenticate: Bearer → 你的 bearer 缺失、格式错误，或不是以 mt_live_ 开头。
• 刷新密钥后，401 错误就消失了 → bearer 没问题；这是 MCP 按规范返回的“请进行身份验证”响应。请发送 Authorization 标头。
• 同时通过 stdio 和远程方式运行，且使用同一个密钥 → 两者会共享每分钟 60 次的额度。请为每个客户端生成单独的密钥。

---

语义化版本控制

MCP 工具架构属于公共 API 契约的一部分；Agent 会缓存这些架构。因此：

• MAJOR：移除工具，或破坏现有工具的输入／输出架构（新增必需参数、重命名字段、移除枚举值）。
• MINOR：新增工具、新增可选参数，或新增提示词。
• PATCH：修复错误、改进描述、进行不影响架构的内部重构。

请参阅 CHANGELOG.md 了解发布历史，并参阅 docs/RELEASING.md 了解维护者的发布流程。

安全与隐私

• 隐私政策：https://meertrack.com/privacy
• SECURITY.md：漏洞披露政策（[email protected]）及涵盖范围。
• docs/PRIVACY.md：MCP 层无状态；bearer 会随每个请求转发，不会持久化。
• docs/ARCHITECTURE.md：请求流程图。
• docs/OBSERVABILITY.md：记录的内容，以及 bearer 令牌的脱敏方式。

许可证

MIT。