MCP Server ドキュメント
AI Visibility Indexは MCP (Model Context Protocol) に対応しています。Claude Desktop、Cursor、その他MCP対応AIエージェントから、日本EC企業104社のAI可視性ランキングデータに直接アクセスできます。
無料 匿名アクセスで月10回まで利用可能。APIキー登録不要。
🚀 クイックスタート
Claude Desktop
Claude Desktopの設定ファイル claude_desktop_config.json に以下を追加:
{
"mcpServers": {
"ai-visibility-index": {
"url": "https://ai-visibility-index.dev/mcp"
}
}
}
Cursor / その他のMCPクライアント
エンドポイントURLを指定するだけで接続できます:
https://ai-visibility-index.dev/mcp
プロトコル: Streamable HTTP(JSON-RPC 2.0 over HTTP POST)
🔧 利用可能なツール
1. check_ai_visibility
特定ドメインのAI可視性スコアを照会します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
domain | string | ✓ | 照会するドメイン(例: zozo.jp) |
レスポンス例(ヒット時):
{
"company": "ZOZOTOWN",
"domain": "zozo.jp",
"overallScore": 72.5,
"rank": 3,
"totalCompanies": 104,
"engines": {
"chatgpt": 85.0,
"claude": 70.0,
"gemini": 65.0,
"perplexity": 70.0
},
"_links": {
"fullReport": "https://ai-visibility-index.dev/tools/?domain=zozo.jp",
"industryRanking": "https://ai-visibility-index.dev/ranking/fashion/",
"pricing": "https://ai-visibility-index.dev/pricing/"
}
}
2. list_ai_visibility_industries
9業界のAI可視性サマリーを一覧で返します。パラメータ不要。
3. get_ai_visibility_methodology
スコアリング方法論(計算式・対象エンジン・クエリ種別・データ更新頻度)を返します。パラメータ不要。
🔐 認証
匿名アクセス(APIキーなし)で月10回まで利用できます。より多くのリクエストが必要な場合は、料金プランからAPIキーを取得してください。
APIキーは Authorization ヘッダーで送信します:
Authorization: Bearer avi_xxxxxxxxxxxxxxxxxxxxxxxx
⚡ レート制限
| プラン | 月間コール数 | バーストレート | 月額 |
|---|---|---|---|
| 匿名(キーなし) | 10 | 5/分 | 無料 |
| Free(登録済み) | 10 | 5/分 | 無料 |
| MCP Dev | 200 | 20/分 | ¥980 |
| Starter | 100 | 10/分 | ¥2,980 |
| Pro | 500 | 50/分 | ¥9,800 |
| Enterprise | 2,000 | 100/分 | ¥29,800 |
制限超過時は 429 Too Many Requests が返ります。
🔍 サーバーディスカバリ
MCP Discovery Protocolに対応しています:
GET https://ai-visibility-index.dev/.well-known/mcp.json
❌ エラーレスポンス
| コード | 意味 |
|---|---|
-32600 | 不正なリクエスト(JSON-RPC仕様違反) |
-32601 | 未知のメソッド |
-32602 | 不正なパラメータ |
-32000 | 認証エラー(無効なAPIキー) |
-32001 | レート制限超過 |