AI の領域 · コネクタ、取得の層

AI の取得の層、 システムの境界を越えて

どの判断でも、AI が見たものはコネクタの層を通って届きます。Microsoft Graph、SharePoint、MCP サーバー、スケジュールのサイドカー、受信メール、送信 webhook、OAuth の連携マネージャー。組織ごとに隔離され、AI によるツールの呼び出しはすべて、その入力、結果、背後にいる人とともに記録されます。

OAuth 2.1 + PAT による認証 組織ごとに隔離されたトークン Key Vault の資格情報

AI の判断の背後にある取得の層

Onplana の三つのゾーンからなる判断モデル(記事の全文 (英語)を参照)は、行動のゾーンで適用し、提案のゾーンで提案します。どの判断でも AI は文脈に基づいて推論しますが、その文脈のほとんどは Onplana のデータベースの中にはありません。コネクタは、それが届く道です。

アプリのアシスタントからでも、接続したエージェントからでも、AI によるツールの呼び出しはすべて、ツール、入力、結果、人、時刻とともに記録されます。組織のオーナーと管理者は、Enterprise プラン以上で、これらの記録を Audit Logs ページの Agent Activity で読めます。完全なプロンプトやモデルが取得した文脈は保存されないので、記録が示すのは AI が何をしたかであって、読んだものすべてではありません。

すべてのコネクタは同じ設計に従います。元のシステムが求めるところでは OAuth(Microsoft Graph、SharePoint、サードパーティのファイル クラウド)、プログラムから使うクライアントには PAT(MCP、REST API、webhook)、そして作成時からの組織ごとの隔離です。組織 A のトークンが組織 B を読み書きすることはできず、コネクタを通した AI によるツールの呼び出しはすべて記録されます。

今日使える七つのコネクタ

方向、認証、プラン、そしてそれぞれが何をするか。連携の一覧は顧客の要望に応じて増えます。重なりの多いベンダーが先です。

MCP サーバー

双方向すべてのプラン

Model Context Protocol で公開される Onplana のツールのカタログ。Claude Desktop、Cursor、Goose、Continue をはじめ、MCP に対応したあらゆるクライアントが接続して、型付きのツール 351 個(プロジェクトの読み取り、タスクの作成、作業時間の記録、リスクの確認、ガバナンスのレビューの実行)を使えます。アプリのチャットと同じ制約、同じ記録です。

認証:Dynamic Client Registration(RFC 7591)付きの OAuth 2.1、または Personal Access Token

Microsoft Graph(M365)

双方向すべてのプラン、ファイルのリンクは Professional+

メール(Mail.ReadWrite)、カレンダー(Calendars.ReadWrite)、Teams のチャネルへの投稿(ChannelMessage.Send)、ファイル(Files.ReadWrite)、ユーザー(User.Read)のための、ユーザーごとの Microsoft Graph への OAuth。AI の機能はこれを使って、会話を要約し、ステークホルダーとの会議を予定し、Teams のチャネルにステータスの更新を投稿し、SharePoint の文書をタスクに添付します。

認証:ユーザーごとの OAuth、トークンは lib/oauthTokens.ts で更新され、invalid_grant で revokedAt が設定される

SharePoint のサイト + ドキュメント ライブラリ

受信Professional+

その人がアクセスできる SharePoint のサイトを閲覧し、SharePoint の文書を Onplana にコピーせずにタスクやプロジェクトに添付します。リンク方式です(ファイルは SharePoint に残り、Onplana はリンクを保持します)。さらに、プロジェクトのワークスペースに文書のメタデータを表示します。

認証:Microsoft Graph のユーザーの OAuth のスコープを引き継ぐ

受信メールの webhook(プロジェクトのメールボックス)

受信すべてのプラン

どのプロジェクトにも受信用のメール アドレスがあります。メールを転送すると新しいタスクになり、件名がタイトルに、本文が説明になります。タスクのメールへの返信はそのタスクのコメントとして届き、一行目の状態の言葉でタスクを動かすこともできます。添付ファイルは保存されません。ステークホルダーからの依頼が、誰かが手で振り分けるのを待って受信箱に残ることはありません。

認証:/api/inbound-email の公開 webhook、受信用アドレスでプロジェクトに結び付けられる

スケジュールのサイドカー(.mpp / .xml / .xer のインポート)

