Cursor SDKがpublic beta公開——トークン課金で誰でも自律エージェント開発

2026年5月、AIコードエディタとして急成長を続ける Cursor（運営: Anysphere）が、Cursor SDK を public beta として全ユーザーに開放した。これまで一部の大企業顧客向けにクローズドβ提供されていた SDK が誰でも触れるようになり、しかも 標準のトークン従量課金（Cursor Pro $20/月の使用枠を消費する形）で利用できる。

Cursor といえば「VS Code をフォークしたAIネイティブなエディタ」というイメージが強いが、今回の SDK 公開はそのポジションを 「IDE企業」から「エージェントプラットフォーム企業」へ と転換させる決定打になり得る。なぜなら開発者は SDK 経由で GitHub PR に自動反応する Cursor エージェント、Slack で会話する Cursor bot、CI で並列実行されるバッチエージェント などを自由に組み上げられるようになったからだ。

Cursor の月額 Pro プラン契約者は2025年末時点で 約180万人（Bloomberg、TechCrunch の複数報道）、ARR は $500M（約775億円、$1=155円換算）を突破 し、評価額 $10B（約1.55兆円） で Series E を完了したばかり。今や OpenAI / Anthropic / Google といったモデル提供者を除けば、AIスタートアップとしては Anysphere（Cursor）が世界で最も成長しているプレイヤーの一人だ。本記事では Cursor SDK が何を可能にし、競合 Agent SDK 群とどう違い、日本の開発者がどう導入すべきかを徹底解説する。

何が起きたか——Cursor SDK の概要

公開された changelog および docs.cursor.com から、SDK の主要事実をまとめると以下の通りである。

項目	内容
提供開始	2026年5月、public beta として全 Cursor Pro ユーザーに開放
提供形態	TypeScript SDK と Python SDK の2系統
課金モデル	トークン従量課金（Cursor Pro $20/月の使用枠で消費、超過分は追加購入）
ランタイム	Cursor Cloud 上のマネージドサンドボックス（並列セッション対応）
LLM選択	Claude / GPT / Gemini など複数モデルから自動ルーティング、明示指定も可
ワークフロー	GitHub PR連携、Slack bot、CIパイプライン、CRONジョブなど任意
Git操作	リポジトリの clone / branch / commit / push / PR 作成までネイティブ対応
監査ログ	全エージェントセッションが Cursor 管理画面で閲覧可能
プライベートβ期間	2025年Q4から大企業向けに限定提供（Shopify、Vercelなどが参加）

特筆すべきは 「Cursor Pro $20/月の使用枠でそのまま使える」 という点だ。これまで Claude Agent SDK や OpenAI Agents SDK を使おうとすると、別途 API キーを取得し、別の請求書管理が必要だった。Cursor SDK の場合は IDEで使っているのと同じ枠 からトークンを消費するので、開発者にとっての「最初の摩擦」が極めて低い。

上の図は Cursor SDK の4層アーキテクチャを示している。開発者が書くのは最上層の TypeScript/Python コードだけで、その下のサンドボックス管理・並列実行・LLMルーティングは全て Cursor 側がマネージドで提供する。「自分のサーバーを立てずに、エージェントが動く環境がすぐ手に入る」 という点が最大の魅力だ。

Anysphere の戦略——IDEからプラットフォームへ

Cursor を運営する Anysphere は2022年創業、共同創業者は Michael Truell 氏（CEO、MIT出身）と Sualeh Asif 氏（CTO）。当初は「VS Code に AI を埋め込んだだけ」と見られがちだったが、2024年以降の戦略転換が鮮やかだ。

Anysphere が描いているロードマップは以下の3段階だと筆者は読み解いている。

1. IDE フェーズ（2022-2024）: VS Code フォークによる AI ネイティブ IDE を作り、開発者の日常導線を握る
2. エージェント機能フェーズ（2024-2026前半）: Background Agent や Composer といったエージェント機能を IDE 内に統合し、「人間がコードを書く」から「エージェントが書いたコードを人間がレビューする」へ業務フローを反転させる
3. プラットフォーム フェーズ（2026以降）: Cursor SDK を公開し、IDE の外側でもエージェントが動く世界を作る。Cursor を IDE ではなく「エージェント実行ランタイム」として再定義する

