Gridar

@gridar/mcp-server

面向 Gridar 的 Model Context Protocol 服务。

该服务将 Gridar REST API（https://api.gridar.app/api/v1）作为 69 个 gridar_* 工具提供。MCP 客户端可以读取和修改令牌所属 Gridar 账户中的站点、文章、落地页、已跟踪关键词、autopilot、站点记忆和 Search Console 数据，也可以对其运行 SEO 检查。

版本

发行版	版本	工具数
托管服务 https://mcp.gridar.app/mcp	0.7.0	69
此源代码（mcp-server/）	0.7.0	69
npm 软件包 @gridar/mcp-server	0.4.2	43

于 2026-10-21 使用 npm view @gridar/mcp-server version 和托管服务卡片进行检查。npm 软件包版本落后：请使用托管服务。

要求

• 拥有 Gridar Pro 或 Agency 套餐的账户。
• 所有套餐均可成功通过 OAuth 登录，但 Trial 和 Solo 套餐中的每次工具调用都会返回 HTTP 403：“Accès API réservé aux plans Pro et Agence”。

安装：托管服务（推荐）

项目	值
URL	https://mcp.gridar.app/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1 with PKCE，或 Authorization: Bearer btb_xxx
官方 MCP 注册表	app.gridar/gridar
公开服务卡片（无需令牌）	https://mcp.gridar.app/.well-known/mcp/server-card.json：名称、版本、工具列表
健康状态	https://mcp.gridar.app/health

无需在你的计算机上安装任何内容。

OAuth 登录的作用

1. 将 https://mcp.gridar.app/mcp 添加到你的客户端。
2. 如果没有令牌，服务会返回 401，并附带一个指向 /.well-known/oauth-protected-resource 的 WWW-Authenticate 标头。客户端会从该地址发现 OAuth 端点。
3. 客户端会打开 Gridar 登录页面。按需登录，然后点击 Autoriser。
4. Gridar 会创建一个以客户端命名的 API 令牌（例如 MCP - Claude Code），并将其交给客户端。
5. 令牌会显示在 https://www.gridar.app/account/api-keys。你可以在那里撤销令牌以断开访问。

Claude（claude.ai 和 Claude Desktop）

在 claude.ai 中：进入 Settings > Connectors，添加自定义连接器，并填写 URL https://mcp.gridar.app/mcp。Claude 会打开 Gridar 登录页面；授权后即可使用该连接器。

Claude Desktop 通过配置文件使用 mcp-remote 桥接程序：

{
  "mcpServers": {
    "gridar": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.gridar.app/mcp"]
    }
  }
}

配置文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）。之后重启 Claude Desktop。

ChatGPT

1. 打开 Settings > Connectors，或开启 Developer Mode 以使用自定义连接器。
2. 按 URL 添加连接器：https://mcp.gridar.app/mcp。
3. ChatGPT 会打开 Gridar 登录页面。请授权。

OpenAI 会根据账户类型限制自定义连接器。Gridar 页面列出了 ChatGPT Pro、Team、Enterprise 或 Developer Mode；请查看 OpenAI 当前的规则。

Claude Code

claude mcp add --transport http gridar https://mcp.gridar.app/mcp

首次调用时会启动 OAuth。如需在没有浏览器的会话中使用，请在标头中传入令牌：

claude mcp add --transport http gridar https://mcp.gridar.app/mcp \
  --header "Authorization: Bearer btb_xxx"

Cursor

进入 Settings > MCP > Add server，添加类型为 URL 的服务：https://mcp.gridar.app/mcp。

Codex CLI、SDK 和其他客户端

任何支持 Streamable HTTP 的 MCP 客户端都可以连接到 https://mcp.gridar.app/mcp，并自行发现 OAuth 流程（参见上文第 2 步）。无头 Agent 可使用在 https://www.gridar.app/account/api-keys 创建的令牌发送 Authorization: Bearer btb_xxx。

安装：通过 npm 使用本地 stdio

