IndexMachine

IndexMachine MCP サーバー

AI アシスタントから、自分のサイトのページが Google に掲載されているか確認し、インデックス登録をリクエストできます。IndexNow にも通知できます。

この MCP サーバーを使うと、Claude Code、Cursor、VS Code、Claude Desktop、claude.ai から、IndexMachine に接続したサイトを操作できます。サイトやページの一覧表示、URL が Google に掲載されているかの確認、インデックス登録リクエストのクリックのキューへの追加（すでにインデックス登録されているページの再インデックスも可能）、Bing やその他の IndexNow 対応エンジンへの通知ができます。IndexMachine API をキーで呼び出し、API が対応していない操作は行いません。

リクエストの実際の流れ

IndexMachine は、リンクファームを使わず、お使いの Google Search Console からのインデックス登録リクエストと IndexNow を利用します。そのため、リクエストは即時に処理されるわけではなく、サーバーはその都度そのことを伝えます。

1. request_indexing はクリックをキューに追加します。それだけで Google にリクエストが届くわけではありません。
2. IndexMachine Chrome 拡張機能は、お使いの Chrome で、プロパティを所有する Google アカウントにログインしている場合、次回の確認時にリクエストを取得します。拡張機能 1.2.0 以降では約 5 分ごと、旧バージョンでは 30 分ごとに確認します。Chrome は起動している必要があります。拡張機能が 40 分間確認していない場合、予定時間は表示されず、リクエストはキューで待機します。
3. 拡張機能が Search Console で インデックス登録をリクエスト をクリックします。お使いになるのと同じボタンです。
4. Google が受け付けるリクエストは、1 サイトあたり 1 日に約 10 件です。1 日の区切りは太平洋時間の午前 0 時です。この件数は実測値であり、Google は公表していません。キューに追加したリクエストは、他のページに対する拡張機能の日次処理より優先され、同じ 10 件の枠を使います。サイトの当日分の枠を使い切ると、予定時間は太平洋時間の午前 0 時以降になります。
5. その後、Google がページをインデックス登録するかどうか、またその時期を決定します。登録まで数日かかることもよくあります。予定時間はクリックの予定であり、インデックス登録の予定ではありません。また、ページがインデックス登録されているかを確認できるのは check_url だけです。

すでに Google に掲載されているページの再インデックス（force: true）には、拡張機能 1.2.0 以降が必要です。IndexNow は Bing、Yandex、その他の IndexNow 対応エンジンに直接通知します。サイトに IndexNow キーファイルを設置する必要があり、1 サイトあたり 1 日に 20 件まで送信できます。Google には通知されません。

必要なもの

• サイトを接続した IndexMachine アカウント：app.indexmachine.co。無料で登録でき、Google にインデックス登録されていないページを確認できます。インデックス登録のリクエストには、サイトの有料プランが必要です（料金）。
• インデックス登録リクエストのクリックに使用する、インストール済みでログイン済みの IndexMachine Chrome 拡張機能。
• API キー（claude.ai ではリクエストヘッダーとして追加できます。リモートサーバーを参照）。

API キーを作成する

1. IndexMachine ダッシュボードを開き、プロフィールメニューから 設定 を選ぶか、app.indexmachine.co/settings に直接アクセスします。
2. API キー の下にある キーを作成 をクリックし、Claude Code などのラベルを付けます。
3. フルアクセス（リクエストの追加とキャンセル、IndexNow への送信も可能）または 読み取り専用（サイト、ページ、確認、リクエスト）を選びます。
4. キーをコピーします。キーは im_live_ で始まり、表示されるのは一度だけです。

同じページでいつでもキーを更新または取り消せます。1 つのアカウントで有効にできるキーは最大 10 個です。

インストール

このパッケージは npx（Node.js 20 以降）を使ってお使いのマシンで実行します。キーはユーザーレベルの設定に保存し、リポジトリ内のファイルには決して保存しないでください。