受信すべてのプラン(公開ツール)

Microsoft Project のファイル(.mpp、.mpx、MSPDI の .xml、Primavera の .xer)をアップロードすると、MPXJ を使ったサイドカーがそれを Onplana のタスクのツリーに変換します:タスク、依存関係(FS/SS/FF/SF + ラグ)、カスタム フィールドとしての ExtendedAttributes、ベースライン + 計画コスト(MSPDI から)。その後、インポートしたスケジュールに対して AI によるリスク検出が実行されます。

認証:アプリ内でのアップロード(multer、上限 50 MB)、または /tools/schedule-health-check の無料の公開版

送信 webhook

送信Business+

プロジェクト、タスク、コメント、メンバー、移行のイベント(project.created、task.status_changed、comment.created、migration.completed など)。HMAC-SHA256 で署名されたペイロード、間隔を延ばしながらの再試行、エンドポイントごとの配信履歴。Onplana を Zapier、n8n、あなたの ETL パイプライン、インシデント対応の手順書につなげます。

認証:webhook ごとのシークレット、署名付きペイロードのヘッダー(X-Webhook-Signature)

OAuth の連携マネージャー

双方向Business+

サードパーティのサービス(Google Drive、OneDrive と SharePoint を含む Microsoft 365、Box、Dropbox)を接続するための組織の管理画面。トークンのライフサイクルは lib/oauthTokens.ts を通ります:期限切れで更新し、切断で取り消し、invalid_grant で無効と記録します。切断は軽い操作で(行は残り、トークンが空になる)、完全な削除ではありません。

認証:組織の権限(org.integration.manage、既定では ADMIN 以上)

Microsoft Planner:Planner はそのままに、ポートフォリオを加える

Business+

チームは Planner で働き続けます。その計画を一回の操作で Onplana のポートフォリオに結び付けると、各計画は Microsoft Graph のサブスクリプションが最新に保つプロジェクトになります。Planner で変更があると、Onplana が計画を読み直し、プロジェクトの進捗と日付を再計算します。

  • 計画ごとの状態を、Planner の日付と完了率から。日付のない計画は未評価として表示されます。
  • 異なる計画のタスク間の依存関係。ポートフォリオから選び、そのタイムラインに描かれます。
  • すべての計画の遅れているマイルストーン、危険のある依存関係、未解決の課題とリスク。各行はその項目にリンクしています。
  • 「連携」に、接続した計画が最後の同期、「今すぐ同期」、「接続を解除」とともに表示されます。タスクのフィールドの持ち主は Planner で、Onplana が Planner に書き戻すことはありません。

認証:接続する人の Microsoft の接続で、Tasks と Groups の権限を使います。変更の通知はそれぞれ、サブスクリプションごとに保管されたシークレットで検証されます。

Planner はそのままに。ポートフォリオを加える。

認証 + セキュリティ

すべてのコネクタで変わらない三つの要素。

Key Vault の資格情報

サードパーティ(Microsoft、Google、hCaptcha、Stripe など)向けの Onplana のクライアント シークレットは Azure Key Vault にあり、運用チームが別にローテーションします。各ユーザーの OAuth トークンは、OauthConnection の行に暗号化して保管されます。

組織ごとに隔離されたトークン

すべての PAT と OAuth トークンは、作成時から一つの組織に属します。organizationId はトークンの行に結び付いていて、リクエストのヘッダーから読まれることはないので、コネクタの呼び出しが組織の境界を越えることはできません。

AI の呼び出しごとに一件の記録

コネクタを通した AI によるツールの呼び出しは、それぞれ記録を書きます:ツール、入力、結果、人、時刻。送信 webhook は、リクエストとレスポンスの本文全体 + 所要時間を含む WebhookDelivery の行を加えます。受信メールは、ふだんのタスクとコメントの履歴を通ります。

コネクタがしないこと

この層についての正直な一覧。

あなたの名前でメールを送る

Outlook のメールは下書きのみです。AI があなたの受信箱に下書きを書き、あなたが確認して送信します。Teams のチャネルへの投稿には下書きがないので、ツールは明示的な確認なしには投稿せず、アプリのエージェントは投稿できません。送信 webhook は、あなたが購読したイベントで発火します。

組織の境界を越える

