cituna-mcp

Cituna MCP：AI ビジビリティ MCP サーバー

Cituna MCP は、Cituna の公式 MCP サーバーです。AI ビジビリティツールである Cituna を使うと、AI エージェントは 7 つの AI エンジンが毎日あなたのブランドについてどのように回答し、言及し、引用しているかを、Google Search Console のデータとあわせて確認し、31 個のツールで対応できます。

7 つのエンジンは、ChatGPT、Perplexity、Gemini、Claude、Grok、Google AI Overviews、Google AI Mode です。追跡対象のプロンプトは毎日、すべてのエンジンに送信されます。サーバーを Claude、ChatGPT、Cursor、VS Code、その他の MCP クライアントに接続すれば、どの購入検討者の質問に答えられていないか、各エンジンが実際にどう回答したか、どのページを読んだか、まず何を修正すべきかを尋ね、その後エージェントに修正を任せることができます。

ホスト型で、Streamable HTTP に対応し、ブラウザーで OAuth 認証を行います。URL は 1 つだけで、インストールは不要です。

https://mcp.cituna.com/mcp

スクリプト、CI、または OAuth に対応しないクライアント向けに自分で実行しますか？同じサーバーを npm から利用できます。個人用 API キーが必要で、Node 20 以降に対応しています。

npx -y cituna-mcp

製品ページとドキュメント全文：cituna.com/mcp。

概要
ホスト型 URL	https://mcp.cituna.com/mcp（Streamable HTTP、OAuth 2.1 または API キー）
ローカルパッケージ	npm の npx -y cituna-mcp（stdio、API キー、Node 20 以降）
エンジン	ChatGPT、Perplexity、Gemini、Claude、Grok、Google AI Overviews、Google AI Mode。毎日チェック
連携対象	Google Search Console（読み取り専用）、AutoSEO 記事、修正キュー
ツール	合計 31 個：読み取りツール 22 個、書き込みツール 9 個
組み込みワークフロー	MCP プロンプト 5 個（診断、AEO ギャップ、競合分析、週次レビュー、修正の優先順位付け）
プラン	Starter（$49/mo）では読み取りツールを利用可能。Pro（$119/mo）と Max（$399/mo）では書き込みツールと list_keywords を利用可能。無料トライアルでは MCP を利用できません
レジストリ名	公式 MCP Registry の com.cituna/cituna-mcp
対応環境	claude.ai、Claude Desktop、Claude Code、ChatGPT、Cursor、VS Code、Windsurf、Codex CLI、その他の MCP クライアント
ライセンス	このサーバーは MIT ライセンスです。Cituna 自体は有料サービスです

目次

• エージェントにできること
• 質問例
• クイックスタート：claude.ai、Claude Desktop、Claude Code、ChatGPT、Cursor、VS Code、Windsurf、Codex CLI、Gemini CLI、その他のクライアント
• ツール
• プランとアクセス
• 組み込みワークフロー
• セッションの流れ
• Google Search Console の接続
• 認証とセキュリティ
• リモートサーバーのセルフホスト
• トラブルシューティング
• よくある質問
• リンク

エージェントにできること

多くのAI可視性ツールはダッシュボードを渡すだけで、考える作業はユーザー任せです。Citunaは、測定結果をすでに思考している場所に届けます。あるエンジンがなぜ自社に言及しないのかをエージェントに尋ねると、回答の根拠を取得し、Googleからすでに届いている情報と照合し、修正するページをキューに追加します。タブを開く必要はありません。

• 毎日のトラッキンググリッドを確認します。 今日、各エンジンが追跡対象のプロンプトのうち、どれで自社を引用したか、その掲載順位と現在の可視性スコアを確認します（get_visibility）。
• 回答の根拠を取得します。 あるプロンプトに対してエンジンが実際に回答した内容、言及したブランド、引用したURLを確認します（get_engine_answers）。
• 回答の出所を特定します。 自社のプロンプトに対してエンジンが引用するサードパーティのページ、その引用頻度、各ページで言及されている競合、自社がそのページに掲載されているかどうかを、推測ではなくページそのものから読み取ります（list_citation_sources）。
• 新たな競合を見つけます。 自社の購入検討者向けの質問への回答でエンジンが言及したブランドや、自社にたどり着く前に検索されるベンダー名のうち、まだ追跡していないものを確認します（competitor_discovery）。
• AIの回答とGoogleのデータを結び付けます。 Search Consoleの合計値、任意のSearch Analyticsクエリ、さらにすぐ使える6つの分析（1ページ目に届かないクエリ、表示されてもクリックされないページ、検索意図別の需要、一度も表示されていないページ、自社ページ同士の競合、AIプロンプトのような検索）を利用します（gsc_*）。
• 修正キューに対応します。 最新の監査で見つかったすべてのギャップについて、影響度、作業量、具体的な修正内容を確認し、作業を進めながらステータスを更新します（list_gaps、set_gap_status）。
• コンテンツを計画して公開します。 実際の需要があるのにコンテンツがないキーワード、AutoSEOキューと生成済みの記事を確認し、チャットからキューへの追加、編集、更新、スキップを行います（list_keywords、queue_article、update_article、enrich_article）。
• 測定対象を変更します。 7つのエンジンが毎日尋ねる購入検討者向けの質問を追加、無効化、書き換えし、変更前後の差分を確認します（set_prompts）。
• 新しいスキャンを実行します。修正を公開し、すぐに状況を確認したいときに実行します（run_scan）。
• アプローチ先リストを管理します。 引用元を「予定」「提案済み」「掲載済み」「辞退」に設定し、セッションをまたいでもリストを保持します（set_outreach_status）。

質問してみる

接続したら、英語で普通に質問してください。サーバーが、どのツールとワークフローでどの種類の質問に答えられるかをエージェントに伝えるため、ツール名を指定する必要はありません。

可視性と回答の根拠

• 「今日、acme.comはAI検索でどのような状況ですか？どのプロンプトとエンジンが自社を引用していますか？」
• 「歯科医院向けの最適なCRMについて、Perplexityは何と回答し、自社の代わりに誰を引用しましたか？」
• 「今週、AI可視性にどのような変化があり、どのエンジンで掲載順位が下がりましたか？」
• 「AIエンジンはなぜ自社に言及しないのですか？引用されていない理由を診断してください。」

