optiqra-mcp

optiqra-mcp

OptiQra のすべての API ツールを、MCP 対応の AI クライアント（Claude Desktop、Claude Code、Cursor など）に公開する MCP（Model Context Protocol）サーバーです。

OptiQra には 4 つの HTTP エンドポイントがあります。このサーバーは、そのすべてを MCP ツールとしてラップします。

ツール	OptiQra エンドポイント	機能
optiqra_analyze	POST /api/analyze	URL をクロールし、SEO/GEO/AEO/パフォーマンス/アクセシビリティ/セキュリティの完全な監査を実行します
optiqra_ai_fix	POST /api/ai-fix	レポートの問題 1 件に対する AI 生成の修正を作成します
optiqra_ai_insights	POST /api/ai-insights	レポート全体を対象に、サイト全体の AI 戦略の概要を作成します
optiqra_ai_test	POST /api/ai-test	上記 2 つのツールを使用する前に、プロバイダー/API キー/モデルの組み合わせが機能することを確認します

デフォルトでは、公開デモの https://optiqra.vercel.app に接続します。環境変数を設定して独自のデプロイ先を指定できます（OptiQra 独自の DEPLOYMENT.md / Docker の設定を参照）。詳細は以下をご覧ください。

インストール

npm install

（公開後は、npm install -g optiqra-mcp を実行するか、npx optiqra-mcp で直接実行できます）

設定（環境変数）

変数	必須	用途
OPTIQRA_BASE_URL	いいえ	接続先となる OptiQra インスタンスのベース URL。デフォルトは https://optiqra.vercel.app です。
OPTIQRA_PROVIDER_API_KEY	いいえ	モデルから渡されない場合に、optiqra_ai_fix / optiqra_ai_insights / optiqra_ai_test で使用するデフォルトの AI プロバイダー API キーです。モデルにキーを平文で扱わせるよりも、この方法を推奨します。
OPTIQRA_TIMEOUT_MS	いいえ	リクエストのタイムアウト時間（ミリ秒）。デフォルトは 120000 です（サイト全体のクロールには時間がかかる場合があります）。

単独で実行する

node src/index.js

stdio 経由で MCP と通信するため、何も起きていないように見えますが、MCP クライアントの接続を待っています。

MCP クライアントに接続する

Claude Desktop / Claude Code

MCP の設定（claude_desktop_config.json、または Claude Code の場合は claude mcp add を使用）に追加します。

{
  "mcpServers": {
    "optiqra": {
      "command": "node",
      "args": ["/absolute/path/to/optiqra-mcp/src/index.js"],
      "env": {
        "OPTIQRA_BASE_URL": "https://optiqra.vercel.app",
        "OPTIQRA_PROVIDER_API_KEY": "sk-..."
      }
    }
  }
}

Any other MCP-compatible client (Cursor, Windsurf, etc.) uses the same
`command`/`args`/`env` shape — check that client's docs for where the config
file lives.

## Notes on the AI-key tools

`optiqra_ai_fix`, `optiqra_ai_insights`, and `optiqra_ai_test` all need a
provider API key, exactly like pasting one into OptiQra's own UI — OptiQra's
server forwards it straight to the provider (OpenAI, Anthropic, Google, Groq,
OpenRouter, Mistral, DeepSeek, or xAI) and never stores it. This server does
the same: it never persists keys. Prefer setting `OPTIQRA_PROVIDER_API_KEY`
in your MCP client's env config over having the model pass a key through
chat.