組織 A で作成した PAT や OAuth トークンは、組織 B のデータに届きません。複数の組織に属する人は、それぞれを別々に接続します。この制約はリクエストのヘッダーではなく、サーバー上のトークンの行で適用されます。

プランの制約を回避する

コネクタへのアクセスは組織のプランに従います。MCP サーバー、受信メール、そして Microsoft Graph のメール、カレンダー、Teams は無料プランを含むすべてのプラン、SharePoint と OneDrive のファイルのリンクはProfessional プラン以上、送信 webhook はBusiness プラン以上で使えます。制約はサーバーにあります。MCP のクライアントは認証できますが、プランを超える呼び出しは、上位のプランへの道筋とともに 402 を返します。

システムをまたいで自律的に複数の段階の仕事を実行する

コネクタは機能を公開し、アプリのチャットと外部のエージェントはそれを一回の呼び出しずつ使います。多くの呼び出しにわたって計画し実行する複数の段階のエージェントの流れは、エージェントの層のものです。

よくある質問

コネクタの資格情報はどのように保管されますか?

二つの層で保管されます。Onplana 自身のシークレット(Anthropic の API キー、Azure OpenAI のエンドポイント、サードパーティの OAuth のクライアント シークレット、SMTP の資格情報、hCaptcha、Stripe など)は Azure Key Vault にあり、運用チームが別にローテーションします。各ユーザーの OAuth トークン(Microsoft Graph のアクセス トークンとリフレッシュ トークン)は、組織の印が付いた OauthConnection の行に暗号化して保管され、期限が切れると自動で更新されます。切断は軽い取り消しです。行は残り、トークンが空になります。

コネクタがテナントの境界を越えることはありますか?

いいえ。コネクタの呼び出しはすべて一つの組織に結び付いています。アプリからの呼び出しは REST API と同じ withOrganization のミドルウェアを通るので、どのクエリにも organizationId が付きます。PAT や OAuth トークンは作成時から一つの組織に属するので、接続したエージェントの呼び出しは組織をトークンから取り、リクエストのヘッダーから取ることは決してありません。複数の組織に属する人は、それぞれを別々に接続します。

コネクタの呼び出しの記録には何が含まれますか?

コネクタを通した AI によるツールの呼び出しは、それぞれツール、入力、結果、人、時刻とともに記録され、Audit Logs ページの Agent Activity で読めます。送信 webhook はさらに、リクエストとレスポンスの本文全体と所要時間を含めて WebhookDelivery に書き込みます。受信メールは、ふだんのタスクとコメントの履歴を通して書き込みます。確認する人は、追加の接続なしに記録を読めます。

MCP サーバーは REST API とどう違いますか?

機能は同じで、プロトコルが違います。MCP サーバーは Streamable HTTP(MCP の転送の標準)を話し、MCP の tools/list の呼び出しに型付きのツールのカタログで応えるので、MCP に対応したエージェントのクライアントは Onplana の操作を自分で見つけられます。REST API は HTTP+JSON を話し、/api/openapi.json で文書化されています。Claude Desktop や Cursor のセッションからは MCP を、バックエンドのスクリプトからは REST を使ってください。どちらも同じハンドラーを、同じ制約、同じ記録で呼び出します。

新しいコネクタを Onplana に加えるよう依頼できますか?

今のところ、コネクタの一覧は上のとおりです。連携マネージャー + OAuth の更新は再利用できます。ボトルネックは、ベンダーごとの OAuth の設定 + ツールの定義です。Onplana のチームは連携の依頼を hi@onplana.com で受け付けています。顧客の重なりが多いベンダー(たとえば Atlassian、ServiceNow、Salesforce)が優先されます。

なぜスケジュールのサイドカーがコネクタに含まれるのですか?

外部のファイル形式を読むために、Onplana のデータ モデルの「外」に出るからです。Java の MPXJ のサイドカー(別のコンテナー アプリ)が .mpp / .xml / .xer を読み、読み取った構造を HTTP で返し、Onplana のインポートのパイプラインがそれをプロジェクトのツリーに書き込みます。SharePoint との連携がドキュメント クラウドの世界へのコネクタであるのと同じように、これは Microsoft Project のファイルの世界へのコネクタです。

ご自分の組織でコネクタを見る

無料で登録し、二分で Microsoft Graph を接続するか .mpp ファイルをアップロードして、AI の機能があなたのツールから文脈を運び始めるのをご覧ください。