情報源と競合

• 「自社のことにまだ言及していないエンジンは、どのサイトを参照していますか？提案先リストとして順位付けしてください。」
• 「エンジンがすでに引用している自社ページはどれですか？」
• 「自社の代わりに誰が挙げられていますか？また、まだ追跡していない競合はどれですか？」
• 「G2のカテゴリーページを提案済みにしてください。」(Pro)

Search Consoleとの連携

• 「1ページ目にあと一歩のクエリと、それぞれで順位を獲得しているページはどれですか？」
• 「表示回数はあるのにクリックされていないページと、その理由を教えてください。」
• 「Googleで表示されているのにAIが自社を引用しないのはどこですか？それがAEOのターゲットリストです。」
• 「同じクエリで自社のページが2つ競合していますか？」
• 「AIプロンプトのような検索はどのくらいありますか？」

修正とコンテンツ

• 「acme.comの未対応のギャップを一覧にして、それぞれが影響するSearch Consoleの表示回数で順位付けしてください。」
• 「需要があるのに対応するページがないキーワードはどれですか？上位3つをキューに追加してください。」(Pro)
• 「更新時期を迎えているAutoSEOの記事はどれですか？更新してください。」(Pro)
• 「今週失った質問を3つ、追跡対象のプロンプトに追加し、誰も検索しないものは無効にしてください。」(Pro)
• 「acme.comを新たにスキャンし、上位3つのギャップを要約してください。」(Pro、スキャンを1回使用)

クイックスタート

必要なもの： Starter 以上のプランで、追跡中のブランドが1つ以上ある Cituna アカウント。3日間の無料トライアルはアプリ専用です。MCP へのアクセスは、プランの利用開始時に有効になります。新しいワークスペースにはまだ参照できる情報がないため、まずアプリでブランドを追加してください（cituna.com）。

接続方法は2つあり、どちらもまったく同じツールを公開します。

	ホステッドコネクター（推奨）	ローカル npm パッケージ
アドレス	https://mcp.cituna.com/mcp	npx -y cituna-mcp
トランスポート	Streamable HTTP	stdio
サインイン	ブラウザーでの OAuth、または API キーヘッダー	CITUNA_API_KEY 環境変数
ローカルで必要なもの	なし	Node 20 以降
利用可能な環境	claude.ai のウェブ版やモバイル版を含む、以下のすべてのクライアント	デスクトップおよびターミナルのクライアント

claude.ai（ウェブ版とモバイル版）

1. Claude で Customize → Connectors を開き、Add をクリックしてから Add custom connector を選択します。

2. 名前を Cituna にして、次の URL を貼り付けます。

   https://mcp.cituna.com/mcp
   

3. Claude から Cituna に移動してサインインすると、同意画面が表示されます。Claude がスキャンを実行し、キューを処理できるようにするには（Pro および Max）、Also allow changes にチェックを入れたままにします。読み取り専用で接続する場合は、チェックを外します。

4. チャットで + メニューから Cituna を有効にし、最初の質問をしてみましょう。

Team および Enterprise プランでは、オーナーが Organization settings → Connectors でコネクターを一度追加し、その後、各メンバーが Customize → Connectors から接続して、自分の Cituna アカウントでサインインします。claude.ai で追加したコネクターは、同じアカウントでサインインしている Claude Desktop とモバイルアプリでも利用できます。

Claude Desktop

上記のコネクターを使うのが最も簡単です。Customize → Connectors → Add → Add custom connector を選択して https://mcp.cituna.com/mcp を貼り付け、ブラウザーで承認します。

代わりに npm パッケージをローカルで実行するには、API キーを生成し（下記）、claude_desktop_config.json（Settings → Developer → Edit Config）を編集します。

{
  "mcpServers": {
    "cituna": {
      "command": "npx",
      "args": ["-y", "cituna-mcp"],
      "env": {
        "CITUNA_API_KEY": "cituna_sk_your_generated_key"
      }
    }
  }
}

Windows でサーバーが起動しない場合は、npx を cmd 経由で実行します。"command": "cmd" および "args": ["/c", "npx", "-y", "cituna-mcp"] を指定してください。Claude Desktop を再起動すると、チャットボックスの + ボタンの下にツールが表示されます。

Claude Code

ブラウザーでサインインするホステッド接続：

claude mcp add --transport http cituna https://mcp.cituna.com/mcp

次に、Claude Code 内で /mcp を実行し、cituna を選択して Authenticate を選びます。OAuth の代わりに API キーを使用する場合：

claude mcp add --transport http cituna https://mcp.cituna.com/mcp \
  --header "Authorization: Bearer cituna_sk_your_generated_key"

または、すべてのプロジェクトで利用できる npm パッケージをローカルで実行します。

claude mcp add cituna --scope user \
  --env CITUNA_API_KEY=cituna_sk_your_generated_key \
  -- npx -y cituna-mcp

/mcp を実行して接続を確認してから、「今週、AI での私の可視性にどんな変化がありましたか？」 と質問してみましょう。

ChatGPT

ChatGPT は同じホステッド URL に接続します。そう、ChatGPT に、ChatGPT があなたをどのように引用しているかを尋ねることができます。

1. ウェブ版 ChatGPT で Settings → Security and login を開き、Developer mode を有効にします。この機能は Plus、Pro、Business、Enterprise、Edu で利用できます。
2. Plugins を開き、+ をクリックしてから Create MCP App を選択します。
3. 名前を Cituna にして https://mcp.cituna.com/mcp を貼り付け、OAuth を選択して作成します。
4. Cituna にサインインします。書き込みを許可する場合は、Also allow changes にチェックを入れて承認します。その後、+ メニューからチャットに Cituna を追加します。

ChatGPT は変更のたびに確認を求めます。Starter では読み取りが利用でき、スキャンや編集には Pro または Max が必要です。承認済みの ChatGPT 接続は Cituna アプリの Integrations に一覧表示され、そこで接続を解除できます。

Cursor