Claude Code（ユーザースコープを使用するため、キーはプロジェクトの .mcp.json に保存されません）

claude mcp add --scope user indexmachine --env INDEXMACHINE_API_KEY=im_live_... -- npx -y indexmachine-mcp

Cursor（ユーザーレベルのファイル ~/.cursor/mcp.json）

{
  "mcpServers": {
    "indexmachine": {
      "command": "npx",
      "args": ["-y", "indexmachine-mcp"],
      "env": { "INDEXMACHINE_API_KEY": "im_live_..." }
    }
  }
}

VS Code（.vscode/mcp.json）：VS Code がキーを求め、ファイルには保存しません。

{
  "inputs": [
    { "type": "promptString", "id": "indexmachine-key", "description": "IndexMachine API key", "password": true }
  ],
  "servers": {
    "indexmachine": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "indexmachine-mcp"],
      "env": { "INDEXMACHINE_API_KEY": "${input:indexmachine-key}" }
    }
  }
}

Claude Desktop（claude_desktop_config.json）：mcpServers の下に、Cursor と同じブロックを追加します。

その他の MCP クライアント：INDEXMACHINE_API_KEY を環境変数に設定して npx -y indexmachine-mcp を実行するか、下記のリモートサーバーを使います。

リモートサーバー

リモートサーバー https://mcp.indexmachine.co/mcp はインストール不要です。クライアントは API キーをヘッダーに指定します。

URL:    https://mcp.indexmachine.co/mcp
Header: Authorization: Bearer <your key>   (X-API-Key: <your key> works too)

Claude Code

claude mcp add --transport http indexmachine https://mcp.indexmachine.co/mcp \
  --header "Authorization: Bearer $INDEXMACHINE_API_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "indexmachine": {
      "url": "https://mcp.indexmachine.co/mcp",
      "headers": { "Authorization": "Bearer im_live_..." }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "inputs": [
    { "type": "promptString", "id": "indexmachine-key", "description": "IndexMachine API key", "password": true }
  ],
  "servers": {
    "indexmachine": {
      "type": "http",
      "url": "https://mcp.indexmachine.co/mcp",
      "headers": { "Authorization": "Bearer ${input:indexmachine-key}" }
    }
  }
}

claude.ai：カスタムコネクター

1. claude.ai で Customize > Connectors を開き、+ Add を押してから Add custom connector を選択します。
2. 名前に IndexMachine、URL に https://mcp.indexmachine.co/mcp を入力します。
3. Request headers で Authorization を追加し、値に Bearer im_live_... を指定してから Add を押します。
4. チャットで + を開き、Connectors を選択して IndexMachine をオンにします。

IndexMachine と Submitator コネクターは同じチャットで同時に有効にできます。ツール名は重複しません。

キーの代わりに IndexMachine アカウントでサインインする機能（OAuth）は、このサーバーに組み込まれていますが、IndexMachine の API がサインイン用トークンを発行するようになるまでは無効です。それまでは、サーバーはサインイン機能を提供せず、すべてのクライアントがキーを送信します。

リモートサーバーはリクエスト間で情報を保持しません。キーを IndexMachine API に渡し、使用後は破棄します。

ツール

ツール	機能
account_status	利用プラン、キーの権限と時間あたりの予算、Chrome 拡張機能がオンラインかどうか、Google の 1 日あたりの割り当てに対する本日のサイト別リクエスト数を確認します
list_sites	接続済みの Search Console プロパティとページ数、Google のインデックス登録が有効かどうか、有料プランの対象かどうか、IndexNow の準備ができているかどうかを一覧表示します
site_summary	1 つのサイトについて、本日の Request indexing の割り当て、最初のリクエストからインデックス登録までの日数の中央値、過去 30 日間の件数を表示します
list_pages	ステータス（indexed、not_indexed、awaiting、requested、rejected、needs_fix、excluded、not_found）または URL の一部でサイトのページを一覧表示します。1 回の呼び出しで最大 50 件です
check_url	URL がインデックス登録されているか、その時点、またはまだ確認されていない（未検査である）ことを示します。live: true を指定すると Google に即時確認し、1 サイトあたり 1 日 50 回のライブチェックのうち 1 回を使用します
request_indexing	Request indexing のクリックをキューに追加します。まだサイトのページではない URL も対象にでき、force: true を指定するとインデックス登録済みのページを再登録します。キュー内の位置と、正確な ETA を返します
get_indexing_request、list_indexing_requests	リクエストを追跡します。処理中のリクエストについては位置と ETA を、完了したリクエストについては Search Console からの回答を表示します
cancel_indexing_request	処理中のリクエストをキューから取り消します
submit_indexnow	1 つのサイトの URL を最大 100 件、Bing、Yandex およびその他の IndexNow 対応エンジンに通知します

