Mencoro

Mencoro MCP 服务

用通俗的语言询问 AI 助手你的品牌在 AI 答案中的表现如何——排名、提及、情感倾向和声量份额——并让它帮你设置和调整监测。

Mencoro 会追踪品牌在 AI 答案引擎（ChatGPT、Perplexity、Google AI Overview 和 AI Mode）以及 Google 搜索和购物中的曝光情况。MCP 服务会向任何 MCP 客户端开放这些数据， 并支持管理项目、追踪查询、集群和组织，提供 66 个工具（31 个用于读取，35 个用于执行更改） 和 20 个提示词。其中一个提示词 get_mencoro_guide 可回答有关 Mencoro 本身的问题，无需登录即可使用。

该服务为托管式服务。大多数客户端应直接连接：

https://api.mencoro.com/mcp

此仓库包含该服务的公开元数据，以及一个小型 stdio 桥接程序 （@mencoro/mcp），供只能启动本地进程的宿主使用。此仓库不包含 Mencoro 应用程序源代码。

连接

支持远程 MCP 的客户端（推荐）

无需安装或启动本地进程。使用 OAuth 登录，或将个人访问令牌作为标头粘贴。

只能启动本地进程的客户端

Claude Desktop 的手动配置以及较旧的仅支持 stdio 的宿主需要使用桥接程序。本软件包正是为此而设：

npx -y @mencoro/mcp

// claude_desktop_config.json
{
  "mcpServers": {
    "mencoro": {
      "command": "npx",
      "args": ["-y", "@mencoro/mcp"],
      "env": { "MENCORO_API_KEY": "mcp_pat_your_token" }
    }
  }
}

令牌通过环境变量传递，而不是作为参数传递，因此不会出现在 ps 输出中，也无需经受宿主对参数的拆分。

身份验证

有两种接入方式。两者都包含相同的三项权限，而且都不能超出你在组织中自身角色所允许的范围：

OAuth 2.1 — 一键接入方式。Claude、ChatGPT、Claude Code 及任何实现 MCP 授权规范的客户端均支持。无需复制或粘贴；可在应用中撤销。 授权页面会预选客户端请求的权限范围（若未请求任何权限，则预选全部三项），且除 read 外，其他权限都可以取消勾选。 服务会公布 PKCE（S256）、客户端 ID 元数据文档、动态客户端注册和 RFC 9728 资源元数据，因此客户端可以通过 https://api.mencoro.com/.well-known/oauth-protected-resource/mcp 发现所需的一切。如果调用工具时连接缺少相应权限，系统会返回 403 insufficient_scope，并指出需要请求的权限；因此，支持逐步授权的客户端会提示你重新连接并添加权限。

个人访问令牌 — 适用于命令行客户端、配置文件和此桥接服务。在 tool.mencoro.com/me/mcp-server 创建；令牌只显示一次，以 mcp_pat_ 开头，包含你勾选的权限（默认包含全部三项），并且可以限定为单个组织和设置有效期。将其作为 Authorization: Bearer mcp_pat_… 发送。若令牌缺少所需权限，调用会失败并返回指出该权限的工具错误；令牌无法升级，因此要添加权限，请创建新令牌。

在支持写入权限之前创建的连接和令牌拥有 read 和 write，但不包含 organization:manage。

ChatGPT 无法向远程连接器发送自定义 Authorization 标头 — 请在此处使用 OAuth。

客户端配置

{
  "mcpServers": {
    "mencoro": {
      "url": "https://api.mencoro.com/mcp",
      "headers": { "Authorization": "Bearer mcp_pat_your_token" }
    }
  }
}

{
  "servers": {
    "mencoro": {
      "type": "http",
      "url": "https://api.mencoro.com/mcp",
      "headers": { "Authorization": "Bearer mcp_pat_your_token" }
    }
  }
}

[mcp_servers.mencoro]
url = "https://api.mencoro.com/mcp"
http_headers = { "Authorization" = "Bearer mcp_pat_your_token" }