今回の SDK 公開は明確にフェーズ3の入口である。「Cursor は IDE 企業」という見方は2026年内に大きく書き換えられるはずだ。

Cursor SDK で何が作れるか

ここから具体的に SDK で何が作れるのかを見ていく。

基本API構造

Cursor SDK の主要 API はわずか3つに集約されている。

• agent.run(task): タスクを渡してエージェントを同期実行（結果が返ってくるまでブロック）
• agent.stream(task): タスクを渡して結果をストリーミングで受け取る（Slack botやリアルタイムUI向け）
• agent.tools.register(...): エージェントが呼び出せるツール（カスタム関数、外部API）を登録

これだけで GitHub PR トリガー、Slack bot、CI バッチ実行など多様なユースケースを実装できる。

import { CursorAgent } from "@cursor/sdk";

const agent = new CursorAgent({
  apiKey: process.env.CURSOR_API_KEY,
  repository: "kagiya-n/homepage",
  model: "auto", // Cursor が最適なLLMをルーティング
});

const result = await agent.run({
  task: "package.jsonの依存を最新の安定版に更新してPRを作って",
  branch: "deps/update-2026-05",
});

console.log(result.pullRequestUrl);

このコード10行程度で、リポジトリの依存更新とPR作成までが自動化できる。従来は GitHub API、LLM API、git操作、サンドボックス環境の用意などをすべて自分で組み合わせる必要があったが、Cursor SDK では 設定とタスク文だけ書けば動く。

ユースケース1: GitHub PRに反応する自律エージェント

最も人気が高いのは、GitHub の Webhook と組み合わせて PR 作成時に自動レビューや自動修正を走らせる パターンだ。

import { CursorAgent } from "@cursor/sdk";
import { Webhook } from "octokit";

const agent = new CursorAgent({ apiKey: process.env.CURSOR_API_KEY });

webhook.on("pull_request.opened", async ({ payload }) => {
  const result = await agent.run({
    task: `PR #${payload.number} をレビューして、改善提案をコメントで投稿してください`,
    repository: payload.repository.full_name,
    pullRequestNumber: payload.number,
  });
});

これだけで「PR が立つたびに Cursor エージェントがコードを読み、改善コメントを投稿する」自動レビュアーが完成する。Anysphere の事例として Shopify がプライベートβ期間に試した結果、人間のレビュー工数が約50-70%削減 されたという。

ユースケース2: Slack bot としての Cursor

Slack で @cursor バグ修正して と打つと、Cursor エージェントがリポジトリを clone し、バグを修正し、PR を作るところまで自動でやる、というワークフローも数十行で実装できる。

slackApp.event("app_mention", async ({ event, say }) => {
  const stream = agent.stream({
    task: event.text,
    repository: "your-org/your-repo",
  });

  for await (const chunk of stream) {
    await say(`進捗: ${chunk.message}`);
  }
});

agent.stream() を使うと エージェントの思考過程や進捗が逐次取得できる ので、Slack 上で「いま何をやっているか」を可視化しながらタスクを進められる。これは Claude Agent SDK や OpenAI Agents SDK にもある機能だが、Slack 連携用のサンプルコードが Cursor docs に最初から載っている のは Cursor SDK ならではの親切さだ。

ユースケース3: CI で大量並列実行

モノレポを運用する大企業では、CI 上で 「100リポジトリの依存更新を一晩で並列実行する」 のような大規模バッチがニーズとして強い。Cursor SDK は Cursor Cloud Runtime 上で並列セッションを起動できるため、ローカルやセルフホストのサーバーリソースを気にせずスケールできる。

const repos = await listAllRepos();
const results = await Promise.all(
  repos.map((repo) =>
    agent.run({
      task: "依存パッケージを安全な範囲で更新してPRを作成",
      repository: repo,
    })
  )
);