または、~/.cursor/mcp.json（すべてのプロジェクト）か .cursor/mcp.json（1つのプロジェクト）に追加します。

{
  "mcpServers": {
    "cituna": {
      "url": "https://mcp.cituna.com/mcp"
    }
  }
}

Cursor の MCP 設定にサーバーがサインインボタン付きで表示されます。ボタンをクリックし、Cituna にサインインして承認してください。OAuth を省略するには、API キーをヘッダーとして送信します。

{
  "mcpServers": {
    "cituna": {
      "url": "https://mcp.cituna.com/mcp",
      "headers": { "Authorization": "Bearer cituna_sk_your_generated_key" }
    }
  }
}

または、"command": "npx"、"args": ["-y", "cituna-mcp"]、"env": { "CITUNA_API_KEY": "cituna_sk_..." } を指定してローカルで実行します。Cursor のエージェントチャットからツールを使用できます。

VS Code（GitHub Copilot）

または、コマンドラインから：

code --add-mcp '{"name":"cituna","type":"http","url":"https://mcp.cituna.com/mcp"}'

または、1 つのワークスペース用に .vscode/mcp.json に設定します（すべてのワークスペースに設定するには、コマンドパレットから MCP: Open User Configuration を実行します）。

{
  "servers": {
    "cituna": {
      "type": "http",
      "url": "https://mcp.cituna.com/mcp"
    }
  }
}

ツールを初めて実行すると、VS Code で Cituna へのサインイン画面が開きます。API キーを使用するには、VS Code に一度入力を求めさせ、ファイルには保存しないようにします。

{
  "inputs": [
    { "type": "promptString", "id": "cituna-key", "description": "Cituna API key (cituna_sk_...)", "password": true }
  ],
  "servers": {
    "cituna": {
      "type": "http",
      "url": "https://mcp.cituna.com/mcp",
      "headers": { "Authorization": "Bearer ${input:cituna-key}" }
    }
  }
}

Copilot Chat を Agent モードで開くと、ツールピッカーに Cituna のツールが表示されます。

Windsurf

~/.codeium/windsurf/mcp_config.json に設定します（または、同じファイルを開く Windsurf の MCP 設定を使用します）。

{
  "mcpServers": {
    "cituna": {
      "serverUrl": "https://mcp.cituna.com/mcp"
    }
  }
}

お使いの Windsurf のバージョンでブラウザーからのサインイン画面が開かない場合は、serverUrl の隣に "headers": { "Authorization": "Bearer cituna_sk_your_generated_key" } を追加します。

Codex CLI

API キーを指定して npm パッケージを実行します。

codex mcp add cituna --env CITUNA_API_KEY=cituna_sk_your_generated_key -- npx -y cituna-mcp

これにより、~/.codex/config.toml に次の内容と同等の設定が書き込まれます。

[mcp_servers.cituna]
command = "npx"
args = ["-y", "cituna-mcp"]
env = { CITUNA_API_KEY = "cituna_sk_your_generated_key" }

Gemini CLI

gemini mcp add --transport http cituna https://mcp.cituna.com/mcp

次に、/mcp auth cituna を実行してサインインします。または、~/.gemini/settings.json で OAuth の代わりに API キーを使用します。

{
  "mcpServers": {
    "cituna": {
      "httpUrl": "https://mcp.cituna.com/mcp",
      "headers": { "Authorization": "Bearer cituna_sk_your_generated_key" }
    }
  }
}

その他の MCP クライアント

• リモートサーバーに対応している場合： Streamable HTTP 経由で https://mcp.cituna.com/mcp に接続します。OAuth に対応していれば、401 チャレンジからサインイン先を自動で検出します。対応していない場合は、Authorization: Bearer cituna_sk_...（または X-API-Key: cituna_sk_...）を送信します。
• stdio のみに対応している場合： 環境変数 CITUNA_API_KEY を設定して npx -y cituna-mcp を実行します。

開発用にソースから実行する場合：

git clone https://github.com/cituna/cituna-mcp && cd cituna-mcp
npm install && npm run build   # then: node dist/index.js

API キーの取得

ホスト型コネクターにはキーは不要です。npm パッケージとヘッダーオプションにはキーが必要です。

1. Cituna アプリで Integrations → Claude / MCP access を開き、Generate token をクリックします。
2. cituna_sk_... の値をコピーします。この値は一度だけ表示されます。
3. 上記のように、クライアントの設定に貼り付けます。

キーは自動的に期限切れになることはなく、パスワードでもありません。アプリからいつでも無効化できます。同じキーを Looker Studio コネクターと REST API にも使用できます。各ユーザーがそれぞれ自分のキーを使用してください。キーは 1 つのワークスペースとして機能し、それ以外の用途はありません。

ツール

ツールは 31 個あり、読み取りツールが 22 個、書き込みツールが 9 個です。読み取りツールは Starter で利用できますが、例外として list_keywords は Pro に含まれるキーワードデータセットを読み取ります。9 個の書き込みツールは Pro 以上が必要です。また、Also allow changes を許可せずに承認された接続では、どのプランでもこれらのツールを呼び出せません。各ツールには MCP アノテーション（readOnlyHint、destructiveHint、idempotentHint）が付いているため、クライアントは読み取りを自動承認し、書き込みの前に確認を求めることができます。set_prompts、update_article、enrich_article は削除や上書きを行う可能性があるため、破壊的操作としてマークされています。

まずはこちら

ツール	プラン	入力	機能
whoami	Starter	なし	サインイン中のアカウント（メールアドレス、ワークスペース、ロール）、バックエンド URL、プラン、すべての使用状況メーター（ツールごとの使用量と上限、ブランド数、プロンプトプール数）を返します。最初に呼び出してください。Search Console の状態は gsc_status が確認します。
list_brands	Starter	なし	ワークスペースが追跡しているブランドとドメインを返します。これらは他のすべてのツールへの入力となります。
gsc_status	Starter	なし	Google Search Console が接続されているかどうか、接続済みの Google アカウント（1 つのワークスペースに複数接続できます）、各アカウントで読み取り可能な検証済みプロパティを返します。

日次の AI 可視性トラッキング