npm 包版本较旧。 npm 上的 @gridar/mcp-server 版本为 0.4.2，包含 43 个工具。托管服务和此源代码的版本为 0.7.0，包含 69 个工具。本 README 中的工具列表与 0.7.0 版一致。

npm 0.4.2 中缺少的 26 个工具：gridar_action_strategic_opportunity、gridar_ai_overview_readiness、gridar_ai_visibility_summary、gridar_approve_strategy、gridar_build_cluster、gridar_check_renderability、gridar_classify_intent、gridar_cluster_map、gridar_create_landing、gridar_export_page_prompt、gridar_generate_landing、gridar_generate_sister_article、gridar_index_coverage、gridar_indexnow_setup、gridar_indexnow_submit、gridar_link_opportunities、gridar_link_pages、gridar_list_strategic_opportunities、gridar_mark_page_built、gridar_propose_keyword_strategy、gridar_pull_build_queue、gridar_refresh_strategic_opportunities、gridar_run_ai_visibility、gridar_serp_analyze、gridar_site_seo_score、gridar_submit_sitemap。

此包会安装 gridar-mcp 二进制文件，并从 BLOG_DASHBOARD_TOKEN 读取令牌。

Claude Desktop：

{
  "mcpServers": {
    "gridar": {
      "command": "npx",
      "args": ["-y", "@gridar/mcp-server"],
      "env": {
        "BLOG_DASHBOARD_TOKEN": "btb_xxx"
      }
    }
  }
}

Claude Code：

claude mcp add gridar \
  --env BLOG_DASHBOARD_TOKEN=btb_xxx \
  -- npx -y @gridar/mcp-server

其他客户端：在其环境中设置令牌，并通过 stdio 启动进程。

BLOG_DASHBOARD_TOKEN=btb_xxx npx -y @gridar/mcp-server

要在本地获取全部 69 个工具，请改为构建此源代码（参见开发）。

环境变量

仅列出名称。切勿提交真实令牌。

Stdio（本地）

变量	必填	默认值	作用
BLOG_DASHBOARD_TOKEN	是	无	Gridar API 令牌（btb_xxx），作为 Authorization: Bearer 发送
BLOG_DASHBOARD_API_BASE	否	https://api.gridar.app/api/v1	Gridar API 基础 URL

可自托管 HTTP（node dist/http.js）

变量	默认值	作用
PORT	8080	监听端口
BLOG_DASHBOARD_API_BASE	https://api.gridar.app/api/v1	服务转发调用的 Gridar API
MCP_PUBLIC_BASE	http://localhost:<PORT>	此服务的公开 URL，用于 OAuth 元数据和重定向
GRIDAR_BASE	https://gridar.app	承载 OAuth 登录页面（/oauth/mcp-authorize）的 Gridar 应用
MCP_REQUIRE_AUTH	开启	设置为 false 可跳过 Bearer 检查（仅用于开发）
MCP_ALLOWED_ORIGINS	*	允许的 CORS 来源列表，以逗号分隔
OAUTH_CLIENT_ID	内置值	动态客户端注册返回的客户端 ID
OAUTH_CLIENT_SECRET	内置值	动态客户端注册返回的客户端密钥

在 HTTP 模式下，令牌来自每个请求的 Authorization 标头，并通过 AsyncLocalStorage 限定在该请求范围内。BLOG_DASHBOARD_TOKEN 仍会作为后备令牌：在设置了 MCP_REQUIRE_AUTH=false 的共享服务上不要设置它，否则每个调用者都会以该账户的身份操作。

HTTP 端点：

方法和路径	作用
POST /mcp	MCP Streamable HTTP：初始化和工具调用
GET /mcp	开放会话的 SSE 通知流
DELETE /mcp	关闭会话
GET /health	{status, name, version, transport, oauth}
GET /.well-known/mcp/server-card.json	公开卡片：服务信息和工具列表，无需令牌
GET /.well-known/oauth-protected-resource	OAuth 受保护资源元数据（RFC 9728）
GET /.well-known/oauth-authorization-server	OAuth 服务元数据（RFC 8414）
POST /register	动态客户端注册（RFC 7591）
GET /authorize、GET /callback、POST /token	使用 PKCE（S256 或 plain）的 OAuth 授权码流程

