Gridar について
Gridarは、サイト、コンテンツ、キーワード、Search Consoleデータの管理やSEOチェックをMCPクライアントに提供するSEOプラットフォームです。GridarのProまたはAgencyプラン向けで、ホスト型サーバーでは69個のツールを利用できます。
主な機能
- 01サイトと記事の管理
- 02コンテンツの生成と更新
- 03キーワードとSEOデータの追跡
- 04コンテンツとサイトの監査
- 05AI検索での可視性分析
活用シーン
- 01公開記事のSEO課題の監査
- 02サイトコンテンツの生成と更新
- 03キーワードとSearch Consoleデータの確認
- 04AI回答への適合度の評価
MCP 対応
ホスト型Streamable HTTPエンドポイント `https://mcp.gridar.app/mcp` で69個の `gridar_*` ツールを提供し、OAuth 2.1とPKCEまたはBearerトークンに対応します。ツールを通じてMCPクライアントからGridarのアカウントデータを参照・操作でき、API利用にはProまたはAgencyプランが必要です。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.gridar.app/mcpclaude mcp add --transport http app-gridar-gridar https://mcp.gridar.app/mcp{"mcpServers":{"app-gridar-gridar":{"type":"http","url":"https://mcp.gridar.app/mcp"}}}Cursor で開く{"servers":{"app-gridar-gridar":{"type":"http","url":"https://mcp.gridar.app/mcp"}}}VS Code で開く{"mcpServers":{"app-gridar-gridar":{"type":"http","url":"https://mcp.gridar.app/mcp"}}}{"mcpServers":{"app-gridar-gridar":{"serverUrl":"https://mcp.gridar.app/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
@gridar/mcp-server
Gridar 用の Model Context Protocol サーバーです。
このサーバーは、Gridar REST API(https://api.gridar.app/api/v1)を69個の gridar_* ツールとして公開します。MCP クライアントは、トークンに紐づく Gridar アカウントのサイト、記事、ランディングページ、追跡対象のキーワード、自動操縦、サイトメモリー、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 パッケージは古いバージョンのため、ホステッドサーバーを使用してください。
要件
- Pro または Agency プランの Gridar アカウント。
- 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(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 ログインの動作
- クライアントに
https://mcp.gridar.app/mcpを追加します。 - トークンがない場合、サーバーは
WWW-Authenticateヘッダーを付けて401を返します。このヘッダーは/.well-known/oauth-protected-resourceを参照しており、クライアントはそこから OAuth エンドポイントを検出します。 - クライアントが Gridar のログインページを開きます。必要に応じてサインインし、Autoriser をクリックします。
- Gridar はクライアント名(例:
MCP - Claude Code)を付けた API トークンを作成し、クライアントに渡します。 - トークンは 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
- Settings > Connectors を開くか、カスタムコネクターを使うために Developer Mode を有効にします。
- URL
https://mcp.gridar.app/mcpを指定してコネクターを追加します。 - 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を参照)。ヘッドレスエージェントは、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(ローカル)
| Variable | Required | Default | Role |
|---|---|---|---|
BLOG_DASHBOARD_TOKEN | はい | なし | Authorization: Bearer として送信される Gridar API トークン(btb_xxx) |
BLOG_DASHBOARD_API_BASE | いいえ | https://api.gridar.app/api/v1 | Gridar API のベース URL |
セルフホスト型 HTTP(node dist/http.js)
| Variable | Default | Role |
|---|---|---|
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 | オン | Bearer チェックを省略するには false を設定します(開発時のみ) |
MCP_ALLOWED_ORIGINS | * | 許可する CORS オリジンのカンマ区切りリスト |
OAUTH_CLIENT_ID | 組み込み値 | 動的クライアント登録で返されるクライアント ID |
OAUTH_CLIENT_SECRET | 組み込み値 | 動的クライアント登録で返されるクライアントシークレット |
HTTP モードでは、トークンは各リクエストの Authorization ヘッダーから取得され、AsyncLocalStorage を使ってそのリクエストのみに適用されます。BLOG_DASHBOARD_TOKEN はフォールバックとして使われます。MCP_REQUIRE_AUTH=false の共有サーバーでは設定しないでください。設定すると、すべての呼び出し元がそのアカウントとして動作します。
HTTP エンドポイント:
| Method and path | Role |
|---|---|
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 アクセス | 1 時間あたりのリクエスト数 | 1 か月あたりの AI 記事数 |
|---|---|---|---|
| トライアル | いいえ(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 に 1 件のリクエストを送信し、1 時間あたりの上限に加算されます。上限を超えると、API は 429 を返します。
- 3 つのツールは、月間記事クォータを 1 件分、またはクォータを使い切った後はクレジットを 1 つ消費します:
gridar_generate_article、gridar_generate_sister_article、gridar_generate_landing。 - API エラーはツールエラーとして返されます:
Gridar API error (HTTP <status>): <message>に続いて JSON 本文が返されます。
ツール(69)
効果列は、呼び出しによって何が変更されるかを示します。
- destructive:何かを削除または無効化します。クライアントは先に確認する必要があります。
- publishes:コンテンツを公開するか、ページを一般公開します。
- quota:月間クォータから記事を 1 件分、またはクレジットを 1 つ消費します。
- writes:Gridar のデータを変更しますが、公開はしません。
- none:読み取り専用です。
アカウントとサイト
| ツール | 機能 | 効果 |
|---|---|---|
gridar_get_me | プラン、1 時間あたりの API 上限、月間記事クォータと使用状況 | none |
gridar_list_sites | 所有するサイト:ID、ドメイン、ホスティングモード、デフォルト言語 | none |
gridar_get_site | 1 つのサイトの完全な設定:連携機能、デフォルト言語、ナレッジベース、競合他社、GSC 接続、自動操縦、著者の E-E-A-T 項目 | none |
gridar_update_site | 編集可能なサイト項目を変更:名前、説明、ナレッジベース、競合他社、デフォルト言語、著者の略歴と資格情報、公開ブログのドメイン | writes |
記事
| ツール | 機能 | 効果 |
|---|---|---|
gridar_list_articles | サイトの記事。ステータス、言語、件数で絞り込みます(デフォルト 25、最大 100) | none |
gridar_get_article | site_id と slug を指定して取得する、1 つの記事の全コンテンツ(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 | キーワードのコンテンツブリーフです。検索意図、アウトライン、エンティティ、FAQ候補、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 つの重み付けされたチェック項目(FAQ、H2/H3 構成、E-E-A-T、具体的なデータ、抽出可能な段落)を基に、記事が AI の回答にどれだけ適しているかを 0〜100 で評価し、提案を提示します | なし |
サイトの健全性
| ツール | 内容 | 影響 |
|---|---|---|
gridar_site_seo_score | 9 つの重み付けされたチェック項目(インデックス登録可能性、著者プロフィール、ビジネスモデル、GSC、承認済みのピラーとスポークのクラスター、hreflang、Core Web Vitals、FAQ スキーマ、ブログ記事で停滞しているトランザクション検索意図)から、サイト全体のスコアを 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 | GSC の表示回数またはクリック数が N 日間(7〜90 日、デフォルトは 30 日)にわたって減少した記事を特定し、更新、拡充、リダイレクトを提案します | なし |
キーワード、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 の関連検索と「他の人はこちらも質問」、Gemini のバリエーション)。プロバイダーごとのステータスとともに、クエリをグループに分類します。検索ボリュームと難易度は含まれません | なし |
gridar_people_also_ask | キーワードに関する Google の「他の人はこちらも質問」の質問を取得します | なし |
gridar_classify_intent | キーワードの検索意図(トランザクション、商用、情報、ナビゲーション、ローカル)と信頼度スコアを提示します | なし |
gridar_analyze_competitors | キーワードに対する Google 検索結果の上位 10 件について、平均単語数、共通する見出し、エンティティの網羅状況、ギャップを提示します | なし |
gridar_serp_analyze | 上位 10 件の URL ごとの指標(単語数、H1/H2/H3、FAQ、動画)と平均値を提示し、競合記事の規模を把握できるようにします | なし |
gridar_suggest_competitors | ホームページと追跡中のキーワードを基に、SEO 競合他社の候補を提示します | なし |
gridar_link_opportunities | キーワードに関連するバックリンク獲得のアプローチ先候補を提示します。ドメイン、URL、タイトル、スニペット、検索クエリを含みます | なし |
戦略、ランディングページ、クラスター
| ツール | 機能 | 影響 |
|---|---|---|
gridar_propose_keyword_strategy | キーワードの構成を提案します。単独のランディングページ、ピラーとクラスター、比較表、ローカル向けランディングページ、ブログ記事から選びます。再実行すると下書きが更新されますが、承認済みの戦略は変更されません | 書き込み |
gridar_approve_strategy | 戦略を承認します。ランディングページはAIが下書きとして生成し、記事は gridar_generate_article が実行されるまで保留されます | 書き込み |
gridar_create_landing | 手書きの構造化されたランディングページを作成します(ヒーロー、価値提案、ソーシャルプルーフ、FAQ、下部CTA)。AIは使用せず、クォータも消費しません。ホスト型サイトのみ | 書き込み;status: published の場合は公開 |
gridar_generate_landing | キーワードからランディングページ全体をAIで生成し、ホスト型サイトに下書きとして保存します | クォータ |
gridar_link_pages | 同じサイト内のページ間に文脈に沿ったリンクを追加します。アンカーテキストをその場でリンクにするか、「Voir aussi」の行を追記します | 書き込み(リンク元ページを編集) |
gridar_cluster_map | サイトのトピッククラスター(ピラー、スポーク、対応済みページ、不足ページ)を表示します。LLMの呼び出しはありません | なし |
gridar_build_cluster | ピラーとスポーク用のプロンプトを作成し、内部リンクも含めます。不足しているキーワードをトラッキングに追加します。LLMの呼び出しもクォータ消費もありません。エージェントが文章を作成します | 書き込み |
戦略的な機会
| ツール | 機能 | 影響 |
|---|---|---|
gridar_refresh_strategic_opportunities | まだランディングページがない、取引目的、商業目的、またはローカル目的のトラッキング対象キーワードについて、機会エンジンを実行します。キーワードごとにClaudeを1回呼び出し、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 は概要に基づいてページを作成します。テンプレート化のみで、クォータは消費しません | なし |
エージェント経由の配信
Gridarから公開できないカスタム構築サイトの場合は、ダッシュボードでサイトの配信モードをエージェントに設定します。
| ツール | 機能 | 影響 |
|---|---|---|
gridar_pull_build_queue | 独自のリポジトリで構築するページのキューを表示します。ランディングページの概要、そのまま統合できる生成済み記事、記事の概要が含まれます。LLMの呼び出しもクォータ消費もありません | なし |
gridar_mark_page_built | キューにあるページが公開されたことをURLとともに報告します。Gridarはページをキューから削除し、順位トラッキングと成果の証明に紐付けます | 書き込み |
Google Search Consoleとインデックス登録
| ツール | 機能 | 影響 |
|---|---|---|
gridar_gsc_queries | 1つの記事について、N日間(既定値28、上限50)のGSCクエリ(表示回数、クリック数、掲載順位)を表示します。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 の状態と、ダッシュボードから AI エンジンへの照会はまだ行われていないことを示す note を返します | なし |
gridar_run_ai_visibility | コード ai_visibility_unavailable を含む HTTP 501 を返し、何も書き込みません | なし |
オートパイロット
| ツール | 機能 | 影響 |
|---|---|---|
gridar_get_autopilot | オートパイロットの設定と状態(有効かどうか、週あたりの実行回数、前回の実行、次回の実行、前回のエラー)を返します | なし |
gridar_set_autopilot | オートパイロットを有効化または設定します:enabled、weekly_count(1~7)、auto_publish | 書き込みます。それ以降、auto_publish: true の場合は公開します |
gridar_run_autopilot_now | スケジュール外でオートパイロットを1サイクル実行します | 書き込みます。auto_publish が有効な場合は公開します |
サイトのメモリー
| ツール | 機能 | 影響 |
|---|---|---|
gridar_list_memories | サイトのメモリーチャンク(記事、ナレッジベース、手動メモ、決定事項)をページ分割して返します | なし |
gridar_add_memory | メモを追加します。種類が manual または decision の場合、今後の生成でより重視されます | 書き込みます |
gridar_delete_memory | メモリーチャンクを1つ削除します | 破壊的 |
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はカウントがすべて 0 の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 は、最大 3 回の Serper 呼び出しで取得したオーガニック検索結果のうち、最も多い件数を保持します。
gridar_snapshot_keywordsは 1 回だけ呼び出します。どちらの場合も、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 の state はメモリに保存されます。 コードの有効期限は 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
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。