Onto

Onto MCP サーバー

公式の Onto Model Context Protocol サーバーです。Claude Code、Cursor、Cline、Zed、または MCP 互換の AI クライアントに、Web コンテンツのクリーンな読み取り機能と AI 可読性のスコアリング機能を追加できます。

これは何をするものですか

Onto の MCP サーバーは、あらゆる AI エージェントに次のツールを公開します。

• read_url — 任意の URL を読み取り、エージェント向けに整形されたクリーンな Markdown を返します（通常、生の HTML より 10 倍小さくなります）
• score_url — 任意の URL の AIO（AI 可読性）スコアを取得し、AI によるコンテンツ利用に役立つ要素と妨げになる要素の内訳を確認できます
• read_and_score — クリーンなコンテンツと品質評価をまとめて取得し、エージェントが情報源をどの程度信頼できるか判断できます
• batch — 1 回の呼び出しで複数の URL（明示的に指定したリスト、またはサイト全体）を読み取り、スコアリング、または抽出します
• map_site — サイトの URL を読み取らずに、サイトマップから検出します
• extract_data — ページがすでに宣言している構造化データ（JSON-LD、OpenGraph、meta）を返します

すべてのツールの応答の末尾には、1 行の ⚡ Onto レポート が付いています。削減量、節約したトークン数、AIO スコアが表示されるため、呼び出すたびに効果を確認できます。

これは Onto Read API の公式 MCP ラッパーです。薄く、決定論的なレイヤーです。Onto はルールベースのエンジンでクリーニングとスコアリングを行うため（LLM は処理に関与しません）、エージェント独自のモデルが生の HTML を解析する必要はありません。

使う理由

現在、AI エージェントが Web サイトを読むときは、数 KB の実際のコンテンツを見つけるために、何百 KB もの React のノイズを解析しています。これはトークンを浪費し、ハルシネーションの原因になります。

Onto はサーバー側でノイズを取り除き、エージェント向けの形式で返すとともに、情報源の信頼度スコアを報告します。ツールを 1 回呼び出すだけで、正確な回答を得られます。

クイックスタート

1. Onto API キーを取得する

app.buildonto.dev に登録し、Read → Keys で API キーを作成します。

無料枠：月 1,000 クレジット。クレジットカードは不要です。

2. Claude Code にインストールする

Claude Code の MCP 設定に追加します。

{
  "mcpServers": {
    "onto": {
      "command": "npx",
      "args": ["-y", "@ontosdk/mcp@latest"],
      "env": {
        "ONTO_API_KEY": "onto_sk_live_your_key_here"
      }
    }
  }
}

Claude Code を再起動します。Onto のツール（read_url、score_url、read_and_score、batch、map_site、extract_data）が利用可能なツールの一覧に表示されます。

3. Cursor にインストールする

Onto サーバーを ~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（このリポジトリ）に追加します。または UI を使って、Customize（サイドバー）→ MCPs → カスタムサーバーを追加し、同じ JSON を指定します。

{
  "mcpServers": {
    "onto": {
      "command": "npx",
      "args": ["-y", "@ontosdk/mcp@latest"],
      "env": {
        "ONTO_API_KEY": "onto_sk_live_your_key_here"
      }
    }
  }
}

Cursor を完全に終了し（Cmd+Q / Ctrl+Q）、再度開きます。

Cline、Zed、Continue の設定については、examples/ を参照してください。

4. 使う

Claude Code または Cursor で、次のように試してください。

Onto を使って https://stripe.com/pricing を読み取り、料金プランを要約してください。

エージェントは read_url を呼び出してクリーンな Markdown を取得し、何百 KB ものレイアウト HTML を解析することなく、正確な要約を返します。

ツール

read_url

URL のクリーンな Markdown を、抽出に関するメタデータ（サイズ、削減率、キャッシュ状態）とともに返します。

入力：

フィールド	型	必須	説明
url	string	はい	誰でもアクセス可能な HTTP(S) URL
fresh	boolean	いいえ	true の場合、キャッシュをバイパスします（デフォルト：false）

score_url

URL の AIO（AI 可読性）スコアを返します。0〜100 のスコアとレターグレード、ハルシネーションリスク、ペナルティ／メリット／推奨事項の構造化リストが含まれます。

入力：

フィールド	型	必須	説明
url	string	はい	スコアリングする URL

read_and_score

1 回の呼び出しでクリーンな Markdown と AIO スコアを返します。エージェントを使ったワークフローでのデフォルトとして推奨されます。