Promise.all で並列実行すれば、Cursor 側が自動で並列セッションをスピンアップしてくれる。料金はトークン消費に比例するため、「使った分だけ払う」モデル が大規模バッチ運用にもうまく適合する。

上の図は Cursor SDK の代表的ユースケース3パターンと、それぞれが解決する業務シナリオを示している。共通しているのは 「人間が IDE で1タスクずつ依頼する」から「業務イベントに応じてエージェントが自律的に動く」への転換 だ。これが「プログラマティックエージェント」という呼び名の意味するところである。

料金とトークン課金の経済性

Cursor SDK は専用の月額料金を取らず、Cursor Pro（$20/月、約3,100円）の使用枠を消費する モデルだ。Pro プランには月あたり一定量の「Fast requests」と「Slow requests」が含まれており、SDK 経由のエージェント実行もこの枠を使う。

プラン	月額	月額（円換算）	SDK 利用枠	超過時
Hobby（無料）	$0	0円	限定的（β試用のみ）	利用停止
Pro	$20	約3,100円	標準枠あり	トークン追加購入
Business	$40/人	約6,200円	拡張枠	トークン追加購入
Ultra	$200	約31,000円	大量利用向け	大幅追加枠

公式の使用枠は明示的なトークン数ではなく「Fast / Slow requests」という抽象単位で管理されているが、SDK ドキュメントには 「1セッションあたり平均で数千〜数万トークン消費」 という目安が示されている。GitHub PR レビュー1件あたりの実コストは、感覚値として 数十円〜数百円レンジ に収まることが多い。

月100PRをレビューさせた場合のコスト試算

仮にリポジトリで月100件の PR が立ち、それぞれを Cursor SDK で自動レビューさせると、トークン消費の目安は以下のようになる。

• 1 PR レビュー: 入力 5,000 token + 出力 1,500 token 程度
• 100 PR で 入力 50万 token + 出力 15万 token
• Claude Opus 4.7 相当の単価で換算すると、1か月あたり おおむね $30-60（4,650-9,300円） 程度

これは Pro / Business プランの使用枠でカバーできる範囲であり、人間のレビュアー1人の人件費（最低でも月数十万円）と比べれば1/100以下 という経済性になる。もちろん全レビューを AI に任せるべきではないが、「一次レビューは AI、最終確認は人間」 という分業を実現するには十分すぎる安さだ。

競合 Agent SDK との比較

Cursor SDK は Agent SDK 領域で後発に近い。同じ領域で先行しているのは Anthropic の Claude Agent SDK（2025年公開）、OpenAI の OpenAI Agents SDK（2025年公開）、OSS の Mastra（2024年公開、人気急上昇中）の3つだ。

上の図は4社の主要項目を一覧で比較したものだ。それぞれの強み・弱みを整理する。

Claude Agent SDK との違い

Claude Agent SDK は Anthropic 公式の SDK で、Claude Code の中身を SDK として切り出した ものだ。最大の強みは Claude モデルとの統合の深さで、「Claude にしかできない振る舞い」（長文脈で精緻にコードを読む、安全に拒否する、計画的に作業を進めるなど）を最大限引き出せる。

ただし課題もある。

• モデルが Claude 中心: 他LLMを使うには自前でルーティングを組む必要がある
• ランタイムは自前: ローカル / Bedrock / GCP などにユーザーが自分でデプロイする必要がある
• コード操作はCLIベース: シェルコマンド経由が中心で、GUI/IDE 統合を自分で組む必要がある

つまり Claude Agent SDK は 「自前でしっかり組める開発チーム向け」 で、Cursor SDK は 「マネージドで楽に組みたい開発者向け」 という棲み分けだ。

OpenAI Agents SDK との違い

OpenAI Agents SDK は2025年に正式版が出て以降、企業向けに採用が広がっている。マルチエージェント（複数のエージェントが連携して動く）モデルが洗練されており、特に 「Handoff」と呼ばれるエージェント間の引き継ぎ機構 が強力だ。