方案和限制

方案	API 和 MCP 访问权限	每小时请求数	每月 AI 文章数
Trial	无（403）	0	1
Solo	无（403）	0	8
Pro	有	30	60
Agency	有	200	200

来源：backend/sites_mgmt/api_v1.py 中的 PLAN_API_LIMITS，以及 backend/sites_mgmt/models.py 中的 Subscription.get_limits()。

• 每次工具调用都会向 Gridar API 发送一个请求，并计入每小时限制。超过限制后，API 会返回 429。
• 以下三个工具会扣减每月文章配额；配额用完后，则会扣减一个额度：gridar_generate_article、gridar_generate_sister_article、gridar_generate_landing。
• API 错误会作为工具错误返回：Gridar API error (HTTP <status>): <message>，后跟 JSON 正文。

工具（69）

效果列标记了调用会造成的更改：

• destructive：删除或停用某项内容；客户端应先确认。
• publishes：发布内容或将页面设为公开。
• quota：从每月配额中扣减一篇文章，或扣减一个额度。
• writes：在 Gridar 中更改数据，但不会发布任何内容。
• none：只读。

账户和站点

工具	功能	效果
gridar_get_me	你的方案、每小时 API 限制、每月文章配额及使用情况	none
gridar_list_sites	你的站点：id、域名、托管模式、默认语言	none
gridar_get_site	单个站点的完整配置：集成、默认语言、知识库、竞争对手、GSC 连接、自动驾驶、作者 E-E-A-T 字段	none
gridar_update_site	更改可编辑的站点字段：名称、描述、知识库、竞争对手、默认语言、作者简介和资质、公开博客域名	writes

文章

工具	功能	效果
gridar_list_articles	站点文章，按状态、语言和数量筛选（默认 25 篇，最多 100 篇）	none
gridar_get_article	根据 site_id 和 slug 获取一篇文章的完整内容（HTML 和元数据）	none
gridar_generate_article	根据 topic 或 title 生成 SEO 文章。在托管站点上保存为草稿，在 WordPress、Shopify 和 Webflow 上则直接发布	quota；在 CMS 站点上为 publishes
gridar_generate_sister_article	将文章翻译并改写为同一翻译组中的另一种语言，从而建立 hreflang 链接。创建为草稿。仅适用于托管站点	quota
gridar_create_article	在托管站点上创建手写文章。不使用 AI，也不扣减配额	writes；当 status: published 时为 publishes
gridar_update_article	在所有站点模式（托管、外部、WordPress、Shopify、Webflow）下，更改文章的标题、内容、摘要、状态、封面图片或作者	writes；当 status: published 时为 publishes
gridar_delete_article	在所有站点模式下永久删除文章。删除 WordPress、Shopify 和 Webflow 上的文章时会跳过回收站	destructive

审计与内容

工具	功能	影响
gridar_audit_article	审计原始内容：提供 0 到 100 的评分，并针对长度、关键词密度、标题、链接和元数据给出修改建议	无
gridar_get_brief	为关键词生成内容简报：搜索意图、大纲、实体、常见问题候选项和 E-E-A-T 信号	无
gridar_bulk_audit	并行审计网站所有已发布文章（Gemini）：汇总评分和主要问题	无
gridar_check_readability	评估文本的可读性（Flesch-Kincaid、ARI）	无
gridar_check_plagiarism	通过 Originality.ai 检查文本中的 AI 内容和抄袭情况	无
gridar_check_hreflang	检查网站已发布文章的翻译组是否一致。需要 site_id	无
gridar_detect_cannibalization	找出针对相同意图或关键词的文章组合，涵盖不同语言和状态	无
gridar_suggest_internal_links	从网站已发布的文章中挑选内链，供你插入传入的 content	无
gridar_ai_overview_readiness	根据 5 项加权检查（常见问题、H2/H3 结构、E-E-A-T、具体数据、可提取段落）评估文章适用于 AI 答案的准备情况，评分为 0 到 100，并提供建议	无

