Cited

cited-mcp

Cited の MCP サーバーです。購入者が販売している商品について尋ねたときに、ChatGPT、Gemini、Claude、Google AI Mode があなたのウェブサイトを引用しているかを確認し、引用されるための改善点を得られます。Model Context Protocol を介して 21 個のツールを提供します。ホスト型サーバー mcp.youcited.com が提供するものと同じ 19 個の Cited ツールに、ローカルの login と logout を加えたものです。

インストール

pip install cited-mcp

インストールせずに直接実行することもできます。

uvx cited-mcp

使い方

ホスト型サーバーは https://mcp.youcited.com/mcp にあります（ストリーミング可能な HTTP です。初回利用時はブラウザーが開いてログインします）。free_audit、account_status、agent_signup、search_docs ツールはログインせずに使用できます。

クイックセットアップ： cited-cli をインストールした状態で cited agent setup を実行すると、Claude Code、Cursor、Codex が設定され、Claude Desktop コネクターの手順が表示されます（プレビューするには --dry-run を指定します）。既存の設定に統合され、変更前にファイルのバックアップが作成されます。

Claude Desktop（カスタムコネクター — 推奨）

ローカルへのインストールは不要です。Claude は Cited のホスト型 MCP サーバーに直接接続します。

1. Claude Desktop を開き、Settings → Customize > Connectors を選択します
2. "+" → "Add custom connector" をクリックします
3. URL に https://mcp.youcited.com/mcp を入力します
4. Add をクリックします

初回利用時は認証のためにブラウザーが開きます。詳しくはAnthropic のコネクターガイドをご覧ください。

必要なプラン： Claude Pro、Max、Team、または Enterprise。

Claude Desktop（開発者設定 — 代替方法）

カスタムコネクターを利用できない場合は、mcp-remote を使って開発者設定を行います。

{
  "mcpServers": {
    "cited": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.youcited.com/mcp"]
    }
  }
}

Settings → Developer → Edit Config に追加してから、Claude Desktop を再起動します。

前提条件： npx を利用するには、Node.js がインストールされている必要があります。

Claude Desktop（ローカル stdio サーバー）

サーバーをローカルで実行する場合：

{
  "mcpServers": {
    "cited": {
      "command": "uvx",
      "args": ["cited-mcp"],
      "env": {
        "CITED_TOKEN": "your-jwt-token"
      }
    }
  }
}

トークンを取得するには、cited-cli で cited login を実行してから cited auth token を実行します。

Claude Code

claude mcp add --transport http --scope user cited https://mcp.youcited.com/mcp

次に Claude Code で /mcp を実行し、Authenticate を選択します。Cited のスラッシュコマンド、スキル、geo-analyst エージェントも使うには、/plugin marketplace add YouCited/cited-plugins と /plugin install cited@youcited-cited-plugins でプラグインもインストールしてください。

Cursor

~/.cursor/mcp.json（グローバル）またはプロジェクトルートの .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "cited": {
      "url": "https://mcp.youcited.com/mcp"
    }
  }
}

次に Cursor で、Settings（Cmd+,）を開いて MCP を選択し、cited の横にある Login をクリックして、緑色のステータスインジケーターが表示されることを確認します。Agent モードで Cited ツールを使用できます。

代替方法（リモートサーバーに対応していない古いバージョンの Cursor の場合）— Node.js が必要な mcp-remote を介してプロキシします（node --version で v18 以降が表示される必要があります）。

{
  "mcpServers": {
    "cited": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.youcited.com/mcp"]
    }
  }
}

Codex

codex mcp add cited --url https://mcp.youcited.com/mcp
codex mcp login cited

または、~/.codex/config.toml に url = "https://mcp.youcited.com/mcp" を含む [mcp_servers.cited] を追加します。

単独実行

cited-mcp                          # stdio; uses `cited login`, CITED_TOKEN or an agent key
CITED_ENV=dev cited-mcp            # another environment

ツール定義は Cited API 内の一か所だけにあります。起動時にサーバーは GET https://api.youcited.com/agent/tools から最新のツール一覧を読み込み（失敗した場合は cited-core に同梱された一覧を使用）、各呼び出しを POST /agent/tools/{name} 経由で実行するため、常にホスト型サーバーと同じ動作をします。

Cited の新機能への更新

クライアントはツール一覧をキャッシュします。Cited のリリース後は、コネクターを再接続するか（ローカルの cited-mcp を再起動して）、新しいツールを反映してください。