一方で OpenAI Agents SDK は OpenAI モデル前提 で組まれており、Claude や Gemini を併用するには別 SDK を組み合わせる必要がある。また、コードベースに対するネイティブな操作（ファイル編集、Git連携）は Cursor SDK ほど洗練されておらず、「コード操作中心ならCursor、汎用業務エージェントならOpenAI Agents」 と使い分けるのが現実的だ。

Mastra との違い

Mastra は TypeScript ネイティブな OSS の Agent フレームワークで、GitHub スター数は2026年5月時点で 25,000を突破 している。自前でホストするタイプの SDK で、LLM は完全にユーザーが選べる（Claude、GPT、Gemini、ローカルLLMなど何でも可）。

Mastra の魅力は 「自由度の高さ」と「OSSであること」 だ。一方で Cursor SDK のようなマネージドサンドボックス、並列実行、IDE 連携、課金統合といったプラットフォーム機能は自前で用意する必要がある。「研究目的やフルカスタマイズが必要ならMastra、業務でさっさと組みたいならCursor SDK」 という使い分けになる。

実際に使ってみた——5分でPR自動レビュー bot を構築

ここから筆者が実際に Cursor SDK を試した記録を残す。Cursor Pro 契約済みの状態で、Mac（macOS 15.5、M3 Pro）で TypeScript SDK を使った。

ステップ1: SDK インストールと API キー取得

まず Cursor 公式サイトの設定画面から SDK 用 API キーを発行する。Cursor のメニューから「Settings → API Keys → Create new key」を選び、「SDK 用」のスコープを付けて発行した。発行された API キーは1回しか表示されないので、.env にすぐ保存しておくべきだ。

npm install @cursor/sdk

インストールは2秒で完了。@cursor/sdk のバージョンは執筆時点で 0.4.0（public beta）だった。

ステップ2: Hello, Agent

まずは公式 docs のサンプル通りに動かしてみる。

import { CursorAgent } from "@cursor/sdk";

const agent = new CursorAgent({ apiKey: process.env.CURSOR_API_KEY! });

const result = await agent.run({
  task: "このリポジトリのREADME.mdに『Hello from Cursor SDK』という見出しを追加してください",
  repository: "kagiya-n/homepage",
  branch: "test/cursor-sdk-hello",
});

console.log(result.pullRequestUrl);

実行すると、約45秒で https://github.com/kagiya-n/homepage/pull/... が返ってきて、実際に「Hello from Cursor SDK」見出しが追加された PR が立っていた。ローカルで git clone していないリポジトリに対して、SDK 経由でPRが作れる のは新鮮な体験だった。

ステップ3: GitHub Webhook と連携

次に、GitHub の PR が立ったら自動で Cursor エージェントがレビューする bot を実装した。Hono と GitHub Webhook で受け、Cursor SDK にタスクを渡すだけの30行コードだ。

import { Hono } from "hono";
import { CursorAgent } from "@cursor/sdk";

const app = new Hono();
const agent = new CursorAgent({ apiKey: process.env.CURSOR_API_KEY! });

app.post("/webhook", async (c) => {
  const event = c.req.header("x-github-event");
  const payload = await c.req.json();

  if (event === "pull_request" && payload.action === "opened") {
    await agent.run({
      task: `PR #${payload.number} をレビューして、改善点をコメントで投稿してください`,
      repository: payload.repository.full_name,
      pullRequestNumber: payload.number,
    });
  }

  return c.json({ ok: true });
});

export default app;

これを Cloudflare Workers にデプロイし、GitHub の Webhook で /webhook に PR イベントを流すと、新しいPRが立つたびにCursor SDKがレビューを投稿する ようになった。動作確認のためにわざと型エラーを含んだ PR を立ててみたところ、約1分後に Cursor からのコメントが投稿され、型エラーと修正案が日本語で書かれていた。

つまずきポイントと所感

実際に触ってみて感じた良い点・課題は以下の通り。