ツール	プラン	入力	機能
get_visibility	Starter	brand	ブランドの日次最新グリッドです。追跡対象の各プロンプトと7つのエンジンそれぞれについて、引用の有無、掲載順位、実行されたエンジンモード、セルのステータスに加え、現在の可視性スコアと測定された UTC の日付を確認できます。unavailable セルは、今回エンジンから回答がなかったことを示すもので、未掲載を意味するものではありません。自動的に再確認されます。
get_engine_answers	Starter	brand、prompt、engine（任意）	回答の記録です。最新日に1つのプロンプトに対して各エンジンが返した回答テキスト（約4,000文字まで。truncated フラグ付き）、引用されたブランド、ソース URL、自社の掲載順位を確認できます。
set_prompts	Pro、書き込み	brand、続けて add、remove、enable、disable または replace	7つのエンジンに毎日尋ねる購入者の質問を編集し、変更前後の差分を確認できます。remove と replace はグリッド内のプロンプトとその履歴を削除するため、支出を止めるには、元に戻せる disable を使用してください。

監査と修正キュー

ツール	プラン	入力	機能
list_audits	Starter	domain（任意）	最近の監査を新しい順に表示します。スキャン ID、ドメイン、日付、AI 引用スコア、SEO、GEO、権威性の各スコア、未解決のギャップ数、scoring_epoch を確認できます。スコアを比較する場合は同じエポック内に限ってください。エポックをまたいで比較する場合は、引用数を比較してください。
get_audit	Starter	scanId	1件の監査の全詳細です。全体およびエンジン別のスコア、クエリとエンジンの引用マトリックス（各セルは cited、not_cited、not_run のいずれか。クエリへの回答を見送ったエンジンは未掲載を意味しません）、引用された競合他社、主なギャップ、監査で読み取った全ページにわたる SEO と GEO のチェック項目の判定別集計（アプリの「修正が必要な項目数」と同じ件数）、修正が必要なチェック項目（ページ単位で評価する場合は、検査したページ数と合格したページ数）、ページ横断的な推奨事項、監査で読み取ったページ数を確認できます。
run_scan	Pro、書き込み	url、competitors（任意）	新しい監査を実行し、約1分で完了結果を返します。月間枠からスキャンを1回消費し、新しいドメインは追跡対象のブランドになります。get_audit による既存監査の閲覧は無料です。
list_gaps	Starter	domain または scanId	修正キューです。各ギャップの gapKey、ステータス（todo、doing、done）、タイトル、カテゴリ、影響度、作業量、具体的な修正方法を確認できます。
set_gap_status	Pro、書き込み	domain、gapKey、status	1つのギャップを todo、doing、done に変更します。

引用元と競合他社

ツール	プラン	入力	機能
list_citation_sources	Starter	domain、続けて任意の search、engine、range、gapsOnly	プロンプトへの回答でエンジンが引用した第三者ページをホスト別に集計します。各ページの引用頻度、言及している競合他社、回答しているプロンプト、ページを開いて確認した youOnThisSite（不在、言及あり、リンクあり、到達不能、不明）を確認できます。また、エンジンがすでに引用している自社ページを最大50件まで確認でき、各エンジンが最も多く参照しているサイトも確認できます。特定のブランド、ホスト、URL を検索するには search を指定します。
set_outreach_status	Pro、書き込み	domain、host、status	1つのソースホストへの働きかけの状況を記録します。planned、pitched、placed、declined を指定でき（none でクリア）、以降のすべての list_citation_sources 呼び出しに反映されます。
competitor_discovery	Starter	domain、続けて任意の days、minEvidence	まだ追跡していない競合他社を表示します。プロンプトへの回答でエンジンが挙げたブランドと、ユーザーが自社にたどり着く前に検索したベンダー名を、根拠の強さ順に確認できます。

Google Search Console

ツール	プラン	入力	機能
gsc_overview	Starter	domain, days	過去 N 日間のクリック数、表示回数、CTR、平均掲載順位に加え、上位のクエリとページ、国別・デバイス別の内訳、日次の推移を表示します。
gsc_query	Starter	domain または siteUrl、dimensions、days または startDate と endDate、filters、rowLimit	クエリ、ページ、国、デバイス、検索での見え方、日付で絞り込むなど、フィルター、検索タイプ、ページングを指定して、あらゆる検索アナリティクスのクエリを実行します。
gsc_striking_distance	Starter	domain、任意で minPosition、maxPosition、minImpressions	1 ページ目目前のクエリ（デフォルトでは掲載順位 11～60 位）を、現実的な順位上昇による効果が大きい順に表示します。それぞれのクエリで、ランクインしているページも確認できます。
gsc_zero_click_pages	Starter	domain、任意で minImpressions、maxClicks	Google に表示されてもクリックされないページを、原因別（ブランド、スニペット、2 ページ目、ランキング）に分類して表示します。原因ごとに異なる対策が必要なためです。
gsc_query_mix	Starter	domain、任意で competitors	ドメインが獲得する需要を、検索意図（ブランド、競合の代替、ペルソナ、商用、ツール、ハウツー、カテゴリ）別に分類し、グループごとに表示回数、クリック数、掲載順位を表示します。
gsc_coverage_gap	Starter	domain、days	Google に一度も表示されたことのないサイトマップ内のページを URL プレフィックス別にまとめ、掲載されていないセクションを見つけやすくします。サイト自体からサイトマップを取得します。
gsc_cannibalisation	Starter	domain、任意で minImpressions	2 つ以上の自社ページが競合しているクエリを、それぞれのページの掲載順位と表示回数、および Google が優先しているページとともに表示します。
gsc_ai_searches	Starter	domain、days	AI へのプロンプトのような形式（追加の質問、チャットの返信、指示、貼り付けられたテキスト）の検索を表示し、AI 利用の最低限の目安を示します。Search Console には AI Overviews や AI Mode のフィルターがないため、これらは Google の AI に関する数値ではありません。

キーワードと AutoSEO 記事