网站健康状况

工具	功能	影响
gridar_site_seo_score	根据 9 项加权检查（可索引性、作者简介、商业模式、GSC、已获批准的支柱页和子页面集群、hreflang、Core Web Vitals、常见问题架构、滞留在博客文章中的交易型意图）计算 0 到 100 的综合网站评分，并提供 action_items	无
gridar_check_renderability	抓取 URL 并判断 HTML 是服务器端渲染的，还是必须由 Googlebot 渲染的 JavaScript 外壳（可见文字不超过 100 个时会标记为可疑 SPA）	无
gridar_page_speed	获取 URL 的 PageSpeed Insights 数据，适用于移动端或桌面端：Core Web Vitals 和建议	无
gridar_find_broken_links	找出网站文章中返回 4xx、5xx 或超时的出站链接	无
gridar_get_content_decay	找出过去 N 天（7 到 90 天，默认为 30 天）内 GSC 展示次数或点击次数下降的文章，并建议更新、扩充或重定向	无

关键词、SERP 和竞争对手

工具	功能	影响
gridar_list_keywords	查看已跟踪的关键词及其最近记录的排名	无
gridar_track_keyword	添加要跟踪的关键词，或重新启用已移除的关键词。每日 cron 会记录其排名	写入
gridar_untrack_keyword	停止跟踪关键词（软删除）。保留排名历史；使用 gridar_track_keyword 可恢复跟踪	写入
gridar_snapshot_keywords	立即记录网站每个已跟踪关键词的排名	写入
gridar_suggest_keywords	Claude 根据网站记忆和首页推荐要跟踪的关键词	无
gridar_keyword_research	将种子关键词扩展为相关查询（Serper 相关搜索和「People Also Ask」、Gemini 变体），按主题系列分组，并显示各提供方的状态。不含搜索量或难度	无
gridar_people_also_ask	获取 Google 针对某个关键词的「People Also Ask」问题	无
gridar_classify_intent	判断关键词的搜索意图（交易型、商业型、信息型、导航型、本地型），并给出置信度评分	无
gridar_analyze_competitors	获取某个关键词在 Google 排名靠前的 10 个结果：平均字数、常见标题、实体覆盖情况和内容缺口	无
gridar_serp_analyze	获取排名靠前的 10 个结果中各 URL 的指标（字数、H1/H2/H3、常见问题、视频）及平均值，用于评估竞争文章的规模	无
gridar_suggest_competitors	根据首页和已跟踪关键词，推荐可能的 SEO 竞争对手	无
gridar_link_opportunities	获取针对某个关键词的外链拓展候选网站：域名、URL、标题、摘要和来源查询	无

策略、落地页和集群

工具	功能	影响
gridar_propose_keyword_strategy	为关键词规划结构：单个落地页、支柱页与集群、对比表、本地落地页或博客文章。重新运行会刷新草稿，不会更改已批准的策略	写入
gridar_approve_strategy	批准策略：落地页由 AI 生成为草稿，文章则等待调用 gridar_generate_article	写入
gridar_create_landing	创建手动编写的结构化落地页（主视觉、价值主张、社会认同、常见问题解答、底部行动号召）。不使用 AI，不消耗配额。仅适用于托管网站	写入；使用 status: published 时会发布
gridar_generate_landing	根据关键词使用 AI 生成完整落地页，并在托管网站上保存为草稿	消耗配额
gridar_link_pages	在同一网站的两个页面之间添加上下文链接：就地转换锚文本，或追加一行“Voir aussi”	写入（编辑源页面）
gridar_cluster_map	网站的主题集群：支柱页、分支页、已覆盖页面、缺失页面。不调用 LLM	无
gridar_build_cluster	为支柱页及其分支页生成提示词，并包含内部链接。将缺失的关键词添加到跟踪中。不调用 LLM，不消耗配额：由 Agent 编写文案	写入

战略机会

