【Cursor SDK】数行のTypeScriptでAIコーディングエージェントを構築できるSDKの使い方・料金・活用シーンを徹底解説
- Cursor SDKは、Cursorのデスクトップアプリやクラウドと同じランタイムでエージェントを構築できるTypeScript SDK
- ローカル実行・クラウド実行・セルフホストの3種類のランタイムに対応し、CI/CDパイプラインや自社プロダクトへの組み込みも可能
- 2026年4月29日にパブリックベータとして公開され、トークンベースの従量課金で利用できる
2026年4月29日、Anysphere社は、AIコーディングエディタ「Cursor」を支えるエージェントの仕組みを、数行のTypeScriptコードから呼び出せるようにした開発者向けSDK「Cursor SDK」を発表しました！
このSDKは、公開からわずか数日でGitHub上のcookbookリポジトリが3,000以上のスターを獲得しており、開発者コミュニティからの注目度の高さがうかがえます。
とはいえ、「どうやって導入するの？」「料金はどうなるの？」「自社のワークフローにはどう活かせるの？」と気になっている方も多いのではないでしょうか。
そこで本記事では、Cursor SDKの概要から仕組み、料金体系、具体的な使い方、業界別の活用シーンまでを徹底的に解説します。ぜひ最後までご覧ください。
＼生成AIを活用して業務プロセスを自動化／
Cursor SDKとは？
Cursor SDKは、Anysphere社が開発したTypeScriptベースのAIエージェント構築用SDKで、パブリックベータとして公開されました。
このSDKの最大のポイントは、Cursorのデスクトップアプリ・CLI・ウェブアプリを動かしているものとまったく同じランタイム・ハーネス・AIモデルを、自分のプログラムから直接利用できるという点にあります。つまり、Cursorが内部で使っているコーディングエージェントの仕組みを、そのまま外部のアプリケーションやスクリプトに組み込めるわけです。
実際のコードは非常にシンプルで、npm install @cursor/sdkでインストール後、Agent.create()でエージェントを生成し、agent.send()でプロンプトを送信するだけで動きます。ローカル環境での実行はもちろん、Cursorのクラウド上に専用VMを立ち上げてリモート実行することも可能です。
| 開発会社 | Anysphere, Inc. |
|---|---|
| 対応言語 | TypeScript |
| パッケージ名 | @cursor/sdk |
| 実行環境 | ローカル・クラウド（専用VM）・セルフホスト |
| 公式サイト | https://cursor.com/docs/sdk/typescript |
既にFaire・Rippling・Notion・C3 AIといった企業がCursor SDKを基盤にした開発を進めていると、公式ブログで紹介されています。CI/CDパイプラインからエージェントを直接呼び出して変更内容を要約したり、CI失敗時に根本原因を自動で特定してPRを更新したりと、実践的なユースケースが広がり始めています。
OpenAIのAgents SDKについて、詳しく知りたい方は以下の記事も参考にしてみてください。
Cursor SDKの仕組み
Cursor SDKのアーキテクチャは、大きく分けると「SDKクライアント層」「エージェントランタイム層」「ハーネス層」の3つで構成されています。
まず、開発者が書くTypeScriptコードはSDKクライアント層にあたります。ここではAgent.create()によるエージェント生成、agent.send()によるプロンプト送信、run.stream()によるイベントのストリーミング受信といった操作を行います。APIキーとモデルID、実行先（ローカルかクラウドか）を指定するだけで、エージェントが起動する仕組みです。
次に、エージェントランタイム層では、指定されたランタイムに応じてエージェントが実行されます。ローカルモードではユーザーのマシン上で直接動作し、クラウドモードではCursorが管理する専用VMが割り当てられ、リポジトリのクローンや開発環境のセットアップまで自動で行われます。クラウド実行中にPCがスリープしたりネットワークが切断されたりしても、エージェントは独立して動作を継続し、あとから再接続して状況を確認できます。
そして、ハーネス層がCursor SDKの中核となる部分です。ここには以下の機能が含まれています。
| 機能 | 詳細 |
|---|---|
| コンテキスト管理 | コードベースのインデックス化・セマンティック検索・Instant Grepがあり、エージェントが必要なコードを高速に見つけ出す |
| MCPサーバー連携 | .cursor/mcp.jsonの設定ファイルやインライン指定を通じて、外部ツールやデータソースとの接続が可能 |
| スキル機能 | リポジトリの.cursor/skills/ディレクトリから自動的にスキルを読み込む |
| Hooks | .cursor/hooks.jsonファイルを通じてエージェントループの監視・制御・拡張を行う |
| サブエージェント | メインエージェントからサブタスクを委任する仕組み |
Cursor SDKの特徴
Cursor SDKが他のエージェント構築フレームワークと異なる点は、単なるAPIラッパーではなく、本番運用レベルのインフラごと提供されるという点です。
まず注目したいのが、マルチモデル対応の柔軟さです。Cursor SDKでは、modelフィールドを1つ変更するだけで、Cursorが対応しているすべてのAIモデルを切り替えて使うことができます。公式ブログのコード例ではGPT-5.5やComposer 2が使われており、タスクの性質やコスト感に合わせて最適なモデルを選定できる設計です。
特にComposer 2は、汎用モデルと比べて数分の一のコストで最先端レベルのコーディング性能を発揮するとされており、大量のエージェントタスクを回す場面でのコスト効率が期待できます。
Cursor SDKの安全性・制約
Cursor SDKの安全性や制約についても確認しておきましょう。
クラウド実行時には各エージェントに専用VMが割り当てられ、強力なサンドボックス化が施されるため、エージェント同士が互いの環境に干渉するリスクは抑えられています。一方で、Anysphereの利用規約では、サービスのリバースエンジニアリングや改変、競合サービスの開発を目的としたモデル抽出などが明確に禁止されています。
Cursor SDKの料金
Cursor SDKの利用料金は、Cursorの既存プランに紐づく形で提供されています。SDK単体での追加料金体系は設けられておらず、標準のトークンベース従量課金に基づいて請求される仕組みです。
| プラン | 月額料金 | 主な特徴 |
|---|---|---|
| Free | 無料 | Agentリクエスト数・Tab補完回数に制限あり、SDK利用不可 |
| Pro | 月額20ドル | Agentの利用上限拡大、Tab補完無制限、クラウドエージェント対応 |
| Pro+ | 月額60ドル | Proの全機能に加え、OpenAI・Claude・Geminiモデルの利用上限が3倍に |
| Ultra | 月額200ドル | Proの全機能に加え、モデル利用上限が20倍、新機能への優先アクセス |
| Teams | 月額40ドル/ユーザー | チーム管理機能、SAML/OIDC SSO、アナリティクス対応 |
| Enterprise | 要問い合わせ | 利用量共有プール、SCIM、監査ログ、優先サポート |
Cursor SDKのライセンス
Cursor SDKは、Anysphere社が提供するプロプライエタリ（独自）ライセンスのもとで提供されています。オープンソースライセンスではないため、利用にあたってはCursorの利用規約に準拠する必要があります。
| 項目 | 可否 | 備考 |
|---|---|---|
| 商用利用 | ⭕️ | |
| 改変 | ❌️ | ソースコードの改変・派生物の作成は利用規約で禁止 |
| 再配布 | ❌️ | SDKやサービスの再配布・転売は不可 |
| 特許利用 | – | 特許に関する明示的な条項は公開情報では確認できず |
| 私的利用 | ⭕️ |
Cursor SDKの使い方
Cursor SDKは、数ステップで導入してすぐにエージェントを動かすことができます。ここからは、ローカル実行とクラウド実行の2パターンに分けて、具体的な手順を解説します。
APIキーを取得
まずは、CursorのダッシュボードからAPIキーを発行します。
Cursorのインテグレーションダッシュボードにアクセスし、APIキーを作成してください。
取得したAPIキーは環境変数として設定しておきます。
export CURSOR_API_KEY="your-api-key-here"
SDKをインストール
Node.js環境が整っていることを確認した上で、npmからSDKパッケージをインストールします。
npm install @cursor/sdkこれだけで準備は完了です。TypeScriptプロジェクトであれば、型定義もパッケージに含まれているためそのまま利用できます。
ローカルでエージェントを実行
最もシンプルな使い方として、ローカルのリポジトリに対してエージェントを実行してみましょう。以下のコードをファイルに保存して実行します。
import { Agent } from "@cursor/sdk";
const agent = await Agent.create({
apiKey: process.env.CURSOR_API_KEY!,
model: { id: "composer-2" },
local: { cwd: process.cwd() },
});
const run = await agent.send("Summarize what this repository does");
for await (const event of run.stream()) {
console.log(event);
}
localオプションにcwd（カレントディレクトリ）を指定することで、そのディレクトリのコードベースをコンテキストとして読み込んだ状態でエージェントが起動します。modelにはcomposer-2のほか、Cursorが対応する任意のモデルIDを指定できます。
クラウドでエージェントを実行
本番ワークフローや長時間タスクには、クラウド実行が適しています。以下のようにcloudオプションを指定すると、CursorのクラウドVM上でエージェントが動作します。
import { Agent } from "@cursor/sdk";
const agent = await Agent.create({
apiKey: process.env.CURSOR_API_KEY!,
model: { id: "gpt-5.5" },
cloud: {
repos: [{ url: "https://github.com/your-org/your-repo", startingRef: "main" }],
autoCreatePR: true,
},
});
const run = await agent.send("Fix the auth token expiry bug");
console.log(`Started ${run.id}`);autoCreatePR: trueを指定すると、エージェントの作業完了後に自動でPull Requestが作成されます。PCがスリープしてもエージェントは独立して動き続けるため、あとから結果を確認するといった使い方ができます。
MCPサーバーを接続
外部ツールやデータソースとの連携が必要な場合は、MCPサーバーの設定を追加します。リポジトリの.cursor/mcp.jsonファイルに設定を記述するか、SDK呼び出し時にインラインで渡すことで、stdioまたはHTTP経由で外部サービスに接続できます。
サンプルプロジェクトを活用
Cursorは公式のcookbookリポジトリにサンプルプロジェクトを公開しています。
Quickstart（最小構成のローカル実行例）、Prototyping tool（クラウド環境でのプロトタイピング用ウェブアプリ）、Kanban board（エージェント駆動のカンバンツール）、Coding agent CLI（ターミナルからエージェントを起動するCLI）の4種類が用意されているので、ご自身のユースケースに近いものをフォークして拡張するのがおすすめです。
【業界別】Cursor SDKの活用シーン
Cursor SDKは汎用的なエージェント構築基盤であるため、業界を問わず幅広い場面で活用できます。ここからは、具体的な業界ごとに想定されるユースケースを紹介します。
SaaS・Webサービス開発
SaaS企業にとって、Cursor SDKはCI/CDパイプラインの自動化を一段階進めるツールになり得ます。
例えば、PRがマージされたタイミングでエージェントを起動し、変更内容の要約を自動生成してSlackに投稿する、テストが失敗した際にエージェントが原因を特定して修正PRを作成するといったワークフローが構築できます。
生成AIを搭載したSaaSについて、詳しく知りたい方は以下の記事も参考にしてみてください。
金融・フィンテック
コードの品質管理やコンプライアンスチェックを自動化したい金融業界では、セルフホスト型ワーカーを使ってコード実行を自社ネットワーク内に閉じられる点が魅力です。
規制要件に準拠しつつ、レガシーシステムのマイグレーション支援にエージェントを活用する使い方も考えられます。
金融業界における生成AI活用について、詳しく知りたい方は以下の記事も参考にしてみてください。
教育機関
プログラミング教育の現場では、学生が書いたコードに対して自動的にレビューやフィードバックを返すエージェントを構築できます。
Cursorのコンテキスト管理機能を活かして、コードベース全体を理解した上での的確な指摘なども可能になります。
教育業界における生成AI活用について、詳しく知りたい方は以下の記事も参考にしてみてください。
【課題別】Cursor SDKが解決できること
Cursor SDKは、開発現場で日常的に直面するさまざまな課題に対して、プログラマブルなエージェントという解決策を提供してくれます。課題別に解決できることを3つご紹介します。
CI失敗時の原因特定と修正を自動化
CIパイプラインでテストが失敗するたびに手動で原因を調べていませんか。Cursor SDKを使えば、CI失敗を検知したタイミングでエージェントが自動的にログを解析し、根本原因を特定した上で修正コミットを含むPRを作成する仕組みが構築できます。
エージェントのインフラ構築・運用コストを削減
コーディングエージェントを自前で運用しようとすると、サンドボックス化、セッション管理、環境セットアップなど多くのインフラ要件が発生します。
Cursor SDKはこれらをすべてマネージドで提供するため、私たち開発者はエージェントのロジックだけに集中できます。
自社プロダクトにAIコーディング機能を組み込む
顧客向けのアプリケーションにAIコーディング支援を埋め込みたい場合、Cursor SDKを使えば、エンドユーザーがホストアプリケーションを離れることなくエージェント体験を利用できるようになります。
公式ブログでも、この用途で実際にCursorを組み込んでいる企業があると紹介されています。
よくある質問
最後に、Cursor SDKに関して、多くの方が疑問に感じるポイントをQ&A形式でまとめました。
Cursor SDKを導入しよう！
この記事では、2026年4月29日にAnysphere社がパブリックベータとして公開したCursor SDKの概要から仕組み、料金、使い方、活用シーンまでを解説しました。
Cursor SDKは、Cursorのデスクトップアプリを動かしているエージェントの基盤を、そのまま外部のプログラムから利用できるようにしたTypeScript SDKです。ローカル・クラウド・セルフホストの3種類のランタイムに対応し、MCPサーバーやHooks、サブエージェントなどの高度な機能をそのまま活用できるのが特徴です。
コーディングエージェントは、もはやIDE上の対話ツールにとどまらず、組織全体のワークフローを自動化するプログラマブルなインフラへと変わりつつあります。Cursor SDKはその変化を先取りする形で登場しており、CI/CDの自動化や自社プロダクトへのAI機能の組み込みなど、実践的なユースケースがすでに広がり始めています。
まだパブリックベータの段階ではありますが、公式のcookbookリポジトリには実用的なサンプルが揃っているため、まずはQuickstartから試してみてはいかがでしょうか。
最後に
いかがだったでしょうか？
弊社では、AI導入を検討中の企業向けに、業務効率化や新しい価値創出を支援する情報提供・導入支援を行っています。最新のAIを活用し、効率的な業務改善や高度な分析が可能です。
株式会社WEELは、自社・業務特化の効果が出るAIプロダクト開発が強みです！
開発実績として、
・新規事業室での「リサーチ」「分析」「事業計画検討」を70％自動化するAIエージェント
・社内お問い合わせの1次回答を自動化するRAG型のチャットボット
・過去事例や最新情報を加味して、10秒で記事のたたき台を作成できるAIプロダクト
・お客様からのメール対応の工数を80％削減したAIメール
・サーバーやAI PCを活用したオンプレでの生成AI活用
・生徒の感情や学習状況を踏まえ、勉強をアシストするAIアシスタント
などの開発実績がございます。
生成AIを活用したプロダクト開発の支援内容は、以下のページでも詳しくご覧いただけます。
➡︎株式会社WEELのサービスを詳しく見る。
まずは、「無料相談」にてご相談を承っておりますので、ご興味がある方はぜひご連絡ください。
➡︎生成AIを使った業務効率化、生成AIツールの開発について相談をしてみる。
「生成AIを社内で活用したい」「生成AIの事業をやっていきたい」という方に向けて、生成AI社内セミナー・勉強会をさせていただいております。
セミナー内容や料金については、ご相談ください。
また、大規模言語モデル（LLM）を対象に、言語理解能力、生成能力、応答速度の各側面について比較・検証した資料も配布しております。この機会にぜひご活用ください。