ツール

まず account_status を実行すると、サインイン中のユーザー、クレジット残高、ビジネス、次のステップがわかります。

ツール	機能	ログイン
free_audit	サイトについて、AI が購入者からの5つの質問にどう回答するかを無料で確認します。report_token で結果を取得します	不要
agent_signup	人間ユーザー用のアカウントをログインなしで作成します。キーはローカルに保存され、アカウントの引き継ぎ用リンクとコードが返されます	不要
account_status	サインイン中のユーザー、残高、ビジネス、料金、次のステップを確認します	不要
search_docs	Cited のドキュメントを検索するか、path を指定して1つのドキュメントを読みます	不要
buy_credits	クレジットパックまたは1回分の監査の購入リンクを取得するか、バウチャーを引き換えます	必要
setup_business	ウェブサイトからビジネスを追加するか、ビジネス、購入者ペルソナ、提供内容を更新します	必要
get_business	ビジネスの一覧、または1つのビジネスのプロフィール、質問、スケジュール、最近の監査を取得します	必要
get_agent_brief	ビジネスについて次に注力すべきことを確認します	必要
draft_questions	監査で尋ねる購入者向けの質問を作成、追加、置換します	必要
quote_audit	監査の料金、残高、モデルを確認します	必要
run_audit	有料監査を実行します。まず料金が返され、confirm=true の場合にのみ残高から差し引かれます	必要
get_audit	監査の一覧、または1つの監査のステータスとレポートを取得します	必要
compare_audits	前回の監査と比較して、獲得・失った引用を確認します	必要
schedule_recheck	N 日ごとに監査を再実行し、メールと Webhook で通知します	必要
get_recommendations	変更すべき内容を、項目キー、根拠、ステータス、修正案とともに確認します	必要
update_recommendation	項目を完了または却下にするか、再度開きます	必要
generate_fixes	項目（またはすべての項目）の修正ファイルと手順を作成します。実行前に確認を求めます	必要
get_fixes	修正の一覧、または1つの修正のファイル、対象、手順を取得します	必要
update_fix	公開中のサイト上で修正を done、undo、または verify します	必要
login	このマシンにセッションを保存するブラウザーサインインです（ローカルサーバーのみ）	不要
logout	セッションまたは保存済みのエージェントキーを削除します（ローカルサーバーのみ）	不要

ワークフローの例

1. account_status を実行し、続けてウェブサイトを指定して free_audit を実行すると、無料で最初の確認ができます。
2. agent_signup（または login）を実行し、続けてウェブサイトを指定して setup_business を実行します。
3. draft_questions を実行して、ユーザーと質問を確認し、続けて quote_audit を実行します。
4. run_audit を実行します（ユーザーが料金を承認します）。完了するまで get_audit を実行します。
5. get_recommendations、generate_fixes、ファイルを取得する get_fixes の順に実行し、続けて update_fix を done と verify で実行します。

料金：従量制クレジット

プランやサブスクリプションはありません。1クレジット＝1ドルです。現在の料金は account_status と quote_audit に表示されます。購入ツールが返すのは、人間が開くための Stripe の購入リンクのみです。account_status に新しい残高が表示されるまで、購入は確定しません。残高が不足している場合は、status_code が 402、credits_needed が含まれたエラーが返されます。

エージェントの登録とキー

agent_signup は、AI エージェント用の未請求アカウントを作成します。API キーはこのマシン（OS のキーチェーン、または ~/.cited/credentials.json）に保存され、すべての呼び出しで使用されます。キーがモデルに表示されることはありません。人間ユーザーがアカウントを引き継げるよう、引き継ぎ用リンクと6桁のコードを渡してください。logout を実行するとキーが削除されます。

環境変数

変数	説明
CITED_TOKEN	Cited のセッショントークン（cited login の後に cited auth token を実行）。任意です。
CITED_AGENT_API_KEY	Cited のエージェントキー（cak_...）。任意です。agent_signup を実行すると自動で保存されます。
CITED_ENV	prod（デフォルト）、dev、または local。

開発

pip install -e ../core -e ".[dev]"
pytest
ruff check src/ && mypy src/ --ignore-missing-imports

プライバシーポリシー

youcited.com/privacy をご覧ください。

ライセンス

プロプライエタリです。利用規約については youcited.com をご覧ください。