{
  "mcpServers": {
    "mencoro": {
      "httpUrl": "https://api.mencoro.com/mcp",
      "headers": { "Authorization": "Bearer mcp_pat_your_token" }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mencoro": {
      "type": "remote",
      "url": "https://api.mencoro.com/mcp",
      "enabled": true,
      "headers": { "Authorization": "Bearer mcp_pat_your_token" },
      "oauth": false
    }
  }
}

{
  "mcpServers": {
    "mencoro": {
      "serverUrl": "https://api.mencoro.com/mcp",
      "headers": { "Authorization": "Bearer mcp_pat_your_token" }
    }
  }
}

{
  "mcpServers": {
    "mencoro": {
      "type": "http",
      "url": "https://api.mencoro.com/mcp",
      "headers": { "Authorization": "Bearer ${MENCORO_API_KEY}" }
    }
  }
}

工具

31 个工具用于读取，35 个工具用于更改内容。每个工具都会显式声明全部四项 MCP 注解 （readOnlyHint、destructiveHint、idempotentHint、openWorldHint），以便客户端在调用前决定要向你询问什么。

读取

每个读取工具都只需要 read 权限范围。

更改内容

标记为 C 的工具需要确认：调用 preview_operation，并传入工具名称和参数；向用户展示计划，只有在用户同意后，才使用返回的 confirmationToken 调用该工具。令牌只能使用一次，几分钟后过期；如果计划中描述的任何内容发生变化，令牌就会被拒绝。创建工具、作业启动工具和需要确认的工具也接受 requestId：使用相同 ID 重试时，会返回首次执行的结果，而不会重复操作。

如果组织中的角色不允许执行相应操作、项目已归档，或应用要求订阅但当前缺少订阅，则会像 Mencoro 应用一样拒绝更改。 日期采用 ISO 格式 YYYY-MM-DD，且必须在保留期限内。排名从 1 开始，数值越低越好；其他所有指标都是数值越高越好。

无需凭证即可在 https://api.mencoro.com/public/v1/mcp 查看实时定义——名称、描述、输入和输出架构、注释。该地址是同一服务的仅供发现的挂载点，可响应 initialize、ping、tools/list、prompts/list 和公开指南（get_mencoro_guide），并拒绝其他所有请求。调用任何其他工具都需要登录 https://api.mencoro.com/mcp。

提示词

二十个开箱即用的起点，由支持 MCP 提示词的客户端呈现。其中十二个用于询问你的数据：

brand_ai_overview · whats_changed · organization_overview · top_queries · biggest_movers · query_history · competitor_standing · head_to_head · negative_mentions · cited_sources · coverage_health · sov_explainer

四个用于分步编排变更，在关键步骤暂停并等待你批准：

四个用于将数据转化为决策：

ChatGPT 提交与技能

chatgpt-app-submission.json 包含应用提交元数据、工具注释说明和审核测试用例。功能发生变化时，请确保其中的工具描述和说明与托管服务保持一致。

十个可选技能可将工具转化为可复用的工作流。ChatGPT 不会显示 MCP 提示词，因此用户可通过这些技能获得相同的引导式流程。

六个技能只进行分析，不做任何更改：

• 可见度报告：性能摘要、趋势，以及查询表现的提升或下降。
• 竞争对手分析：声量份额和正面对比。
• 情感分析：情感分析结果，并附带注明来源的提及摘录。
• 覆盖范围审计：当前监控覆盖范围和过时的查询。
• 结果回顾：相对于基线比较变更前后，判断变更是否影响了 AI 可见度。
• 优化洞察：按优先级排列的改进建议，也可选用已连接的 Ahrefs、Semrush、Search Console 或 Google Analytics 工具。

四个技能会进行更改，且每项更改都必须先获得用户批准，并需要 write 范围：