良かった点:

• セットアップが速い: API キー発行から PR 自動レビュー bot までトータル30分かからない
• Cursor Pro 枠で動く: 別途請求書管理が増えないのは個人開発者として極めてありがたい
• エラーメッセージが親切: 「タスク文が曖昧すぎる」「リポジトリへの権限がない」など、原因が明快なエラーが返る
• 並列実行が楽: Promise.all で投げるだけで Cursor 側が並列セッションを管理してくれる

課題点:

• public beta なので API が変わる可能性: SDK バージョン 0.x 台はまだ仕様変更がある前提
• タスク文のチューニングが必要: 曖昧な指示だとエージェントが空回りすることがある。「PRレビュー」だけより「PRレビューをして、型安全性、命名規則、テスト不足の3観点でコメントせよ」の方が良い結果が出る
• 長時間タスクのデバッグ: 数分以上かかるタスクは途中経過が見えにくい。Cursor 管理画面のセッションログを見れば追える

総じて、「2026年に AI ネイティブな開発者なら最初に触っておくべき SDK」 だと言える完成度だった。

日本での利用手順

日本から Cursor SDK を使う場合の具体的な手順を整理する。

ステップ1: Cursor Pro に契約

まず Cursor 本体（IDE）を cursor.com からダウンロードしてインストールする。日本からも問題なく使えて、UIは英語だが日本語コードの生成・編集は高精度。Pro プランは月額 $20（約3,100円）、Business プランは月額 $40/人（約6,200円）。支払いはクレジットカード（Visa / Master / Amex / JCB）または PayPal が選べる。インボイス対応の請求書も発行可能だ。

ステップ2: API キーの発行

Cursor IDE 内の「Settings → Integrations → SDK API Keys」から発行する。発行時にスコープ（リポジトリ操作の許可、ツール呼び出しの許可など）を指定できる。最小権限で発行するのがセキュリティ上のベストプラクティス だ。

ステップ3: ローカルで SDK をセットアップ

mkdir my-cursor-bot && cd my-cursor-bot
npm init -y
npm install @cursor/sdk
echo "CURSOR_API_KEY=cur_xxx" > .env

@cursor/sdk は Node.js 20以上を要求する。Python 版は Python 3.10以上を要求する。

ステップ4: GitHub / Slack 連携の準備

GitHub 連携を使う場合は、Cursor IDE で対象 organization へのアクセスを許可するか、Cursor の GitHub App を組織にインストールする必要がある。日本企業の場合、情報システム部門の承認が必要なケースが多い ので、導入前に組織レベルで GitHub App インストール権限を確認しておきたい。

Slack 連携は Slack 側で App を作成し、Bot Token を Cursor SDK のツール定義に登録する。これは Cursor 側の設定ではなく、開発者側で書く Bot コードに含まれる作業だ。

ステップ5: 日本語タスクの精度確認

Cursor SDK は 日本語タスク文をそのまま受け付ける。「README に〜を追加して」「このバグを修正して」のような日本語の指示で精度高く動く（モデルが Claude / GPT / Gemini いずれも日本語に強いため）。ただし、コードベース内のコメントが英語と日本語で混在している場合は、タスク文で「コメントは日本語で書いて」と明示した方が安定する。

国内代替サービスとの比較

国内で類似のサービスとしては Tabnine Japan、サイバーエージェントのAIエージェント基盤 などがあるが、開発者向けに SDK として公開されている統合プラットフォームは2026年5月時点では Cursor SDK が圧倒的に先行している。「日本独自のAgent SDKを待つより、Cursor SDKを採用して国内事例を作る」 方が現実的だろう。

筆者の見解——「IDE時代」から「ランタイム時代」への転換点

Cursor SDK の public beta 公開は、単なる新機能リリースではなく AI 開発ツール業界の構造転換 を象徴するイベントだと筆者は捉えている。理由は3点ある。