工具	功能	影响
gridar_refresh_strategic_opportunities	对已跟踪、具有交易、商业或本地意图且尚无落地页的关键词运行机会引擎。每个关键词调用一次 Claude，max_keywords 默认为 8，上限为 20	写入
gridar_list_strategic_opportunities	缓存的机会：页面类型、标题、URL 路径、吸引点、获客机制、转化路径、角度、优先级、流量估算（参见已知限制）	无
gridar_action_strategic_opportunity	approve 会生成落地页草稿并将机会标记为已完成；dismiss 会隐藏机会；restore 会将机会恢复	写入
gridar_export_page_prompt	可直接粘贴到你自己的 AI 工具（ChatGPT、Lovable、v0、Bolt 等）中的提示词：使用 landing_id 可原样集成现有落地页，使用 opportunity_id 可根据概要撰写页面。仅进行模板处理，不消耗配额	无

通过 Agent 交付

对于 Gridar 无法发布到的自建网站，请在控制面板中将网站的交付模式设为 Agent。

工具	功能	影响
gridar_pull_build_queue	获取要在你自己的仓库中构建的页面队列：落地页概要、要原样集成的已生成文章、文章概要。不调用 LLM，不消耗配额	无
gridar_mark_page_built	报告队列中的页面已上线，并提供其 URL。Gridar 会将其从队列中移除，并关联排名跟踪和效果证明	写入

Google Search Console 和索引

工具	功能	影响
gridar_gsc_queries	查询某篇文章在 N 天内的 GSC 数据（展示次数、点击次数、排名；默认为 28 天，限制为 50）。需要连接 GSC	无
gridar_index_coverage	查看 Google 已索引了哪些预期页面：对任意网站执行 site: 查询；如果已连接 GSC，还会显示 GSC URL 检查状态和原因（max_inspect 默认为 25）	无
gridar_submit_sitemap	将站点地图重新提交到 Google Search Console。需要具有写入权限的 GSC。不会强制建立索引	写入（发送给 Google）
gridar_indexnow_setup	获取网站的 IndexNow 密钥以及需托管在域名根目录下的密钥文件。首次调用时会创建密钥	写入
gridar_indexnow_submit	将 URL 或站点地图中的 URL 提交到 IndexNow：Bing、Yandex、Seznam、Naver。不包括 Google	写入（发送到 IndexNow）

AI 可见度

工具	功能	影响
gridar_ai_visibility_summary	返回 available: false、计数为 0，并附带一条 note：仪表板尚未查询任何 AI 引擎	无
gridar_run_ai_visibility	返回 HTTP 501，错误代码为 ai_visibility_unavailable，且不写入任何内容	无

自动驾驶

工具	功能	影响
gridar_get_autopilot	自动驾驶配置和状态：是否启用、每周次数、上次运行时间、下次运行时间、上次错误	无
gridar_set_autopilot	启用或配置自动驾驶：enabled、weekly_count（1 至 7）、auto_publish	写入；之后会在 auto_publish: true 时发布
gridar_run_autopilot_now	立即运行一个自动驾驶周期，不受计划安排限制	写入；auto_publish 开启时会发布

站点记忆

工具	功能	影响
gridar_list_memories	站点记忆片段：文章、知识库、手动笔记、决策。支持分页	无
gridar_add_memory	添加一条笔记。manual 和 decision 类型在后续生成中权重更高	写入
gridar_delete_memory	删除一个记忆片段	破坏性操作
gridar_rebuild_memory	对知识库和已发布的托管文章重新分块并生成嵌入向量（Voyage AI）。不会清除现有片段	写入

结果证明与报告

工具	功能	影响
gridar_proof_summary	根据 GSC 统计获得的展示次数和点击次数，并列出增长最多的 5 篇文章	无
gridar_proof_attribution	每篇文章在第 30、60 和 90 天相对于基准的快照；使用 post_id 筛选	无
gridar_enable_proof_share	启用公开的只读结果页面并返回其 URL。rotate: true 会生成新链接并使旧链接失效	发布
gridar_revoke_proof_share	关闭公开结果页面：该 URL 会立即返回 404。数据会保留	破坏性操作
gridar_weekly_digest	站点最近 7 天的数据：流量、排名、内容衰减	无