ツール	プラン	入力	内容
list_keywords	Pro、読み取り	domain、続いて任意で stage、includeSearchConsole	トラッキング中のすべてのキーワードについて、Google での順位、月間検索ボリューム、競合度、およびそのキーワードに対応するページのステージを確認できます。stage: "none" は候補リストです。検索需要はあるものの、まだ何も書かれていないキーワードが表示されます。順位は順位チェッカー（上位20位）と Search Console（28日間の平均）から取得されます。
list_content_queue	Starter	domain、続いて任意で status、before	AutoSEO で進行中の内容を確認できます。執筆待ちのトピックと、生成済みまたは公開済みの記事について、それぞれのキーワードまたはプロンプトも表示されるため、同じ内容が重複してキューに入ることはありません。
list_articles	Starter	domain、続いて任意で status、before	AutoSEO 記事ごとに1行で、新しい順に表示されます。id、タイトル、公開中の URL、ステータス、キーワード、公開日時、サイトへの最終送信日時、編集日時と更新日時、記事固有の Search Console データ、更新時期かどうか（enrich.eligible）を確認できます。記事本文は表示されません。
get_article	Starter	id	1件の記事について、保存されたテキスト（タイトル、メタタイトルと説明、デック、セクション、FAQ、タグ）、公開前チェックで検出された内容、前回更新時の更新前と更新後を確認できます。
queue_article	Pro、書き込み	domain、keyword、続いて任意で impressions、position	キーワードをキューに入れ、次回の実行時に AutoSEO が記事の下書きを作成するようにします。そのキーワードのトピックまたは記事がすでにある場合、サイトにすでに対応するページがある場合（結果にそのページが表示されます）、またはキューがいっぱいの場合は、キューに追加されません。該当する理由は reason に表示されます。
mark_article_published	Pro、書き込み	domain、keyword、url	自分で執筆した記事、または自分の CMS から公開した記事など、キーワードに対応するページが公開中であることを Cituna に伝えます。これを行わないと、Cituna はそのキーワードを未執筆として扱い続け、競合するページの執筆を提案します。
update_article	Pro、書き込み	id、続いて title、metaTitle、metaDescription、dek、sections、faqs、tags のいずれか	記事の保存テキストのフィールドを上書きします。サイトに公開済みのページは、Cituna アプリから記事を再送信すると更新されます。
enrich_article	Pro、書き込み	id	記事を公開したサイトで、その記事固有の Search Console クエリを使って、公開中の記事の SEO タイトル、メタディスクリプション、最大2件の FAQ の回答を更新し、更新前と更新後を返します。list_articles で更新時期と表示される記事のみが対象です。月間利用枠から1回分の生成を使用します。
skip_queued_topics	Pro、書き込み	ids	最大50件のトピックを AutoSEO のキューから削除し、記事が作成されないようにします。同じテキストを再度キューに入れると、トピックが再びキューに追加されます。

プランとアクセス

MCP サーバーは、すべての有料 Cituna プランに含まれています。個別の追加オプションや無料の MCP プランはありません。3 日間の無料トライアルはアプリのみで利用でき、トライアルが終了してプランに加入していない場合、サーバーは呼び出せません。

	Starter ($49/mo)	Pro ($119/mo)	Max ($399/mo)
MCP アクセス	読み取り専用	読み取りと書き込み	読み取りと書き込み
読み取りツール（22）	21：list_keywords を除くすべての読み取りツール	22 個すべて	22 個すべて
書き込みツール（9）	なし（アプリで実行）	9 個すべて	9 個すべて
月間 MCP 呼び出し数	5,000	10,000	30,000
7 つすべてのエンジンで毎日チェックするプロンプト数	10	30	90
トラッキングするブランド数	1	3	10
月間再スキャン数（run_scan は 1 回分を使用）	10、アプリで実行	15	20

制限の動作は次のとおりです。

• Starter で書き込みツールを使うと、Pro を案内するプランメッセージが返され、何も変更されません。Starter でもスキャンの実行やキューの操作はアプリで行えますが、エージェントからは実行できません。
• 書き込みにはプランだけでなくスコープも必要です。 同意画面で 変更も許可する のチェックを外すと、Pro または Max でも接続は読み取り専用になります。後から書き込みを追加するには、インテグレーション で接続を解除し、チェックを入れて再接続してください。
• 月間 MCP 呼び出し上限にはすべての呼び出しが含まれます。上限に達すると、プラン上限のメッセージ（HTTP 402）が返されます。アップグレードするか、期間がリセットされるまでお待ちください。HTTP 429 は別の短時間の呼び出し制限です。指定された秒数待ってから再試行してください。
• run_scan は月間上限からスキャン回数を 1 回分消費し、トラッキングしていないドメインをスキャンすると、プランのブランド上限に対してそのドメインがブランドとして追加されます。それ以外のツールは、Cituna がすでに収集したデータを読み取ります。
• enrich_article は月間上限から生成回数を 1 回分消費し、サイト上の公開中のページを変更します。

カスタムの Enterprise プランでは、請求書払いで上限をさらに引き上げられます。プランごとの上限の詳細については、cituna.com/pricing をご覧ください。

組み込みワークフロー

サーバーには、MCP プロンプト API を通じて 5 つの分析ワークフローが用意されています。Claude ではプロンプトピッカーに表示されます。どのクライアントでも、サーバーの指示により、どの質問にどのワークフローが答えるかがエージェントに伝わるため、自然な英語で質問するだけで自動的に振り分けられます。各ワークフローは、Search Console のデータと各エンジンの実際の回答テキストを組み合わせます。一般的な SEO ツールでは、これを実現できません。

プロンプト	引数	内容
why-am-i-not-cited	brand、prompt（任意）	引用されていないすべてのプロンプトを、どこにも表示されない、Google には表示されるが AI には表示されない、一部で引用される、のいずれかに分類し、エンジンの回答と Search Console の根拠を示します。
gsc-to-ai-gap	domain、days（任意）	Google で実際にインプレッションが発生しているのに AI から引用されないクエリを調べ、優先度順の AEO 対象リストを作成します。
competitor-teardown	brand、competitor（任意）	回答テキストをもとに、各エンジンが実際にどの競合を引用しているかを集計し、設定済みの競合リストと比較します。
weekly-review	brand	監査、Search Console、ギャップキューをもとに、今週の成果、後退した点、今週実施すべき 3 つのアクションを示します。読み取り専用です。
prioritize-fixes	domain	各ギャップが対象とする Search Console のインプレッション数と引用されていないプロンプト数をもとに、修正キューの優先順位を付け直します。