• 项目设置：通过简短对话，根据网站创建受监控项目；在创建任何内容之前，先提供品牌名称和建议的竞争对手供用户确认。
• 查询扩展：提出值得追踪的新提示词或关键词，并根据用户的选择添加。
• 集群重组：提出集群方案，经审核后应用。
• 成本调整：调整频率、轮次和暂停设置，使检查支出控制在计划范围内。

在提交门户的 Skills 步骤中，上传 skills/ 下的每个技能文件夹，或上传包含该文件夹的 ZIP。请同时包含 SKILL.md 和 agents/openai.yaml；后者声明了现有的 Mencoro MCP 连接。用户需要通过 OAuth 连接其 Mencoro 账户。这些技能不需要额外的后端端点或本地可执行文件。

门户会保存上传时的快照。说明变更后，请上传修订后的捆绑包，并在提交应用前使用已连接的账户测试每个工作流。请参阅 OpenAI 技能指南。

桥接程序

运行

export MENCORO_API_KEY=mcp_pat_your_token
npx -y @mencoro/mcp            # serve on stdio
npx -y @mencoro/mcp doctor     # check the endpoint, the token, and list the tools

Docker

docker run --rm -i -e MENCORO_API_KEY=mcp_pat_your_token ghcr.io/mencoro/mencoro-mcp

必须使用 -i，且省略 -t：MCP 传输使用此进程的标准输入和标准输出。

选项

实际工作方式

它将客户端的标准输入／输出传输接入 Streamable HTTP 传输，并双向原样转发每个 JSON-RPC 帧。它唯一会检查的帧是握手帧——足以将协商后的协议版本回传给上游，并在服务端清除会话时重建会话；部署或缩容都会导致这种情况。它不了解其他方法，因此不会与服务端发生偏差：工具、提示词、资源、补全、进度通知以及以后添加的任何内容，都会直接通过。

无凭据

桥接程序仍会启动，并提供 catalog.json（已提交的副本，内容为托管服务所公布的信息），以及 mencoro_setup 工具。因此，运行 npx -y @mencoro/mcp 时，探查到的工具和提示词与提供凭据时相同；扫描该软件包的任何程序都会看到真实目录，而非一个看似空白的服务。调用这些工具之一时，会以错误形式返回设置说明；它绝不会返回编造的数据。例外是 get_mencoro_guide，它只读取已发布的资料：桥接程序会将其转发到托管服务的匿名端点，并返回真实答案。

npm run sync:catalog 会从匿名目录端点更新文件，而 npm run check:catalog 会在已提交的副本过时后报错。由于它所镜像的目录位于另一个代码库中，本代码库里的拉取请求无法发现目录发生变化，因此我们设置了每周运行一次的工作流来执行检查。

限制

代码库内容

开发

npm ci
npm run typecheck
npm test            # builds first, then runs the suite
npm run check:manifests
npm run check:catalog   # asks the hosted server whether catalog.json is still current

测试会通过 Node 的类型剥离功能直接运行 TypeScript 源代码，因此开发需要 Node 22.18 或更高版本。发布的软件包以 Node 20.19+ 为目标，CI 会针对构建产物单独进行验证。

发布通过打标签完成。运行 npm version <patch|minor|major>，将新版本同步到 server.json（.version、npm 软件包条目和镜像标签），运行 npm run check:manifests，然后推送标签——CI 会依次发布到 npm、GHCR 和 MCP registry，之后创建 GitHub release；Glama 会据此构建新版本。

支持

• 产品和账户问题 — [email protected]
• 此软件包中的错误 — 提交问题
• 安全问题 — 请参阅 SECURITY.md
• 关于服务 — mencoro.com/features/mcp-server
• 隐私政策 — mencoro.com/legal/#privacy
• 服务条款 — mencoro.com/legal/#terms

许可证

MIT。请参阅 LICENSE。

Mencoro 名称、徽标以及 assets/ 中的品牌资源均为 Mencoro 的商标，不受该许可证涵盖。