結論：Notion Developer Platform（2026年5月13日発表）は、Workers・External Agents API・Database Syncの3機能で、Notionをあらゆる外部AIエージェントと接続するハブに変える基盤です。TypeScript数十行のコードを書いてCLIでデプロイするだけで、サーバー不要でAIエージェントをNotionワークスペースに統合できます。
- 要点1：Workersはサーバーレス実行環境。1回あたり約$0.0023、月額$0.01〜$13の範囲で運用可能（Notion公式 2026年5月時点）
- 要点2：External Agents APIでClaude・Codex・Decagonなど10以上の外部エージェントを@メンションで呼び出し可能
- 要点3：Database SyncでSalesforce・Zendesk・PostgreSQLのデータをNotionにリアルタイム同期
対象読者：AIエージェントを業務ツールに統合したい開発者・PM・IT管理者
今日やること：Notion CLI（ntn）をインストールし、Workers のHello Worldを1つデプロイする
「NotionにAIエージェントを組み込みたいが、何から手をつければいいのか分からない」
AIエージェントの実用化が進む中で、もっとも多く聞かれるのがこの疑問です。2026年5月13日、Notionが「Developer Platform」を正式発表しました。これはNotionを単なるドキュメントツールから「AIエージェントが協働するワークスペース」に変える、同社史上最大のプラットフォームシフトです。
評価額110億ドル・1億ユーザーを抱えるNotionが「エージェントハブ」を宣言した意味は大きい。本記事では、Developer Platformの3つの柱（Workers・External Agents API・Database Sync）を、TypeScript実装コードと失敗パターン付きで解説します。
そもそもNotion Developer Platformとは何か
2026年5月13日にNotion 3.5として公式リリースされたプラットフォーム基盤です。自前サーバー不要でTypeScriptコードをNotion上で実行できます（AIエージェント構築完全ガイドも参照）。
3つの柱 — Workers・External Agents API・Database Sync
| 機能 | 役割 | 利用例 | ステータス |
|---|---|---|---|
| Workers | サーバーレスTypeScript実行環境 | Webhook受信、定期データ同期、カスタムツール | ベータ（2026年8月11日まで無料） |
| External Agents API | 外部AIエージェントとの接続 | Claude・Codexを@メンションで呼び出し | アルファ（ウェイトリスト） |
| Database Sync | 外部データのリアルタイム同期 | Salesforce・Zendesk・PostgreSQLからの自動取り込み | Workers経由で利用可能 |
従来のNotion APIとの決定的な違い
従来のNotion APIは「外からNotionを読み書きする」ための仕組みでした。開発者は自前のサーバーでAPIを叩き、Notionのページやデータベースを操作していました。これに対し、Developer PlatformはNotionの中でコードを動かすという根本的な発想の転換です。
| 項目 | 従来のNotion API | Developer Platform |
|---|---|---|
| コード実行場所 | 自前サーバー（AWS/Vercel等） | Notionのサンドボックス |
| 認証管理 | OAuth 2.0（自前実装） | CLIで自動管理 |
| デプロイ | 自前CI/CD | ntn deploy1コマンド |
| 外部データ連携 | ポーリング実装が必要 | Database Sync組み込み |
| AIエージェント統合 | 非対応 | External Agents APIで10+エージェント対応 |
| 月額コスト目安 | AWS Lambda $5〜50+ | $0.01〜$13（Notion Credits） |
対応プランと提供スケジュール
Workersのデプロイと管理はBusiness（月額$18/ユーザー）およびEnterpriseプランのみで利用可能です。ベータ期間中（2026年8月11日まで）はWorkersの実行は無料。以降はNotionクレジット（1,000クレジット=$10）での課金に移行します（Notion公式 料金ページ 2026年5月時点）。
なぜ今Notionがエージェントハブを目指すのか
SaaSプラットフォーム戦争の構図
2026年は「SaaS全面エージェント化」の年です。SalesforceはAgentforceを、SlackはMCPベースの30の新機能をリリース。Notionはドキュメント・タスク・ナレッジが集約される「仕事の中心地」として、エージェントハブを目指します。
1億ユーザーの巨大エコシステム
Notionは世界85カ国・1億ユーザー、評価額110億ドル（TechCrunch 2026年5月）。ARRの50%以上がAI機能利用者からの収益で、エージェント統合は成長戦略の中核です。
「オーケストレーション層」としてのポジション
AIエージェントの数が増えるほど、統合管理する「コントロールプレーン」が必要です。94%の企業がAIスプロール（エージェントの野放図な増殖）を懸念しています（OutSystems 2026 State of AI Development Report、約1,900名のIT責任者調査）。社内ナレッジ・タスク・ドキュメントが集約されるNotionは、このオーケストレーション層になる優位性があります。
Workers — サーバーレスコード実行基盤の全貌
Workersのアーキテクチャと動作原理
Notion Workersは、小さなNode.js/TypeScriptプログラムをNotionのセキュアなサンドボックスで実行する仕組みです。開発者はWorkerクラスを使ってコードを記述し、CLIでデプロイします。Workersは3つのトリガーで起動します。
- Sync（定期実行）: スケジュールに基づいて外部データをNotionに同期
- Tool（エージェントツール）: Notion AIカスタムエージェントから呼び出されるカスタム関数
- Webhook（外部イベント）: GitHub・Stripe・Zendesk等からのイベント受信
Notion CLI（ntn）のセットアップ手順
すべてのWorker操作はNotion CLI（ntnコマンド）経由で行います。UI上でのデプロイパスはなく、CLIは必須です。
# 注意: 本番環境で使用する前に、必ずテスト環境で動作確認してください。
# 1. Notion CLIのインストール
npm install -g @notionhq/cli
# 2. 認証（ブラウザが開き、Notionワークスペースへのアクセスを許可）
ntn login
# 3. Workerプロジェクトの作成
ntn workers new my-first-worker
# 4. プロジェクトディレクトリに移動
cd my-first-worker
# 5. デプロイ（ビルド→アップロード→有効化が自動実行）
ntn deploy動作環境: Node.js 18+、npm 9+、Notion Business/Enterpriseプラン
Database Syncの実装例 — Zendesk連携
以下は、Zendeskのチケット情報をNotionデータベースに定期同期するWorkerの実装例です。
// 注意: 本番環境で使用する前に、必ずテスト環境で動作確認してください。
// 動作環境: Node.js 18+, @notionhq/workers SDK
import { Worker } from "@notionhq/workers";
const worker = new Worker();
const ticketDb = worker.database({
title: worker.property.title("チケット名"),
status: worker.property.select("ステータス", {
options: ["新規", "対応中", "解決済み"]
}),
priority: worker.property.select("優先度", {
options: ["低", "中", "高", "緊急"]
}),
zendeskId: worker.property.number("Zendesk ID"),
});
worker.sync({
database: ticketDb,
schedule: "every 1 hour",
handler: async (ctx) => {
const res = await fetch(
`https://${ctx.env.ZENDESK_DOMAIN}.zendesk.com/api/v2/tickets.json?per_page=100`,
{ headers: { "Authorization": `Bearer ${ctx.env.ZENDESK_API_TOKEN}` } }
);
const data = await res.json();
return data.tickets.map(t => ({
title: t.subject,
status: mapStatus(t.status),
priority: mapPriority(t.priority),
zendeskId: t.id,
}));
}
});
export default worker;ポイント: 環境変数はntn env set ZENDESK_API_TOKEN=xxxxでセキュアに管理。ハードコードは厳禁です。
Webhook受信の実装例 — GitHub連携
GitHubのPull Requestイベントを受信し、Notionのタスクデータベースを自動更新するWorkerの骨格です。
// 注意: 本番環境で使用する前に、必ずテスト環境で動作確認してください。
// 動作環境: Node.js 18+, @notionhq/workers SDK
import { Worker } from "@notionhq/workers";
const worker = new Worker();
const prDb = worker.database({
title: worker.property.title("PR名"),
repo: worker.property.richText("リポジトリ"),
prStatus: worker.property.select("ステータス", {
options: ["Open", "Merged", "Closed"]
}),
url: worker.property.url("URL"),
});
worker.webhook({
database: prDb,
path: "/github-pr",
handler: async (ctx) => {
const pr = ctx.body.pull_request;
if (!pr) return [];
return [{
title: pr.title,
repo: ctx.body.repository.full_name,
prStatus: pr.merged ? "Merged" : pr.state === "open" ? "Open" : "Closed",
url: pr.html_url,
}];
}
});
export default worker;カスタムAgent Toolsの作り方
Workersでは、Notionカスタムエージェントが呼び出す「ツール」を定義できます。在庫管理APIの呼び出しツールの例です。
// 注意: 本番環境で使用する前に、必ずテスト環境で動作確認してください。
// 動作環境: Node.js 18+, @notionhq/workers SDK
import { Worker } from "@notionhq/workers";
const worker = new Worker();
worker.tool({
name: "check_inventory",
description: "指定商品の在庫数を取得",
parameters: {
product_id: { type: "string", description: "商品ID（例: SKU-12345）" }
},
handler: async (ctx, params) => {
const res = await fetch(
`${ctx.env.INVENTORY_API_URL}/api/v1/inventory/${params.product_id}`,
{ headers: { "Authorization": `Bearer ${ctx.env.INVENTORY_API_KEY}` } }
);
if (!res.ok) return { error: `APIエラー: ${res.status}` };
const d = await res.json();
return { product_id: params.product_id, name: d.name, stock: d.quantity };
}
});
export default worker;External Agents API — 外部AIエージェントとの接続
対応エージェントとパートナー一覧
External Agents APIを使うと、外部のAIエージェントをNotionワークスペース内の「チームメンバー」として扱えます。2026年5月時点で連携が確認されているパートナーは以下の通りです。
| エージェント | 提供元 | 主な用途 |
|---|---|---|
| Claude | Anthropic | ドキュメント作成・分析・コードレビュー |
| Codex | OpenAI | コーディング・デバッグ・技術文書 |
| Decagon | Decagon | カスタマーサポート自動化 |
| Cursor | Anysphere | コーディングエージェント |
| Warp | Warp | ターミナル・DevOps自動化 |
| Cognition (Devin) | Cognition AI | ソフトウェアエンジニアリング |
| Flora | Flora | デザインアシスタント |
| Amplitude | Amplitude | プロダクト分析 |
| Console | Console | インフラ管理 |
| 自作エージェント | （任意） | 社内専用エージェント |
（パートナー情報はNotion公式ブログ 2026年5月13日時点。パートナーは随時追加される可能性があります。）
OAuth 2.0認証フロー
External Agents APIはOAuth 2.0を採用。接続フローは4ステップです。
- 外部エージェント（例: Claude Code）がOAuth 2.0フローを開始
- メンバーがページピッカーでアクセス許可するページ/DBを選択
- エージェントが@メンション可能なメンバーとして登録
- DBアイテムへのアサインやページ内チャットが利用可能に
注意: 2026年5月時点でアルファ版。notion.com/product/devからウェイトリスト申請が必要です。
@メンションでエージェントに仕事を依頼する
接続が完了すると、Notionページやデータベース上で@Claudeのようにメンションして仕事を依頼できます。具体的には以下の操作が可能です。
- データベースのアイテムにエージェントをアサインし、自動処理を依頼
- ページ内でエージェントとチャットし、文脈に基づいた回答を取得
- 複数エージェント間のハンドオフ（例: Claudeが分析→Codexがコード生成）
実践プロンプト5選 — Notion AIエージェントを最大活用する
Notionカスタムエージェントで使えるプロンプトを5つ紹介します。すべてコピペ可能です。
プロンプト1: 議事録からタスク自動抽出
あなたはプロジェクトマネージャーのアシスタントです。
以下の議事録を読み、アクションアイテムを抽出してください。
## 出力形式（厳守）
- タスク名: [具体的なタスク名]
- 担当者: [議事録から推定される担当者名]
- 期限: [議事録に記載があれば日付、なければ「要確認」]
- 優先度: [高/中/低]
## ルール
- 曖昧な「検討する」は含めない。具体的なアクションのみ抽出
- 担当者が不明な場合は「未割当」と記載
- 数字と固有名詞は、根拠（出典/計算式）を添えてください
- 不足している情報があれば、最初に質問してから作業を開始してくださいプロンプト2: 競合分析レポート自動生成
あなたは市場調査アナリストです。
指定企業の競合分析レポートを作成してください。
## 分析項目（各2-3文）
1. プロダクト概要 2. 料金体系（不明なら「非公開」）
3. ターゲット層 4. 強み3つ・弱み3つ
5. 直近3ヶ月の重要ニュース
## 出力: Notion DBプロパティ入力形式。数字には出典URL添付
- 推測と事実を明確に区別すること
- 不足している情報があれば、最初に質問してから作業を開始してくださいプロンプト3: Zendeskチケットの自動分類と優先度付け
あなたはカスタマーサポートの品質管理担当です。
同期されたZendeskチケットを以下の基準で分類・優先度付けしてください。
## 分類カテゴリ
- バグ報告 / 機能要望 / 使い方の質問 / アカウント問題 / 請求問題
## 優先度判定基準
- 緊急: サービス停止・データ損失・セキュリティ問題
- 高: 業務に支障がある不具合
- 中: 機能改善要望・非致命的バグ
- 低: 使い方の質問・改善提案
## 出力
各チケットについて: カテゴリ / 優先度 / 推定対応時間 / 推奨対応者
## 注意
- 個人情報（メールアドレス・電話番号）は出力に含めない
- 不足している情報があれば、最初に質問してから作業を開始してくださいプロンプト4: スプリント計画の自動提案
あなたはスクラムマスターのアシスタントです。
バックログ（このDB）を分析し、次回スプリント計画を提案してください。
## 入力: 期間2週間、メンバー[数字]名、ベロシティ[数字]pt
## 提案内容
1. 推奨アイテム一覧（合計ptがベロシティ内）
2. 依存関係の警告
3. リスク要因（期限が近い/見積もりが大きい）
## 制約: 「緊急」タグ付きは必ず含める
- 不足している情報があれば、最初に質問してから作業を開始してくださいプロンプト5: 週次レポートの自動要約
あなたは経営企画のアシスタントです。
このDBの今週の活動ログから週次レポートを作成してください。
## 構造
1. 今週のハイライト（3つ、数値付き）
2. 進捗サマリー（完了/新規/残タスク数）
3. ブロッカーとリスク（滞留タスクと理由）
4. 来週の重点項目（未完了から3つ）
## 制約: 事実ベース。推測は「（推定）」と明記
- 不足している情報があれば、最初に質問してから作業を開始してください【要注意】よくある失敗パターンと回避策
失敗1: Workersに秘密情報をハードコードする
❌ APIキーやトークンをソースコード内に直接記述する
⭕ ntn env set ZENDESK_API_TOKEN=xxxx で環境変数としてセキュアに管理し、コード内ではctx.env.ZENDESK_API_TOKENで参照する
なぜ重要か: Workersのコードはワークスペースの管理者から閲覧可能です。ハードコードされた秘密情報は漏洩リスクが極めて高くなります。
失敗2: External Agents APIの権限を過剰に付与する
❌ ページピッカーで「ワークスペース全体」へのアクセスを許可する
⭕ 必要最小限のページとデータベースだけを選択する（最小権限の原則）
なぜ重要か: 外部エージェントに社内の全情報へのアクセスを許可すると、意図しない情報漏洩やハルシネーションに基づく誤った操作のリスクが高まります。MCPサーバーのセキュリティ設計についてはMCPサーバーの脆弱性と防御7選も確認してください。
失敗3: Database Syncの実行頻度を高くしすぎる
❌ 外部APIへのリクエストを「毎分」で設定し、APIレート制限に引っかかる
⭕ まず「毎時」で設定し、実際のデータ更新頻度を見て調整する。差分更新（updated_at ベース）を実装する
なぜ重要か: Workersの実行回数はNotionクレジットに直結します。毎分実行だと月43,200回（≒約$99）のコストが発生しますが、毎時なら720回（≒約$1.66）で済みます。Notion公式の試算例でも「daily Jira pull = 月$0.01、heavy usage 9,800 runs = 月$13」としています（Notion Pricing Docs 2026年5月時点）。
失敗4: FreeプランやPlusプランでWorkersを使おうとする
❌ 個人のFreeプランでWorkerをデプロイしようとしてエラーになる
⭕ WorkersはBusiness（月額$18/ユーザー）またはEnterpriseプランのみ。まず小規模チームでBusiness Trialを開始する
なぜ重要か: プラン要件を見落としたまま開発を進めると、デプロイ直前で止まるという無駄が発生します。事前にプラン要件を確認し、承認を得てからプロジェクトを開始しましょう。
料金体系とコスト試算
Notionクレジットの仕組み
Notion Developer Platformの課金単位は「Notionクレジット」です。1,000クレジット=$10で、ワークスペース管理者がBusiness/Enterpriseプランのアドオンとして購入します。Workersの実行はクレジットを消費し、1回の実行あたりの消費量は処理時間と計算量によって変動します（Notion公式 2026年5月時点）。
利用規模別コストシミュレーション
| 利用シナリオ | 月間実行回数 | 月額コスト概算 |
|---|---|---|
| 日次Jiraデータ同期（1回/日） | 30回 | 約$0.01 |
| 毎時Zendesk同期（24回/日） | 720回 | 約$1.66 |
| GitHub Webhook（PR 50件/日） | 1,500回 | 約$3.45 |
| 複合利用（同期+Webhook+ツール呼出し） | 9,800回 | 約$13 |
| 大規模運用（全社利用・複数Worker） | 50,000回 | 約$115 |
（Notion公式の試算例をベースに編集部が推計。実際のコストは処理内容により変動します。2026年5月時点。）
ポイント: AWS Lambda等で同等のNotion連携を構築すると月$5〜50+かかるケースが多く、小〜中規模ならWorkersの方が安くなります。コスト設計はAIエージェントコスト最適化の実践7手法も参考に。
競合プラットフォームとの比較
| 項目 | Notion | Slack MCP | Salesforce Agentforce |
|---|---|---|---|
| 強み | ナレッジ統合 | リアルタイム通信 | CRM連携 |
| 統合方式 | External Agents API | MCP | 独自API |
| 実行環境 | Workers (TS) | Apps (Node/Python) | Apex / Flow |
| 月額最低 | $18/user | $8.75/user | $165〜/user |
| 向くケース | ドキュメント中心 | チャット中心 | 営業・CS大規模 |
（各社公式サイト情報。2026年5月時点。）
Notion AIエージェントが向くユースケース・向かないユースケース早見表
Notion Developer Platform を「導入すべきか」を判断する前に、そもそも自社の業務がNotionエージェント基盤に向いているのかを見極める必要があります。料金や実装難易度の前に、ワークロードの相性で大きく成否が分かれるからです。ここでは「Notionが主戦場になる業務」と「別の基盤を検討すべき業務」を早見表に整理しました。判断軸は、データの所在がNotion中心か、人とAIの協働が前提か、リアルタイム性や大量処理を求めるかの3点です。
| 業務シナリオ | 適性 | 理由・補足 |
|---|---|---|
| 議事録・ドキュメントからのタスク抽出と起票 | 向く | 元データも出力先もNotion内で完結。エージェントの@メンション運用と相性が良い |
| 社内ナレッジ・ドキュメントを横断した要約・調査 | 向く | 広く普及したドキュメント基盤を文脈として活用できる強みが出る |
| 外部SaaS（CRM・問い合わせ等）の情報をNotionに集約・分類 | 向く | Database Syncや外部連携でNotionを「オーケストレーション層」として使える典型 |
| プロジェクト進行・スプリント運用の半自動化 | 条件付き | 運用ルールとレビュー体制があれば有効。人の最終確認を挟む設計が前提 |
| ミリ秒単位のリアルタイム応答が必要な処理 | 向かない | ドキュメント駆動の協働基盤であり、低レイテンシ前提のシステムには不向き |
| 大量データのバッチ処理・ETLの中核 | 向かない | 専用のデータ基盤・ワークフローエンジンの領域。Notionは集約・可視化側に置く |
| 厳格な監査・コンプライアンスが最優先の基幹処理 | 慎重に | 権限設計と証跡要件を満たせるか、公式ドキュメントで個別に要確認 |
判断のコツ
迷ったときは「そのデータは普段どこに置いているか」を起点に考えると整理しやすくなります。情報がすでにNotionに集まっている、あるいは集めたい業務であれば適性は高く、逆にNotion外のシステムが主役の処理は、Notionを「集約・可視化のハブ」に留めるほうが破綻しにくい構成です。最初から全社展開を狙わず、適性「向く」の業務でPoC（試験導入）を1つ回し、効果を確かめてから範囲を広げるのが現実的な進め方です。
本番導入前に確認したい実務チェックリスト
機能検証が済んでも、いきなり本番運用に乗せると権限・コスト・運用ルールの設計漏れでつまずきがちです。ここでは、Notion AIエージェントやWorkersを本番投入する前に、担当者が部門横断で確認しておきたい実務項目をチェックリスト形式でまとめました。技術的な実装そのものよりも、「誰が・何を・どこまで・いつ止められるか」を事前に決めておくことが事故を防ぎます。各項目は自社の状況に合わせて埋め、具体的な制限値や課金の詳細は公式ドキュメント（developers.notion.com）で必ず最新情報を確認してください。
権限設計・セキュリティ
- 最小権限の原則：エージェントや外部連携に渡す権限を、業務に必要な範囲へ絞り込んだか
- シークレット管理：APIキーやトークンをコードに直書きせず、安全な保管方法に切り出したか
- アクセス範囲の棚卸し：どのワークスペース・データベースにエージェントが触れるかを一覧化したか
- 退職・委託先対応：担当者交代や外部委託終了時に権限を失効させる手順を決めたか
データ連携・整合性
- 同期方向の明確化：外部データとNotionのどちらを正（マスター）とするかを定義したか
- 実行頻度の設計：同期や処理の頻度が過剰になっていないか、業務上の鮮度要件と釣り合っているか
- 重複・競合対策：同一レコードの二重登録や上書き競合が起きたときの扱いを決めたか
- 個人情報・機密の扱い：外部に出してはいけないデータがNotionに流れ込まない仕切りを設けたか
コスト管理
- 課金単位の理解：何に対して費用が発生するかを担当部署が把握しているか（数値は公式で要確認）
- 上限・アラート：想定外の処理量で費用が膨らんだ際に気づける監視・通知を用意したか
- プラン要件の確認：必要な機能が自社の契約プランで利用できるかを事前に照合したか
運用ルール・体制
- 人の確認ポイント：エージェントの出力をそのまま反映せず、人がレビューする工程を定義したか
- 停止手順（キルスイッチ）：誤作動時に連携や自動処理を即座に止める手順を周知したか
- ログと振り返り：いつ・誰の指示で・何が実行されたかを追える記録を残す設計にしたか
- 段階的展開：一部門・一業務の試験運用から始め、評価してから対象を広げる計画にしたか
このチェックリストを「導入判断のゲート」として使えば、機能の魅力だけで全社展開して後戻りする失敗を避けられます。特に権限とコストは後から効いてくる項目なので、PoCの段階から運用ルールとセットで設計しておくことを推奨します。
よくある質問
Q1: Notion Developer Platformとは何ですか？
Notionが2026年5月13日に発表した、Workers（サーバーレスコード実行）・External Agents API（外部AIエージェント接続）・Database Sync（外部データ同期）の3機能で構成されるプラットフォームです。開発者はTypeScriptでコードを書き、CLIで1コマンドでデプロイできます。
Q2: 料金はいくらですか？
Workersの実行は1回あたり約$0.0023で、1,000クレジット=$10のNotionクレジットで支払います。2026年8月11日まではベータ期間で無料。ベースとなるNotionプランはBusiness（月額$18/ユーザー）またはEnterpriseが必要です。
Q3: 無料で使えますか？
2026年8月11日まではWorkers実行が無料のベータ期間です。ただし、WorkersのデプロイにはBusiness/Enterpriseプラン（月額$18/ユーザー〜）が必要なので、プラン費用は別途発生します。
Q4: Slack MCPと何が違いますか？
Slackはリアルタイムチャットを軸に、MCPプロトコルでAIエージェントを統合します。Notionはドキュメント・データベース・プロジェクト管理を軸に、Workers+External Agents APIでAIエージェントを統合します。チャット中心のワークフローにはSlack、ナレッジ管理中心のワークフローにはNotionが適しています。
Q5: 中小企業（10〜50名規模）でも使えますか？
利用可能です。Businessプランの月額$18/ユーザーが許容できれば、10名チームで月$180+Workersクレジット$10程度（月額合計$190前後）で運用を開始できます。AWS Lambdaやサーバー管理の技術負債を考えると、小規模チームほどWorkersのシンプルさは活きます。
Notion MCPとは何か — Claude・Cursorと接続する標準プロトコル
2026年5月13日のDeveloper Platform発表で同時に強化された機能のひとつが、Notion MCP（Model Context Protocol）です。MCPはAnthropicが提唱した開放規格で、AIツールがNotionワークスペースに安全にアクセスするためのブリッジとして機能します。Workers・External Agents APIが「コードを動かす」経路なら、Notion MCPは「AIアシスタントがNotionを読み書きする」経路です。
2026年5月の更新で、notion-create-databaseとnotion-update-data-sourceツールがSQLのDDL（Data Definition Language）形式ベースのスキーマに切り替わり、コンテキストトークンを約91%削減することに成功しました。これにより、APIコスト・レスポンス速度の両面で、AIエージェントとNotionの連携効率が大幅に向上しています（Notion公式リリースノート 2026年5月13日）。
Notion MCPが対応するAIクライアント
2026年6月時点で、以下のAIクライアントがNotion MCP経由でのNotionアクセスをサポートしています（Notion Help Center「Notion MCP」より）。
| AIクライアント | 接続方法 | 主な用途 |
|---|---|---|
| Anthropic Claude | MCPギャラリーからワンクリック or Claude Code設定 | ページ生成・要約・タスク整理 |
| Cursor | MCPギャラリー or .cursor/mcp.jsonに手動設定 |
コード実装とNotionドキュメントの同期 |
| ChatGPT Pro | MCPギャラリーからワンクリック | Notionコンテンツとのチャット・要約 |
| その他MCP対応ツール | 開発者ドキュメント経由の手動設定 | カスタム用途 |
Notion MCPのセットアップ手順（Claude Code例）
Claude CodeでNotion MCPを利用する場合、.mcp.jsonまたはClaude Code設定ファイルに以下のように記述します。
// .mcp.json（例）
{
"mcpServers": {
"notionhq-notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"OPENAPI_MCP_HEADERS": "{"Authorization": "Bearer ntn_YOUR_TOKEN_HERE"}"
}
}
}
}
認証トークンの取得方法: Developer Portal（app.notion.com/developers）でPersonal Access Token（PAT）を発行します。2026年5月12日からは、ワークスペース管理者でなくても任意のメンバーがトークンを発行できるようになりました（Notion API Changelog 2026年5月12日）。
MCPで利用できる主な操作
Notion MCPを接続したAIツールは、OAuth認証の範囲内で以下の操作をNotionに対して実行できます。
- 読み取り: ページ本文・データベースレコード・コメントの取得
- 書き込み: ページへの文章・ブロックの追加・更新
- データベース操作: レコードの作成・フィルタリング・ソート（DDLスキーマで91%効率化）
- ミーティングノート対応: Meeting Notes形式のページへのアクセス（2026年5月更新）
- ブロックコメント: ページ内コメントの読み書き（2026年5月更新）
ガバナンス: Enterpriseプランでは管理者が「承認済みMCPツールのリスト」のみ接続許可するように制限できます。セキュリティポリシーが厳しい組織では、接続前にIT部門での承認フローを設けることを推奨します（Notion Help Center）。
Notion Workersの実行環境詳細 — スケジュール・ランタイム・CLIコマンド
既存記事ではWorkersの概要とコード例を解説しましたが、実際に本番運用を始めると「スケジュールはどこで変える？」「タイムアウトは何秒？」「デプロイ前にローカルテストできるか？」という疑問が出てきます。このセクションでは、Notion公式ドキュメント（developers.notion.com/workers / Workers Quickstart 2026年6月参照）をもとに、運用に直結する仕様をまとめます。
前提環境と最新CLIインストール方法
Notion Workersを動かすには以下の環境が必要です。既存記事では「Node.js 18+、npm 9+」と記載していましたが、2026年6月時点のQuickstartでは Node.js 22以上、npm 10以上が前提として記載されています（Notion Workers Quickstart）。Node.jsのバージョンを確認してから開発を始めてください。
# Node.jsのバージョン確認
node --version # v22以上であることを確認
# Notion CLIのインストール（公式推奨方法）
curl -fsSL https://ntn.dev | bash
# または npm経由
npm install -g @notionhq/cli
# バージョン確認
ntn --versionSyncのスケジュール仕様
Database SyncのWorkerにおけるデフォルトのスケジュールは30分ごとです（Notion Workers Overview）。スケジュールはWorker定義の中でカスタマイズ可能です。
| 頻度設定 | 月間実行回数（概算） | 月額コスト概算 |
|---|---|---|
| デフォルト（30分ごと） | 約1,440回 | 約$3.31 |
| 1時間ごと | 約720回 | 約$1.66 |
| 1日1回 | 約30回 | 約$0.07 |
| 15分ごと | 約2,880回 | 約$6.62 |
（コスト概算はNotion公式の1回あたり約$0.0023のレートと各スケジュールの実行回数を掛け合わせて算出。実際のコストは処理内容によって変動します。Notion公式 Workers Pricing 2026年5月時点。）
デプロイ前のローカルテスト方法
Workersは本番デプロイ前に、ntn workers execコマンドでToolsのローカルテストができます。
# Worker のデプロイ
ntn workers deploy
# Tool の動作テスト（デプロイ後）
ntn workers exec sayHello -d '{"name": "World"}'
# 環境変数のセット（シークレット管理）
ntn env set ZENDESK_API_TOKEN=your_token_here
# 環境変数の一覧確認
ntn env listデプロイの流れ: ntn workers deployを実行すると「ビルド → アップロード → 有効化」が自動で行われ、失敗した場合はロールバックされます。デプロイごとにバージョンが記録されるため、問題が起きた際は前のバージョンに戻せます。
WorkersのSDKメソッド構造（2026年6月時点）
公式Quickstartで確認できるSDKメソッドの基本構造は以下の通りです。
// 動作環境: Node.js 22+, @notionhq/workers SDK
import { Worker } from "@notionhq/workers";
const worker = new Worker();
// Tool: エージェントから呼び出し可能な関数
worker.tool("sayHello", {
title: "Say Hello",
description: "Returns a friendly greeting",
schema: { /* JSON Schema でパラメータ定義 */ },
execute: ({ name }) => `Hello, ${name}!`
});
// Sync: スケジュールに基づいたデータ取得
worker.sync({ /* database, schedule, handler */ });
// Webhook: 外部サービスからのHTTPイベント受信
worker.webhook({ /* database, path, handler */ });
export default worker;2026年6月時点では worker.database()、worker.tool()、worker.sync()、worker.webhook() の4メソッドが中心的なSDK APIとして公式ドキュメントに記載されています。実行環境はサンドボックス化されたNode.js環境であることが明示されていますが、タイムアウト・メモリの具体的な数値は公式ドキュメント上で現時点では非公開です。本番実装前にdevelopers.notion.comで最新情報を確認することを推奨します。
Notion Agent SDK・Agent ToolsとAPIの全体像 — 外部からNotionエージェントを呼び出す方法
「notion agent api」「notion カスタムエージェント」で検索する開発者の多くは、「コードからNotionのAIエージェントをどう操作するのか」を知りたいはずです。Notion Developer Platformには、向きの異なる3つの「APIの入口」があります。混同しやすいので、最初に役割を整理します。
| 入口 | データの向き | ひとことで言うと |
|---|---|---|
| Notion API（REST）/ MCP | 外部 → Notionの中身を読み書き | ページ・DBをプログラムやAIアシスタントから操作する |
| Agent Tools（Workers） | Notionエージェント → あなたのコードを呼ぶ | Notion AIに「自作の関数（ツール）」を持たせる |
| Agent SDK | 外部アプリ → NotionのCustom Agentを呼ぶ | 自社ツールの中からNotionのエージェントを起動する |
本記事ですでに解説したWorkers・External Agents APIに加え、ここでは「自作ツールの作り方（Agent Tools）」と「外部からエージェントを起動するAgent SDK」という、検索ニーズが高いのに手薄になりやすい2点を、Notion公式（2026年5月13日リリースノート 3.5 / Workers / Tools ガイド）をもとに掘り下げます。
Agent Tools — Notion AIが呼び出す「自作関数」を定義する
Agent Tools（公式表記「Custom Agent Tools」、2026年6月時点でベータ）は、Workers上に書いた関数をNotionのCustom Agentから呼び出せるようにする機能です。公式ブログの表現では「ツールはdeterministic（決定的）でトークン効率が良く、書いたとおりに毎回実行される」とされています。本記事の前半ではツール定義を簡略表記で示しましたが、公式ドキュメントの最新の正式な書き方は次のとおりです。スキーマはjスキーマビルダーで定義し、各フィールドに.describe()で説明を付けます。
// 出典: developers.notion.com/workers/guides/tools（2026年6月参照）
// 動作環境: Node.js 22+, @notionhq/workers SDK
import { Worker } from "@notionhq/workers";
const worker = new Worker();
worker.tool("lookupCustomer", {
title: "Lookup Customer",
description: "Find a customer by email address.", // いつ・何のために使うかをエージェントに伝える
schema: j.object({
email: j.email().describe("The customer's email address."),
}),
hints: { readOnlyHint: true }, // 読み取り専用などのヒント（任意）
// outputSchema: j.object({ ... }), // 返り値の検証スキーマ（任意）
execute: async ({ email }) => { /* ここで任意のAPIを呼ぶ */ },
});
export default worker;本記事前半で示したschema: /* JSON Schema */という簡略表記に対し、公式の正式な形はj.object()・j.email()といったjビルダーを使う点に注意してください。デプロイ後は、ツール単体をローカルで実行テストできます。
# ツールをローカルで動作テスト（-d でJSON入力を渡す）
ntn workers exec lookupCustomer --local -d '{"email":"ada@example.com"}'
# デプロイ（ビルド→アップロード→有効化）
ntn workers deploy
# デプロイ済みツールの実行（--local を外す）
ntn workers exec lookupCustomer -d '{"email":"ada@example.com"}'定義したツールは、Notion側でCustom Agentのツール設定画面から対象エージェントに追加することで、エージェントが必要に応じて呼び出すようになります。「自作ツールを生成・ライブデータ取得・任意のAPI接続に使える」のがこの機能の狙いです（Notion公式 Build with Notion’s Developer Platform）。自作ツールの設計思想や他フレームワークとの比較は、AIエージェントのツール設計・比較ガイドも参考になります。
Agent SDK — 外部アプリからNotionのエージェントを起動する（アルファ・ウェイトリスト）
もうひとつ、本記事前半では触れていない新しい入口がNotion Agent SDKです。2026年6月時点でアルファ版・ウェイトリスト制で、Notion公式の説明は「Notion Agent SDKを使えば、エージェントを自社の他のツールの中に組み込める（embed an agent inside your other tools）」というものです（2026年5月13日リリースノート）。
Agent Toolsが「Notion AI が あなたのコードを呼ぶ」方向なのに対し、Agent SDKは逆向きで、あなたのアプリ（CRM・社内ツール・コーディングエージェント等）からNotionのCustom Agentをプログラムで起動するための仕組みです。公式は「APIでrunをトリガーし、マルチターンのスレッドを維持し、レスポンスをリアルタイムにストリーミングできる」と説明しています（Notion公式 Build with Notion’s Developer Platform）。たとえば自社CRMから「この商談の要約をNotionのエージェントに作らせる」といった連携が想定されています。OpenAIなど他社のAgents SDKとの設計の違いを把握したい場合は、OpenAI Agents SDK実装ガイドと読み比べると理解が深まります。
機能ごとの提供ステータス早見表（2026年5月13日リリース時点）
「notion api 2026」「notion workers api」で評価検討している方向けに、各機能がすぐ本番で使えるか（GA）／検証向け（ベータ）／申請が必要か（アルファ）を、公式リリースノート（2026-05-13 リリース 3.5）に基づいて整理します。
| 機能 | 提供ステータス | 補足 |
|---|---|---|
| Notion API（REST） | 一般提供（GA） | PAT・共有コネクションで内部ツール構築 |
| Notion MCP | 一般提供（GA） | 最大約91%のトークン削減、Claude等が対応 |
| Notion CLI（ntn） | 一般提供（GA） | 全プランで利用可。Workers操作の必須ツール |
| Workers | ベータ | ベータ期間中は無料。2026年8月11日以降はクレジット課金へ移行 |
| Database Sync | ベータ | 外部レコードをNotion DBに継続的に同期 |
| Custom Agent Tools | ベータ | Workers上に自作ツールを定義しNotion AIに持たせる |
| Webhook Triggers | ベータ | 外部アプリからのWebhookを受信して処理を実行 |
| External Agents API | アルファ | Claude・Cursor等を@メンションで呼ぶ。ウェイトリスト |
| Agent SDK | アルファ（ウェイトリスト） | 外部アプリからNotionのエージェントを起動 |
要点は、API・MCP・CLIはすでに一般提供（GA）なので今日から使える一方、Workers系（Agent Tools含む）はベータ・External Agents APIとAgent SDKはアルファ（申請制）という点です。Workersはベータ期間中は無料ですが、2026年8月11日以降はNotionクレジットによる課金に切り替わるため、本番投入のコスト試算はこの日付を起点に見直すことをおすすめします（Notion公式リリースノート 2026-05-13）。
参考・出典
- May 13, 2026 – 3.5: Notion Developer Platform — Notion公式リリースノート（参照日: 2026-05-21）
- Notion just turned its workspace into a hub for AI agents — TechCrunch（参照日: 2026-05-21）
- Introducing Notion’s Developer Platform — Notion公式ブログ（参照日: 2026-05-21）
- Understand pricing for Workers (beta) — Notion Help Center（参照日: 2026-05-21）
- What are Notion Workers? – Notion Docs — Notion Developer Documentation（参照日: 2026-05-21）
- Notion Workers: Dev Day 2026 Complete Guide — Matthias Frank（参照日: 2026-05-21）
- Notion Launches Developer Platform For AI Workflows And Agents — Dataconomy（参照日: 2026-05-21）
まとめ：今日から始める3つのアクション
- 今日やること:
npm install -g @notionhq/cliでNotion CLIをインストールし、ntn loginで認証。ntn workers newでHello Worldプロジェクトを作り、ntn deployまで完走する - 今週中: 業務で最も手作業が多い外部データ連携を1つ選び（Zendesk・Jira・GitHub等）、Database SyncのWorkerを実装して毎時同期を設定する
- 今月中: External Agents APIのウェイトリスト（notion.com/product/dev）に登録し、Claude等の外部エージェントとのNotionワークスペース連携をチームに提案する
あわせて読みたい:
- AIエージェント構築完全ガイド
- MCPサーバーの脆弱性と防御7選
- AIエージェント コスト最適化の実践7手法
- Claude MCP入門：Model Context Protocolの基礎と実装
- MCP Streamable HTTP 完全実装ガイド2026
著者: 佐藤傑（さとう・すぐる）｜株式会社Uravation代表。X（@SuguruKun_ai）フォロワー10万人超。著書『AIエージェント仕事術』。
この記事を読んで導入イメージが固まってきた方へ
UravationではAIエージェント導入の研修・コンサルを行っています。Notion × AIエージェントの統合設計もご支援可能です。