いずれも、それだけで有料スキャンを開始することはありません。

セッションの様子

サーバー接続後の最初の会話例です（acme.com はブランド名の例です）。

あなた： スケジュール管理ソフトウェアを販売しています。なぜ ChatGPT は私たちのことをまったく取り上げないのでしょうか？

Claude： (whoami → Pro、15 回中 4 回のスキャンを使用 · list_brands → acme.com · gsc_status → 接続済み) acme.com が引用されない原因を診断します。

(get_visibility) 18 個のプロンプト×エンジンの組み合わせのうち、引用されているのは 3 件です。ChatGPT はカテゴリーに関する 6 つのプロンプトすべてに回答していますが、あなたを一度も引用していません。

(get_engine_answers on the 3 biggest) 「クリニック向けの最適なスケジュール管理ソフトウェア」では、ChatGPT は Calendly、Acuity、Capterra のまとめ記事を引用しています。引用されているのはすべてサードパーティーのリストです。競合他社も含め、ベンダー自身のサイトはひとつもありません。

(gsc_query) Google ではすでに、この検索意図で平均掲載順位 8.4 位、1,240 回の表示回数を獲得しています。つまり、インデックス登録の問題ではありません。

調査結果： あなたは Google では見つかりますが、AI には見つけられていません。ChatGPT は、あなたが掲載されていないまとめ記事をもとに回答を作成しているため、サイト内でどれだけ取り組んでも改善しません。まとめ記事に掲載されることが改善の鍵です。

(list_keywords stage:"none") 「クリニック向けスケジュール管理ソフトウェア」には需要がありますが、それに応えるページがありません。キューに追加しましょうか？ (queue_article)

上記の操作では、スキャンを消費しません。すべて Cituna がすでに収集したデータの読み取りです。

Google Search Console への接続

gsc_* ツールは、MCP クライアントではなく、Cituna アプリ内で一度だけ接続する必要があります。このサーバーには、設計上、Google OAuth はありません。ブラウザーでの同意はアプリ内で行い、更新トークンはサーバー側のみに保存されます。

1. アプリで Integrations を開き、Connect Google Search Console をクリックします（有料プラン）。
2. Google から、Cituna に Search Console の読み取り専用アクセス権（webmasters.readonly）を付与するよう求められます。Cituna が Google 上の何かに書き込みアクセスすることはありません。
3. ドメインが確認済みの Search Console プロパティとして登録されている Google アカウントを選択します。ここを見落とす人が多くいます。そのアカウントでドメインを一度も確認していないと、接続はすべて完了しているのに、Google に表示できる情報がないため、どのクエリも空の結果を返します。
4. エージェントに戻り、gsc_status を実行します。接続済みの各アカウントと、クエリ可能なすべてのプロパティが表示されます。ドメインが表示されない場合は、Cituna ではなく Search Console でプロパティを確認してください。

ワークスペースには複数の Google アカウントを接続でき、そのいずれかがドメインのプロパティを所有していれば、そのドメインを読み取れます。アプリの Integrations から接続を解除すると、（Integrations、Disconnect）このサーバーへのアクセスはただちに遮断されます。

認証とセキュリティ

このサーバーは Cituna API の薄いクライアントです。Google の認証情報もデータベースも保持しません。Cituna の認証情報をバックエンドに送信し、バックエンドがワークスペースに保存されている Search Console のリフレッシュトークンを取得して、有効期間の短い Google アクセストークンを発行し、Google に問い合わせます。

OAuth（ホステッドコネクター）。 サーバーは OAuth 2.1 で保護されたリソースで、Cituna API は認可サーバーです。クライアントは次の手順を自分でたどります。

POST /mcp  (no credential)
  → 401 + WWW-Authenticate: Bearer resource_metadata="…"
      → GET https://mcp.cituna.com/.well-known/oauth-protected-resource
          → names https://api.cituna.com as the authorization server
              → GET  /.well-known/oauth-authorization-server
              → POST /oauth/register     (dynamic client registration, RFC 7591)
              → GET  /oauth/authorize    (browser: sign in, then consent)
              → POST /oauth/token        (PKCE S256 required)

クライアントは、公開されたクライアント ID（クライアント ID メタデータドキュメント）を使ってサインインすることもできます。Claude と ChatGPT はこの方法で接続します。アクセストークンの有効期間は 24 時間です。リフレッシュトークンは使用するたびにローテーションされ、ローテーション済みのリフレッシュトークンが再度提示されると接続全体が終了するため、盗まれたコピーが正規のクライアントより長くひそかに有効であり続けることはありません。スコープは cituna:read と cituna:write の 2 つで、書き込みツールにはスコープとプランの両方が必要です。

API キー。 cituna_sk_... キーは、npm パッケージでは CITUNA_API_KEY に設定し、ホステッド URL では Authorization: Bearer（または X-API-Key）ヘッダーに指定します。キーは 1 つのワークスペースとしてのみ認証され、ホステッドサーバーはリクエストごとにステートレスであるため、キーが混在することはありません。ゲートウェイにすべてのユーザーで共有する 1 つのキーを送信させないでください。ユーザー全員が、その単一のワークスペースとして操作することになります。

接続でできないこと。 接続で実行できるのは MCP ツールの呼び出しだけです。API キーの作成、パスワードの変更、請求情報へのアクセス、チームメイトの招待、別のアプリの承認はできません。これらにはアプリへのサインインが必要です。トークンは Cituna 独自の MCP サーバー（RFC 8707 resource）に対してのみ発行されるため、Cituna を認可サーバーとして指定する別のサーバーがトークンを取得することはできません。

サードパーティーのコンテンツ。 回答テキスト、引用されたタイトル、URL、Search Console のクエリは、AI エンジン、そのエンジンが読み取ったページ、検索した人々から引用されています。サーバーは、それらをデータとして扱い、その中に含まれる指示には決して従わず、ツールの出力に促されたからといって書き込みツールを呼び出さないよう、エージェントに指示します。

