Cursor Agent SDKとは？2026年10月20日GAの作り方とdeployを解説

AI開発ツールアップデート料金改定Cursorエージェント

Cursor が Agent SDK を 2026年10月20日に一般提供（GA）しました。エージェントをフォルダで定義し、init・dev・deploy・eval の各コマンドで開発から展開まで行えます。トリガーは GitHub の PR・コメント・CI と Slack・webhook・cron に対応。作り方と deploy の手順を一次情報で解説します。

結論から言うと、Cursor はエージェント開発キット「Agent SDK」を 2026年10月20日付で一般提供（GA）しました（Cursor Changelog、2026年10月28日取得）。エージェントを 1 つのフォルダとして定義し、npx @cursor/agent-sdk init で初期化、agent-sdk dev でローカル実行、agent-sdk deploy で Cursor のインフラへ展開できます。以下、作り方・deploy の挙動・トリガーの仕組みを公式記載だけで解説します。

Agent SDK とは？エージェントをフォルダで定義する

エージェントは instructions.md・tools・skills・mcp-connections・channels の 5 つの要素を持つ 1 つのフォルダとして定義します（Cursor Changelog、2026年10月20日）。この方式は「agents as code」と呼ばれ、evals でテストした後、Cursor または自社インフラへデプロイできます。

• instructions.md: プロンプト（指示文）を置くファイル。
• tools: 各ファイルがモデルが呼び出せる型付きアクション 1 つに対応します。
• skills: モデルが必要なときに読み込む手順を置きます。
• mcp-connections: MCP サーバーからのツールを追加します。
• channels: ボットがメッセージを受け取り返答する場所を定義します。

作り方：init から dev、eval まで

プロジェクトの初期化は npx @cursor/agent-sdk init ./my-bot で行い、開始時点でテンプレート 4 種類から選べます（Cursor Changelog、2026年10月20日）。テンプレートは security reviewer（セキュリティレビュアー）・owners-policy approver（オーナーポリシー承認者）・PR autofixer（PR 自動修正）・Linear or Jira triager（トリアージ）の 4 種です。

• npx @cursor/agent-sdk init ./my-bot: プロジェクトを初期化します。--template でテンプレートを指定できます。
• agent-sdk dev: ローカルでプレイグラウンド付きのボットを起動します。
• agent-sdk eval: 固定メッセージをボットへ送り、実行されたツール・その入力・返信の形式についてアサートします。ローカルまたは CI で実行できます。
• agent-sdk validate と agent-sdk info: プロジェクトの検証と、SDK が検出した内容の出力に使います。

agent-sdk deploy で Cursor インフラへ展開

agent-sdk deploy はボットをビルドして URL を付与し、Cursor のインフラ上で起動します（Cursor Changelog、2026年10月20日）。シークレットと統合はダッシュボードで管理し、ローカル開発と同じログ・evals・プレイグラウンドをそのまま利用できます。

• agent-sdk github replay <pr-url>: 実際の PR を署名済み webhook ペイロードに変換して送信します。--dry-run --fixtures-dir fixtures/ を付けるとペイロードを eval フィクスチャとして保存できます。
• 会話ごとに独立したセッションと、全メッセージ・ツール呼び出しの完全な記録が保持されます。PR や Slack スレッドでのフォローアップは同一セッションを再開します。

トリガー：PR・Slack・webhook・cron

トリガーは GitHub・GitLab・Bitbucket の PR・コメント・CI イベント、Slack のメンションと DM、任意のプロバイダーからの webhook、cron スケジュールに対応します（Cursor Changelog、2026年10月20日）。GitHub イベントは Cursor アカウント経由で取得されるため、公開 webhook URL は不要です。

• GitHub・GitLab・Bitbucket: PR・コメント・CI イベントをトリガーにできます。GitHub イベントの受け口は公開 webhook URL を作らずに済みます。
• Slack: メンションと DM に対応し、公式記載では最初から良くサポートされています。
• webhook: 任意のプロバイダーからの webhook をトリガーにできます。
• cron: スケジュール実行をトリガーにできます。

よくある質問

Q. Cursor Agent SDK とは何ですか？

Cursor が 2026年10月20日に一般提供（GA）を開始したエージェント開発キットです。エージェントをコードのフォルダとして定義し、evals でテストした後、Cursor または自社インフラへデプロイできます（Cursor Changelog、2026年10月20日）。

Q. Cursor のエージェントはどう作りますか？

npx @cursor/agent-sdk init ./my-bot でプロジェクトを初期化し、agent-sdk dev でローカル実行、agent-sdk eval でテストします（Cursor Changelog、2026年10月20日）。security reviewer・owners-policy approver・PR autofixer・Linear or Jira triager のテンプレート 4 種から始められます。フォルダの中身は instructions.md（プロンプト）・tools（型付きアクション）・skills（手順）・mcp-connections（MCP サーバーのツール）・channels（受け口）で構成します。

Q. agent-sdk deploy を実行すると何が起こりますか？

ボットがビルドされて URL が付与され、Cursor のインフラ上で起動します（Cursor Changelog、2026年10月20日）。シークレットと統合はダッシュボードで管理し、ローカルと同じログ・evals・プレイグラウンドが使えます。稼働 URL のカスタムドメイン対応など細部は今回の発表ページに記載がなく、公式未公表です。

Q. 利用料金はいくらですか？

Agent SDK 自体の利用料金は今回の発表ページに記載がなく、公式未公表です（Cursor Changelog、2026年10月28日取得）。料金や利用上限の詳細は公式ドキュメント（cursor.com/docs）で確認してください。

導入時に確認しておくこと

GA になったばかりのため、料金や提供条件の細部は今回の発表ページには記載がなく、公式未公表の項目があります（Cursor Changelog、2026年10月28日取得）。まずテンプレート 4 種のうち目的に近い 1 種を選んで init し、agent-sdk eval で期待どおりのツール呼び出しと返信形式になるかを確認してから deploy するのが安全です。

• GitHub リポジトリでの自動トリガーは公開 webhook URL 不要で、Cursor アカウントの連携で始められます。
• 本番運用に組み込む前に agent-sdk eval を CI に入れると、ボットのツール呼び出しや返信形式の変更を検知できます。

出典: Cursor Changelog「Agent SDK」（https://cursor.com/changelog/agent-sdk、2026年10月28日取得）

この記事で解説した内容について、エージェント開発環境の設計で相談したいことがあればお問い合わせ（/contact）からどうぞ。

この記事は AI が一次ソースを読んで執筆しました。数値と日付は出典に記した公式情報の執筆時点の値です。誤りを見つけたら訂正の窓口へお知らせください。確認のうえ本文を直し、訂正履歴に残します。編集方針