第一に、「AI が IDE の中で人間を補助する」というモデルが終わりつつある。これまでの GitHub Copilot 的なパラダイムは「人間が主、AIが補助」だったが、Cursor SDK は明確に「AI が主、人間がレビュー」へとシフトさせている。SDK で書ける workflow（GitHub PR トリガー、CI バッチ、CRON、Slack bot）は、いずれも 人間が IDE の前に座っていない時間 にエージェントを走らせるためのものだ。

第二に、「課金統合がエージェント普及の最大障壁だった」という仮説を Cursor が突破した。Claude Agent SDK や OpenAI Agents SDK で同様のことは技術的にできるが、API キーを発行し、別請求の支払い設定を作り、社内稟議を通すという摩擦がある。Cursor は既存の Pro 契約枠を使えるため、「とりあえず試してみる」のハードルが圧倒的に低い。これがエージェント普及の臨界点を超えさせる可能性がある。

第三に、Anysphere は IDE で集めた現金を使って、エージェントランタイム市場に攻め込んでいる。$10B 評価額・ARR $500M という資金力で、AWS Lambda / Cloudflare Workers / Vercel 的な「サーバーレス計算リソース」の AI 版に居場所を取りに行く戦略だ。これが成功すれば、Cursor は5年後には GitHub と並ぶ開発者プラットフォームになっているかもしれない。

予測——2026年後半から2027年に起きること

筆者の予測としては、以下のシナリオが順次起きていくと見ている。

• 2026年Q3: 大企業の DevTools チームが Cursor SDK を採用し、社内 PR レビュー bot や依存更新 bot を量産。「Cursor SDK 運用ノウハウ」が技術ブログで爆発的に共有される
• 2026年Q4: Anthropic / OpenAI / Google が対抗して「マネージド Agent ランタイム」を発表。Claude Code Cloud、OpenAI Agent Cloud のような形で Cursor Cloud Runtime と直接競合する
• 2027年前半: 「Cursor SDK で組まれたエージェント」をマーケットプレイス的に売買する仕組み（GitHub Actions Marketplace のような）が登場
• 2027年後半: 日本の SaaS スタートアップが Cursor SDK 上で組んだ業務エージェントを国内大企業に売る、というビジネスモデルが立ち上がる

逆に懸念もある。SDK の API 仕様変更、サンドボックスのセキュリティ、ベンダーロックイン（Cursor Cloud Runtime に依存しすぎると移行困難）などのリスクは認識しておくべきだ。本番運用では 「重要な処理は OSS の Mastra 等と二重化しておく」 くらいの慎重さが望ましい。

まとめ——いま開発者がやるべき3つのアクション

Cursor SDK の public beta 公開は、AI エージェント領域で 「実験ステージから業務適用ステージへ」 という転換点を作った。読者である開発者・テックリードへの具体的なアクションは以下の3つだ。

1. まず Cursor Pro 契約者は SDK を触ってみる: Hello, Agent から始めて、自分の GitHub リポジトリに対して PR 自動レビューを30分で組む体験をする。これが2026年に最低限身につけておくべきスキルになる
2. 業務適用候補のworkflowを2-3個リストアップする: PR レビュー、依存更新、ドキュメント自動更新、テスト追加など、社内で「人間がやらなくてもよさそうな繰り返し作業」を洗い出す。Cursor SDK は「100%自動化」を目指す必要はなく、「人間の確認を残したまま下準備をエージェントにやらせる」だけで十分元が取れる
3. Claude Agent SDK / Mastra との比較検証を並行する: ベンダーロックインを避けるため、最初から Cursor SDK 一本に絞らず、Claude Agent SDK / Mastra でも同等の workflow を組めるか試しておく。抽象化レイヤを薄く挟んで移行可能性を担保しておく のが2026-2027年の正解戦略になる

Cursor の公式 changelog や docs を読みながら、SDK の世界に飛び込んでみてほしい。AI エージェント領域は今後3年で開発者の働き方そのものを変えるはずだ。

Cursorの利用を始める方は Cursor Pro から契約できる。SDK は Cursor Pro 契約者であればすぐに使い始められる。