承認済みアプリは、アプリのインテグレーションに一覧表示され、それぞれ読み取り専用か変更可能かが示されます。また、そこで接続を解除できます。

リモートサーバーのセルフホスト

ホストされている URL では、このリポジトリと同じコードが使われています。どちらのトランスポートも単一のツールレイヤー（src/tools.ts）から構築されるため、ツール一覧、説明、スキーマはまったく同じオブジェクトです。また、内容に差異が生じた場合は npm run test:transports がビルドを失敗させます。

	stdio（dist/index.js）	remote（dist/http.js）
実行場所	クライアントによって起動される、お使いのマシン上	URL 経由でアクセスするサービスとして
必要なもの	ローカルの Node 20 以上	ローカルには何も必要ありません
認証情報	CITUNA_API_KEY 環境変数	リクエストごとの Authorization: Bearer
配布形態	cituna-mcp npm パッケージ	コンテナ（Dockerfile）

stdio サーバーは CITUNA_API_URL（バックエンドのベース URL、デフォルトは https://cituna.com）と、次の順序で確認される認証情報を 1 つ読み込みます。CITUNA_API_KEY（推奨）、CITUNA_TOKEN（アプリのセッショントークン。約 30 日後に有効期限が切れます）、または CITUNA_EMAIL と CITUNA_PASSWORD（サーバーがログインし、有効期限が切れると更新します）。

リモートサーバーを実行します：

npm run build && npm run start:http    # or: npm run dev:http

環境変数	デフォルト	用途
PORT	8080	リッスンするポートです。
CITUNA_API_URL	https://cituna.com	バックエンドのベース URL です。
CITUNA_MCP_ALLOWED_HOSTS	(未設定)	カンマ区切りの Host 許可リストです（DNS リバインディング対策）。すでにホストを固定するプロキシの背後では、未設定のままにしてください。

意図的に、ここには CITUNA_API_KEY がありません。リモートサーバー自体は認証情報を保持しません。各リクエストがそれぞれの認証情報を持ち、リクエストごとに新しいクライアントと MCP サーバーが構築され、レスポンスが終了すると両方とも破棄されます。そのため、あるユーザーのキーが別のユーザーのセッションに取り込まれることはありません。認証情報のないリクエストには 401 が返され、ツールの一覧表示もできません。付属の Dockerfile（マルチステージ構成で、実行時イメージには本番用の依存関係が 1 つ含まれます）を使ってデプロイしてください。cituna.com 以外のドメインでセルフホストする場合は、トークンを発行できるよう、そのオリジンを API の OAUTH_ALLOWED_RESOURCES に追加してください（ループバックアドレスは常に許可されます）。

リモートサーバーのエンドポイント：

パス	内容
POST /mcp	MCP エンドポイント（Streamable HTTP）です。
GET /healthz	稼働状況と実行中のバージョンを返します。
GET /	サービスの簡単な説明を返します。
GET /.well-known/oauth-protected-resource	401 の WWW-Authenticate ヘッダーからクライアントが検出する OAuth メタデータです。
GET /.well-known/mcp-config	API キー用のパスです。これにより、設定に対応したクライアント（Smithery など）は OAuth ボタンの代わりに「キーを貼り付ける」フォームを表示できます。

ディレクトリとゲートウェイ。 公式 MCP Registry のエントリー（server.json、com.cituna/cituna-mcp）には remotes エントリーが含まれています。これにより、レジストリを利用するクライアントや、PulseMCP、Glama などレジストリをミラーするディレクトリは、https://mcp.cituna.com/mcp に直接接続し、個人用 API キーの入力を促します。ディレクトリを経由するルーティングはありません。

バージョン。 ホストされている URL では常に最新リリースが実行され、npx -y cituna-mcp は npm から最新バージョンを取得します。バージョンを固定するには npx -y cituna-mcp@<version> を使ってください。上の npm バッジには現行バージョンが表示され、GET /healthz ではホストされているサーバーの実行バージョンが報告されます。

トラブルシューティング

症状	解決方法
最初の呼び出しで 401 が返される	これは OAuth ハンドシェイクです。クライアントはブラウザーを開いてサインインする必要があります。そうならない場合、クライアントはリモート OAuth に対応していません。API キーヘッダーを送信するか、npx -y cituna-mcp を実行してください。
Not signed in to Cituna（HTTP 401）	認証情報なしでリクエストが /mcp に到達しました。Authorization: Bearer cituna_sk_...（または X-API-Key）を送信してください。匿名の呼び出し元はツールの一覧も取得できません。これは仕様です。
"The MCP endpoint is /mcp" を含む 404	URL にパスがありません。https://mcp.cituna.com ではなく、https://mcp.cituna.com/mcp を使用してください。
Your Cituna access has expired or was revoked（HTTP 401）	トークンまたはキーが無効になっています。OAuth リフレッシュに対応したクライアントは自動でトークンを更新するか、サインイン画面を再度開きます。それ以外の場合は再接続するか、新しいキーを作成してください。
That is not a Cituna MCP credential（HTTP 401）	cituna_at_...（ブラウザーでのサインイン）と cituna_sk_...（API キー）のみ使用できます。Web アプリからコピーしたセッショントークンは拒否されます。
No API key configured（npm パッケージ）	認証情報が設定されていません。キーを生成し（Integrations → Claude / MCP access）、CITUNA_API_KEY を設定してください。
API key invalid, revoked, or the account no longer has access	キーは自動的に期限切れになりません。キーが取り消されたか、入力が間違っているか、アカウントのアクセス権がなくなっています。新しいキーを発行してください。キーが最新の場合は、CITUNA_API_URL に末尾のパスがなく、リダイレクトされるオリジンではないことを確認してください。クロスオリジンリダイレクトでは Authorization ヘッダーが削除されます。
書き込みツールが Pro が必要だと表示する	Starter を利用中です。このプランでは MCP は読み取り専用です。アプリで操作するか、cituna.com/pricing でアップグレードしてください。
Pro または Max で書き込みツールが拒否される	変更も許可するを選択せずに接続が承認されました。Integrations で接続を解除し、ボックスにチェックを入れて再接続してください。
requires a paid plan (Starter/Pro/Max)	トライアル中または終了したプランでは MCP にアクセスできません。cituna.com/pricing でプランを選択してください。
gsc_* ツールから { "configured": false, ... } が返される	Search Console が接続されていないか、接続済みアカウントにそのドメインのプロパティがありません。メッセージに従って操作し、gsc_status を確認してください。
Rate limited (HTTP 429)	月間利用上限ではなく、短時間の呼び出し上限に達しています。表示された秒数だけ待ってから再試行してください。月間利用上限に達した場合は、プラン制限のメッセージ（HTTP 402）が表示されます。
サインイン中に invalid_target が表示される	クライアントが Cituna 以外のサーバー用のトークンを要求しました。独自ドメインでセルフホストする場合は、API の OAUTH_ALLOWED_RESOURCES にそのオリジンを追加してください。
A connected app can only use Cituna's MCP tools（HTTP 403）	キー、パスワード、請求、チームの変更には、ブラウザーでアプリにサインインする必要があります。
ツールが表示されない（npm パッケージ）	Node が 20 以降であることを確認してください。Windows では npx を cmd /c 経由で実行してください。ソースから実行する場合は、npm run build を実行し、dist/index.js への絶対パスを使用してください。その後、クライアントの MCP ログを確認してください。
エンジンが unavailable と表示される	その実行では、エンジンから回答がありませんでした。これは未達ではなく、利用回数にもカウントされません。また、自動的に再確認されます。

