Notion AIエージェント連携とは？Workers・API実装5ステップ

「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つのトリガーで起動します。

1. Sync（定期実行）: スケジュールに基づいて外部データをNotionに同期
2. Tool（エージェントツール）: Notion AIカスタムエージェントから呼び出されるカスタム関数
3. 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ステップです。

1. 外部エージェント（例: Claude Code）がOAuth 2.0フローを開始
2. メンバーがページピッカーでアクセス許可するページ/DBを選択
3. エージェントが@メンション可能なメンバーとして登録
4. 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月時点。）

よくある質問

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のシンプルさは活きます。

参考・出典

• 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つのアクション

1. 今日やること: npm install -g @notionhq/cliでNotion CLIをインストールし、ntn loginで認証。ntn workers newでHello Worldプロジェクトを作り、ntn deployまで完走する
2. 今週中: 業務で最も手作業が多い外部データ連携を1つ選び（Zendesk・Jira・GitHub等）、Database SyncのWorkerを実装して毎時同期を設定する
3. 今月中: External Agents APIのウェイトリスト（notion.com/product/dev）に登録し、Claude等の外部エージェントとのNotionワークスペース連携をチームに提案する

---

あわせて読みたい:

• AIエージェント構築完全ガイド
• MCPサーバーの脆弱性と防御7選
• AIエージェント コスト最適化の実践7手法

---

著者: 佐藤傑（さとう・すぐる）｜株式会社Uravation代表。X（@SuguruKun_ai）フォロワー10万人超。著書『AIエージェント仕事術』。