プロンプト：index_url は URL を確認し、インデックス登録されていない場合はリクエストをキューに追加して、現在の ETA を報告します。

キーと安全性

• request_indexingはキューに追加する前にプレビューを表示します。すでにGoogleに登録されているページ、サイトマップに含まれていないURL、またはその日のサイトの最後のリクエストを再インデックスする場合は、事前に確認を求めます。拒否すると、何もキューに追加されません。ユーザーに確認できるクライアント（MCP elicitation）は、質問を直接表示します。回答がモデルを経由することはありません。回答が得られなかった場合も、何もキューに追加されません。確認できないクライアントや、リモートサーバー上で2026-07-28より前のMCPプロトコルを使用するクライアントには、理由とconfirmトークンを含む拒否が最初に返されます。このトークンはAPIキーを使ったHMACで、その日の、そのリクエストにのみ有効であり、サイトの割り当て量は変わりません。モデルはトークンを捏造できないため、呼び出しは必ず最初に拒否されます。その後、アシスタントがトークンを返す前に理由を表示するかどうかは、アシスタントと、ツール呼び出しに対するクライアントの承認設定次第です。サーバーからは確認できません。 submit_indexnowも、10件を超えるURLに対して同じ処理を行います。その場合、トークンはその太平洋時間の当日に指定したURLにのみ有効です。
• cancel_indexing_requestには破壊的操作としてdestructiveHint: trueが設定されており、該当するツールはこれだけです。リクエストを取り消します。読み取り専用のツールには読み取り専用と設定されているため、クライアントは確認なしで実行できます。
• npxパッケージは環境からキーを読み取り、https://api.indexmachine.coにのみ送信します。INDEXMACHINE_API_URLを使ってローカル開発サーバーを指定することはできますが、それ以外の場所は指定できません。
• 読み取り専用キーは、サイト、ページ、URLチェック、リクエストのみを確認するアシスタントに適しています。
• すべての呼び出しには、mcp-で始まるリクエストIDが付与されます。キーはいつでも設定ページで無効化できます。
• 脆弱性の報告は公開のイシューではなく、[email protected]宛てにメールでお送りください （SECURITY.md）。

開発

npm install
npm test               # unit, contract and protocol tests (it builds dist/ first)
npm run build
npm run sync:openapi   # refresh openapi/v1.json and src/v1.d.ts from https://api.indexmachine.co/v1/openapi.json
npm run check:pack     # pack, install in an empty folder, run the stdio handshake
npm run release:check  # what a release needs, then the publishing commands

openapi/v1.jsonは/v1のコントラクトであり、APIは同じドキュメントを/v1/openapi.jsonでも提供します。APIの新しいリリースが公開されたら、npm run sync:openapiとnpm testを実行して、新しい操作にツールを追加するか、EXCLUDEDに行を追加する必要があるか確認します（src/tools/index.ts）。

リモートサーバーは、ドメインmcp.indexmachine.coでVercel（vercel.json、api/）にデプロイされます。 MCP_OAUTH=1とMCP_OAUTH_KEYSを設定するとOAuthが有効になります。これらのキーで、IndexMachineのAPIはアクセストークンを暗号化します。

ライセンス

MIT