よくある質問

Cituna MCP サーバーとは何ですか？ Cituna ワークスペースを AI エージェントに接続する Model Context Protocol サーバーです。日々の AI 可視性トラッキング、その裏側で回答を生成するエンジン、エンジンが引用するページ、監査、修正キュー、キーワード、AutoSEO 記事、最新の Search Console データを読み取ります。Pro では、スキャンの実行、トラッキングするプロンプトの変更、修正の進行、記事のキューへの追加・編集・更新、アウトリーチの記録も行えます。

どの AI エンジンに対応していますか？ 7 つに対応しており、すべて毎日チェックされます。ChatGPT、Perplexity、Gemini、Claude、Grok、Google AI Overviews、Google AI Mode です。同じクエリでも異なる回答が返されるため、Google AI Overviews と Google AI Mode は別々にトラッキングされます。Microsoft Copilot はトラッキングされません。

ChatGPT で使えますか？ はい。ウェブ版 ChatGPT で開発者モードを有効にし、ホスト URL を使って MCP アプリを作成して、OAuth を選択してください（手順は上記をご覧ください）。開発者モードは ChatGPT Plus、Pro、Business、Enterprise、Edu で利用できます。

何かインストールする必要はありますか？ いいえ。ホスト型コネクターは URL とブラウザーでのサインインだけで利用できます。オプションの npm パッケージを使う場合に限り、Node 20 以降が必要です。

無料プランはありますか？ MCP に無料プランはありません。Starter（$49/mo）からすべての有料プランにサーバーが含まれます。Starter では読み取り専用で、書き込みツールは Pro に含まれます。3 日間の無料トライアルはアプリのみで利用できます。

エージェントはデータを変更できますか？ Pro または Max の場合に限り、承認時に 変更も許可する にチェックを入れており、上記の 9 つの書き込みツールを使う場合に限って変更できます。MCP アノテーションに準拠するクライアントは、書き込みのたびに確認を求めます。ChatGPT は常に確認を求めます。

Google のデータは安全ですか？ サーバーが Google の認証情報を見ることはありません。Cituna はサーバー側で読み取り専用の Search Console 権限を保持し、お客様に代わって Google にクエリします。アプリで接続を解除すると、MCP へのアクセスは即座に停止します。

MCP サーバーを提供している AI 可視性ツールは Cituna だけですか？ いいえ。いくつかの AI 可視性ツールが MCP サーバーを提供しており、利用できるツール、プラン、読み取り・書き込みアクセスの範囲はそれぞれ異なります。Cituna は 7 つのエンジンでの日次トラッキングを Search Console データおよび AutoSEO の書き込み機能と組み合わせて、$49 から提供しています。cituna.com/learn/ai-visibility-tools-with-mcp-server の日付入り比較をご覧ください。

REST API もありますか？ はい。同じデータを HTTPS 経由でベアラートークンを使って利用でき、ご自身のダッシュボード、エージェント、CI で使用できます。cituna.com/developers をご覧ください。

リンク

• 製品ページとドキュメント： cituna.com/mcp
• 料金とプランの制限： cituna.com/pricing
• 接続、キー、承認済みアプリ（アプリ内）： cituna.com/integrations
• REST API： cituna.com/developers
• MCP サーバーを備えた AI 可視性ツールの比較： cituna.com/learn/ai-visibility-tools-with-mcp-server
• 購入者の疑問別に比較した AEO および AI 可視性ツール： github.com/Cituna/best-ai-visibility-tools
• npm パッケージ： cituna-mcp
• 公式 MCP Registry： com.cituna/cituna-mcp
• ソースミラー： github.com/cituna/cituna-mcp
• バグと機能リクエスト： GitHub issues

Looker Studio コネクター

このリポジトリには、Cituna の可視性データを Looker Studio ダッシュボードで利用するための Google Apps Script コミュニティコネクター looker-connector/ も含まれています。Code.gs をコミュニティコネクターとしてデプロイし、KEY 認証画面に cituna_sk_... キーを貼り付けて、ダッシュボードを作成してください。設定の詳細：looker-connector/README.md。

このリポジトリについて

これは公開用ミラーであり、作業ツリーではありません。両方の連携機能はCitunaの非公開モノレポで開発され、タグ付け時に自動でここにリリースされるため、ツールの提供範囲とコネクターのエンジンリストは、APIが実際に提供している内容に固定されます。

このリポジトリへのプルリクエストは直接マージできませんが、イシューには目を通して対応しますので、ぜひ作成してください。

ライセンス

MITライセンスです。不具合の報告や機能のリクエストはこちら：https://github.com/cituna/cituna-mcp/issues