入力： read_url と同じ。

batch

1 回の呼び出しで複数の URL を処理します。リストが確定した後、URL 1 件につき 1 クレジット、合計 N クレジットです。失敗した URL（ok: false）の分は返金されます。デフォルトのモード read-and-score でも 2N ではなく N です。URL のリストを明示するか、ページを自動検出するベース URL を指定してください。

入力：

フィールド	型	必須	説明
urls	string[]	いずれか 1 つ	URL の明示的なリスト（最大 50 件）。site とどちらか一方を指定してください。
site	string	いずれか 1 つ	サイトマップ経由でページを自動検出するベース URL。urls とどちらか一方を指定してください。
mode	"read" | "read-and-score" | "extract"	いいえ	URL ごとに実行する処理（デフォルトは "read-and-score"）
limit	number	いいえ	サイトモードのみ：検出するページの最大数（デフォルトは 25、最大 50）

map_site

サイトの URL を（サイトマップ → ページ上のリンクの順に）検出します。ページの読み取りは行いません。検出した URL ごとではなく、呼び出し 1 回につき 1 クレジットです。次に読み取るページや一括処理するページを決めるために使用してください。

入力：

フィールド	型	必須	説明
url	string	はい	マッピングするサイトのベース URL
limit	number	いいえ	返す URL の最大数（デフォルトは 100、最大 1000）

extract_data

ページにすでに宣言されている構造化データ（JSON-LD、OpenGraph、メタタグ）と AIO スコアを返します。決定論的な処理であり、モデルによるフィールドの推定はありません。

入力：

フィールド	型	必須	説明
url	string	はい	構造化データを抽出する URL

料金

ティア	月間クレジット	料金
Free	1,000	$0
Starter	10,000	$9
Growth	100,000	$49
Scale	500,000	$250
Enterprise	カスタム	営業担当にお問い合わせください

MCP ツールのクレジット数は、現在の API メーターに準拠しています。

ツール	クレジット
read_url	1
read_and_score	1
score_url	0（無料）
extract_data	1
map_site	呼び出し 1 回につき 1（検出した URL ごとではありません）
batch	N — リストが確定した後、URL 1 件につき 1 クレジット。失敗した URL（ok: false）の分は返金されます。デフォルトのモード read-and-score でも 2N ではなく N です

接続／OAuth によるクレジットの引き落としはありません。

サブスクリプションは app.buildonto.dev/read/billing で管理できます。有料ティアに登録すると、超過分に利用できるクレジットパック（$5～$200）も購入できます。

設定

環境変数：

• ONTO_API_KEY（必須）— app.buildonto.dev/read/keys で取得した Onto API キー
• ONTO_API_BASE（任意）— API のベース URL を上書きします（デフォルト：https://api.buildonto.dev）

トラブルシューティング

「無効な Onto API キー」

app.buildonto.dev/read/keys でキーを確認してください。最近キーをローテーションした場合、MCP の設定に古い値が残っている可能性があります。

「月間クォータを超過しました」

月間の割り当てを使い切っています。app.buildonto.dev/read/billing でアップグレードするか、月次リセットをお待ちください。有料ティアではクレジットパックでの追加購入も可能です。

Claude Code／Cursor にツールが表示されない

1. 設定ファイルが有効な JSON であることを確認します
2. MCP ホスト（Claude Code、Cursor など）を再起動します
3. ホストの MCP ログで接続エラーを確認します
4. npx が PATH に含まれていることを確認します

「リクエストがタイムアウトしました」

対象サイトの応答が遅いか、アクセスできない可能性があります。Onto のリクエストタイムアウトは 15 秒です。再試行するか、別の URL をお試しください。

リンク

• Onto のホームページ：buildonto.dev
• API ドキュメント：docs.buildonto.dev
• ダッシュボード：app.buildonto.dev
• GitHub の課題：github.com/ravixalgorithm/onto-mcp/issues
• お問い合わせ：[email protected]

Onto について

Onto は、エージェント向けウェブの互換性レイヤーです。1 つのエンジンで 3 つの製品を提供します。

• Read（この MCP サーバー + API）— AI 開発者があらゆる URL をきれいに読み取れます
• Serve（Next.js SDK）— サイト所有者が AI クローラーにクリーンな Markdown を提供できます
• Act（2026 年第 3 四半期に提供予定）— エージェントがセマンティックな意図を通じてウェブサイト上で操作できます

ウェブを読む AI エージェントのために構築されました。正しく読み取れるように構築されています。

ライセンス

MIT