MCP Server

Claude Desktop、Cursor など任意の MCP クライアントに学術引用の検証機能を追加します。

@citetrue/mcp-servernpx -y @citetrue/mcp-server

できること

CiteTrue REST API を包む 2 つのツール。クレジットも精度も同じで、HTTP の代わりに MCP 経由で呼び出すだけです。

ツール	用途	呼び出し毎のクレジット
verify	Split a text blob into references and verify each against real sources.	1 per ref; tricky ones up to 5
get_credits	アカウントのクレジット残高を返します。	0

クイックスタート

ダッシュボード → API キーにアクセスし 新しい API キー をクリック。sk_ で始まるキーをコピー。
MCP クライアント設定を開き（「クライアント設定」参照）、citetrue ブロックを追加。
MCP クライアントを再起動 — チャットのリロードではなくアプリ全体。
アシスタントに「これらの引用を検証して：[ペースト]」のように依頼。verify を呼び出し要約します。

クライアント設定

stdio 対応 MCP クライアントなら何でも。以下は代表的な 3 つ。他のクライアントも同じ構造で設定できます。

Claude Desktop

推奨

CiteTrue を Claude Desktop の拡張機能としてインストール — JSON の編集も Node のセットアップも不要。同梱のサーバーは Claude Desktop に付属する Node 上で動作します。

Claude Desktop 版をダウンロード

ダウンロードしたファイルをダブルクリック(または設定 → Extensions にドラッグ)し、表示されたら API キーを貼り付けます。キーは OS のキーチェーンに安全に保存されます。

重要:インストール後、設定 → Extensions で拡張機能が有効(オン)になっていることを確認し、Claude Desktop を再起動してください — これでツールが有効になります。

または手動で設定

macOS は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows は %APPDATA%\Claude\claude_desktop_config.json を編集：

{
  "mcpServers": {
    "citetrue": {
      "command": "npx",
      "args": ["-y", "@citetrue/mcp-server"],
      "env": {
        "CITETRUE_API_KEY": "sk_..."
      }
    }
  }
}

Cursor

Settings → MCP → Add new MCP server で、下記の Claude Desktop JSON と同じ command / args / env を設定。

Windsurf、Zed、その他

任意の stdio MCP クライアントで動きます。設定パスは各クライアント固有ですが、3 つのフィールド（command, args, env）は同じ。

設定

環境変数	デフォルト	備考
CITETRUE_API_KEY	— (必須)	ダッシュボード発行の Bearer トークン。
CITETRUE_API_URL	`https://api.citetrue.com`	セルフホスト時に上書き。

ツール

verify

Split a free-form text blob into individual references and verify each against real sources. Every reference goes through the same flow, and each one in the result reports what it cost.

パラメータ

Supply exactly one of text or taskHash:

text string — raw text containing one or more references: numbered / bulleted / blank-line-separated lists, BibTeX, or prose with in-text author-year citations. Max 10MB.
taskHash string — resume a task started by an earlier call (the taskHash it returned). Finished results are replayed without charging again; citations that still need checking are completed and billed as usual.
force bool, optional — ignore cached results and check the text again from scratch (billed like a new check). Only applies with text.

出力

{
  "taskHash": "...",
  "refs": [
    {
      "hash": "a1b2c3...",
      "text": "[1] Vaswani, A., Shazeer, N., Parmar (2017)...",
      "assessment": "authentic",
      "value": {
        "type": "citation",
        "title": "Attention is all you need",
        "authors": ["A Vaswani", "N Shazeer", "N Parmar"],
        "year": 2017,
        "url": "https://..."
      },
      "note": "",
      "notices": [],
      "confidence": 0.97,
      "cost": 1
    }
  ],
  "cost": 2,
  "balance": 248
}

Each ref's cost is what the task has charged for that citation: 1 for most citations, up to 5 for tricky ones that needed more data sources and more analysis, 0 if it was already paid for in another task. Resuming a task with taskHash reports the same per-ref numbers again — they are not new charges. The top-level cost is what this call newly charged (0 when a finished task is simply replayed), and balance is what's left afterwards — it can be negative (see Billing). note is a free-form one-line natural-language explanation in English (intended for end-user display); for programmatic checks, match on notices[] instead.

Assessment values

authentic — paper exists and is the one cited; value contains the matched paper.
unsure — found something but can't confirm; notices and confidence describe why.
inauthentic — definitively not found / fabricated / unrelated.
invalid — input wasn't a citation; pipeline refused to search.
error — verification failed on this ref; errors[] lists tokens.
exceeded — credits ran out before this ref ran.

課金

Same credits as the REST API. Most citations cost 1 credit. Tricky ones that need more data sources and more analysis can cost up to 5. If you run out of credits mid-check, citations already in progress still finish; the overage is deducted at your next credit reset, so balance can be negative. Citations that couldn't start for lack of credits come back as exceeded. get_credits is free.

トラブルシュート

If the server fails to start, ensure npx is on PATH and CITETRUE_API_KEY is set.

CiteTrue チームが管理 · 最終更新: 2026年10月1日