对话示例

• “审核站点 12，并告诉我优先处理的 3 项修复。”Claude 会调用 gridar_site_seo_score，然后读取其 action_items。
• “提取站点 12 的待构建页面，并在此代码库中创建这些页面。”Claude Code 会调用 gridar_pull_build_queue，编写每个页面并部署，然后针对每个线上 URL 调用 gridar_mark_page_built。

工具接收数字型 site_id：该站点必须已存在于你的 Gridar 账户中。gridar_list_sites 会返回这些 ID。

已知限制

• AI 可见性尚未接入。 仪表板不会查询任何 AI 引擎。gridar_run_ai_visibility 返回 501（ai_visibility_unavailable）且不存储任何内容；gridar_ai_visibility_summary 返回 available: false 和零计数，并排除先前模拟的结果。若要进行一次性检查，工具描述会指向免费的检查器：https://www.gridar.app/tools/ai-visibility-checker。
• 没有搜索量，也没有关键词难度。 gridar_keyword_research 不会返回这两项，而 estimated_intent 是根据关键词中的词语推测的。请查看其 sources 字段：列表较短可能意味着某个提供商出错或未返回任何内容。
• 机会估算值经常为 0。 战略机会中的 monthly_volume 来自对 Serper 搜索响应的尽力读取。如果 Serper 未返回搜索量字段，monthly_volume、estimated_visits 和潜在客户范围都会是 0，且 qualitative_traffic 为 inconnu。
• 排名深度。 每日 cron 会保留最多三次 Serper 调用返回的最大自然搜索结果集；gridar_snapshot_keywords 则只进行一次调用。在这两种情况下，如果页面排名低于 Serper 返回的结果范围，就会被记录为未排名。
• gridar_generate_article 在省略 language 时默认使用法语（后端读取 language，否则回退到 fr）。在网站设定业务模式和作者简介之前，它会返回 422；网站没有交付路径时会返回 409（delivery_blocked）；配额和积分用完时会返回 402。
• gridar_update_article 通过 slug 识别文章；没有可用于更改 slug 的字段。
• gridar_check_hreflang 需要 site_id。后端会忽略 html 参数。
• gridar_suggest_internal_links 需要 content。后端不会读取 article_slug 或 keyword。
• gridar_check_plagiarism 需要至少 50 个字符；如果 Gridar 端未配置 Originality.ai，则会返回 503。
• 落地页（gridar_create_landing、gridar_generate_landing）和 gridar_generate_sister_article 仅适用于托管网站。
• IndexNow 无法触达 Google，重新提交站点地图也不会强制 Google 将任何内容编入索引。
• 令牌。 一个令牌可访问账户中每个网站上的所有工具，包括删除操作。没有只读令牌。每次 OAuth 授权都会创建一个新令牌；旧令牌会一直有效，直到你在 https://www.gridar.app/account/api-keys 撤销它们。
• OAuth 状态保存在内存中。 验证码会在 5 分钟后过期；如果登录期间服务器重启，待处理的登录就会失效：请重新开始连接。

开发

cd mcp-server
npm install
npm run build
BLOG_DASHBOARD_TOKEN=btb_xxx node dist/index.js   # stdio (npm start)
PORT=8080 node dist/http.js                       # HTTP (npm run start:http)

使用 MCP Inspector 进行调试：

BLOG_DASHBOARD_TOKEN=btb_xxx npx @modelcontextprotocol/inspector node dist/index.js

工具定义（名称、描述、输入架构）位于 src/index.ts，API 客户端位于 src/api.ts，HTTP 服务和 OAuth 流程位于 src/http.ts。

链接

• 集成文档（法语）：https://www.gridar.app/docs/integrations
• 连接器页面：https://www.gridar.app/mcp
• 官方 MCP 注册表条目 app.gridar/gridar：https://registry.modelcontextprotocol.io/v0.1/servers?search=app.gridar/gridar
• 源代码：https://github.com/TokDar2410621/blog-dashboard/tree/main/mcp-server

许可证

MIT