カスタムエージェント向けのMCP接続

このヘルプドキュメント内

MCPを使用して、カスタムエージェントを外部システムやデータソースに接続する📶

MCP（Model Context Protocol）コネクションを使用すると、カスタムエージェントを外部アプリに安全にコネクトできます。MCPコネクションにより、エージェントはLinear、Ramp、Figmaなどのアプリとの事前設定済みのコネクションを使用して情報を読み取ったり、アクションを実行したりできます。また、カスタムMCPコネクションをセットアップすることで、あらゆるアプリにコネクトすることも可能です。

備考：MCP接続は、ビジネスプランとエンタープライズプランでのみ利用できる機能です。

MCP接続とは？

MCPコネクションを使用すると、カスタムエージェントはModel Context Protocolを介して外部ツールやサービスとやり取りできます。MCPツールは、スケジュール実行、NotionやSlackのイベントに基づくトリガー実行、チャットや@メンションからの手動実行など、すべてのトリガータイプで機能します。

主な機能：

設定済みサーバー：追加の設定を行うことなく、主要なアプリへすばやく接続できます。
カスタムサーバー：公開URLを使用し、ホストされているMCPサーバーに対応したあらゆるツールに接続できます。
カスタマイズ：各コネクションで使用するツールは、個別にオン/オフを切り替えることができます。また、実行前に確認を求めるか、自動で実行するか、サーバーからのすべてのツールを常に許可するかを選択できます。

個別の所有権

各MCPコネクションは単一のカスタムエージェント固有のものであり、認証を行ったユーザーの資格情報を使用します。コネクションは、同じサービスにコネクトする場合でも、エージェント間で共有されることはありません。

例を使って説明します。

エージェントAのためにFigmaコネクションをセットアップした場合、エージェントBには別のFigmaコネクションをセットアップする必要があります。
設定するエージェントごとに、それぞれのMCPサーバーにログインする必要があります。
1つのエージェントの接続を取り消しても、他のエージェントの接続には影響しません。

そのまま利用できる設定済みのMCP接続

以下のアプリには、追加の設定を行わなくても、そのまま接続できます。

事前設定されたMCP接続を追加する方法

カスタムエージェントの設定を開きます。
ツールとアクセスに移動します。
コネクションを追加 → 追加をクリックします。
事前設定されたサーバーを選択します。
認証プロンプトに従ってアカウントを接続します。
サーバーからエージェントが使用するツールを選択します。これらは選択したサーバーによって異なります。
接続 をクリックします。

カスタムMCP接続を追加する方法

事前設定済みのリストにないMCPサーバーにコネクトするには、ワークスペース管理者が最初にこのオプションをオンにする必要があります。カスタムMCPサーバーを許可する設定と、メンバーが任意のコネクションをインストールできるか、管理者が承認したもののみをインストールできるかを決定する設定の2つがあります。

カスタムMCPサーバーを許可するには：

ワークスペース管理者として、設定 → コネクションに移動します。
管理タブで、カスタムMCPサーバーを有効にするをオンにトグルします。

メンバーが任意のコネクションをインストールできるようにするか、管理者が承認したコネクションのみをインストールできるようにするかを選択するには：

ワークスペース管理者として、設定 → コネクションに移動します。
管理タブで、権限管理セクションを探します。
メンバーがインストールできるコネクションを制限するの横で、いずれかを選択します：
- 承認済みおよび推奨：Notionが推奨するすべてのコネクションを自動的に承認します。
- 承認済みのみ：メンバーがインストールできるコネクションをそれぞれ手動で選択します。
承認済みのコネクションを選択して、メンバーがインストールできるものを確認します。
承認済みのコネクションを追加を選択し、許可するものを選択します：
- コネクション：名前またはIDでコネクションを検索し、承認済みリストに追加します。
- カスタムMCPサーバー：許可する特定のカスタムMCPサーバーのURLを追加します。
保存 をクリックします。

これが設定されると、ワークスペース内の誰でも、カスタムエージェントをセットアップする際に承認済みのオプションにコネクションできるようになります。各自の認証情報で認証します。

カスタムエージェントにカスタムMCPを追加するには：

カスタムエージェントの設定を開きます。
ツールとアクセスに移動します。
コネクションを追加 → カスタムMCPサーバーをクリックします。
コネクション先のツールまたはプロバイダーからMCPサーバーのURLを入力する必要があります（例: 社内のツールチームのURL）。
コネクションの表示名を入力します（任意）。
必要な認証情報があれば、入力してください。
接続 をクリックします。

カスタムMCP接続の認証

カスタムMCPサーバーは、次のサインイン方法のいずれかまたは両方に対応する場合があります。

OAuth
ヘッダーベースの認証
（たとえば、APIキーまたはベアラートークン）

一部のOAuthサーバーは動的クライアント登録（DCR）をサポートしていません。これは、OAuthサインインが機能する前に、Notionがサードパーティサービスにクライアントアプリケーションを事前登録する必要があることを意味します。使用したいサーバーがDCRをサポートしていない場合は、そのドキュメントを確認して、代わりにAPIキーまたはベアラートークンを使用できるかどうかを確認してください。どちらのオプションも利用できない場合、そのMCPサーバーをカスタムエージェントで使用することはできません。

利用可能なツールの管理

エージェントの設定にあるツールとアクセスから、カスタムエージェントがMCP接続をどのように使用するかを決定できます。MCP接続のエントリを展開して、利用可能なツールを確認し、その実行方法を決定します。ツールは、隣接するトグルを使用して有効または無効にできます。

読み取り用ツールと書き込み用ツール

読み取り用ツール（例: 検索、取得、リストアップ、表示）を使用すると、カスタムエージェントは外部システムに変更を加えることなく、情報を取得したり、表示したりできます。
書き込みツール（例: 作成、更新、削除、送信、投稿）は、外部システムのデータを変更します。デフォルトでは、これらのツールはエージェントがアクションを実行する前に確認を必要とします。

自動的に実行または必ず確認

自動実行は、ユーザーの確認を必要とせずにツールを実行できるようにします。この設定は、データを変更しない読み取りツール（検索、取得、一覧表示、表示）に最適です。
常に確認は、アクションが実行される前に、ユーザーがそのアクションを承認またはキャンセルすることを要求します。これは、意図しない変更を防ぐために、書き込みツール（作成、更新、削除、送信）のデフォルト設定となっています。
常に許可は、サーバーからのすべてのツールを永続的に承認し、今後の確認プロンプトを削除します。

MCP接続を削除する方法

エージェントの設定を開きます。
ツールとアクセスに移動します。
対象のMCP接続を見つけて、接続を解除するをクリックします。
接続を解除するをクリックして確定します。
変更を加えた後は、必ずエージェントをテストしてください。いつでも再認証することで再接続できます。

備考: コネクションを削除すると、エージェントはそのサービスにアクセスできなくなり、そのサーバーに依存するスケジュールされた実行が失敗する可能性があります。接続を解除するとすぐに、エージェントのワークフローが中断される場合があります。いつでも再認証することで再接続できます。

MCP接続における権限とセキュリティ

MCPコネクションは、カスタムエージェントに設定されたユーザー権限レベルに従います。各権限レベルでMCPコネクションツールを使用して実行できる操作は以下の通りです。

フルアクセス権限と編集権限

カスタムエージェントへのフルアクセスおよび編集権限を持つユーザーは、以下の操作を行えます。

カスタムエージェントに新しいMCPコネクションを追加する。
エージェントとのチャットおよび連携済みのすべてのツールを利用できます。たとえ、エージェントを介さない、直接的なアクセス権限をそのツールに対して持っていない場合も利用可能です。
エージェントのアクティビティログとMCPツールの使用状況を表示する。
既存のMCPコネクションを削除する。
再接続するまたはMCPサーバーの認証情報を更新する。

また、設定済みのMCPコネクションについて、フルアクセスおよび編集権限を持つユーザーは以下のことを行えます。

有効化または無効化するツールを設定したり、ツールの実行設定を変更したりする（自動的に実行 vs. 必ず確認）

備考: MCPコネクションが確立されると、他のユーザーがカスタムエージェントへのフルアクセスや編集権限を持っていても、そのMCPコネクションを認証した本人のみがツール設定の構成や更新を行えます。エージェントは、外部サービスにアクセスする際、その本人の認証情報と権限を使用します。

閲覧可能と限定操作

カスタムエージェントに対して閲覧可能と限定操作権限を持つユーザーは、以下の操作を行えます。

カスタムエージェントとのチャットおよび連携済みのすべてのツールを利用できます。たとえ、カスタムエージェントを介さない、直接的なアクセス権限をそのツールに対して持っていない場合も利用可能です。
エージェントを介して読み取りアクションと書き込みアクションの両方をトリガーすることができます。
確認が必要な場合、書き込みアクションを承認またはキャンセルします。
接続されているMCPサーバーを（カスタムエージェント設定で）確認する

閲覧権と限定操作権限を持つユーザーは、以下の操作を行えません。

MCPコネクションを追加または削除する。
有効にするツールを変更する
ツールの実行設定を変更する
エージェントの完全なアクティビティログを表示する

備考: 書き込みアクション（アイテムの作成や更新など）は、意図しない変更を防ぐため、/デフォルトで確認が必要です。ユーザーには、エージェントが実行するアクションの内容が、実行前にプロンプトで正確に表示されます。

カスタムエージェントのMCP接続のトラブルシューティングを行う

接続したツールが表示されない場合は、以下のことを行ってください。

エージェントの設定ページを再度読み込む。
MCPサーバーが正常に認証されていることを確認する（緑色のチェックマークが付いている、またはステータスが「接続済み」になっている）。
サーバーがインターネットに接続されており、ツールのメタデータを返していることを確認する。
サーバーと再接続するか、一旦接続を解除してから、もう一度追加する。

カスタムエージェントの実行がMCPエラーで失敗した場合は、以下のことを行ってください。

アクティビティ タブを開き、エラーメッセージがないか確認する。
接続がまだ有効であることを確認する（トークンの有効期限が切れている可能性あり）。
エージェントの設定で接続が有効になっていることを確認する。
MCPサーバーに再接続して、認証情報を再度読み込む。
カスタムエージェントの指示を更新し、使用するサーバーまたはツール名を記載してください。例：「Linear MCPを使用して、このモックのメタデータを取得してください。」

よくあるご質問（FAQ）

MCP接続を複数のエージェントで共有できますか？

いいえ。各カスタムエージェントには、各MCPサーバーへの独自のコネクションが必要です。これにより、セキュリティモデルがシンプルに保たれ、各エージェントが適切なアクセス制御を持つことが保証されます。

同じサービスに複数のアカウントを接続できますか？

単一のエージェント内では実現できません。複数のアカウントを使用する必要がある場合は、それぞれに独自のコネクションを持つ個別のカスタムエージェントを作成する必要があります。

MCPサーバーがダウンしている場合や到達できない場合はどうなりますか？

MCPサーバーが利用できない場合：

エージェントは実行ログにエラーを報告します。
そのサーバーのツールは失敗しますが、エージェント全体がクラッシュすることはありません。
「アクティビティ 」タブを開き、エラーメッセージがないか確認する。

MCPサーバーとネイティブNotionインテグレーションの違いは何ですか？

ネイティブ統合（Slackなど）はNotionに直接組み込まれており、最初にワークスペースのオーナーによる承認が必要です。これらは読み取りおよび書き込みアクセス権に加え、トリガー機能を提供します。

MCPサーバーはオープンプロトコルに従っており、ワークスペースのメンバーであれば誰でも追加できます。これらは読み取りおよび書き込みアクセス権を持ちますが、トリガー機能はありません。

どちらもカスタムエージェントと連携しますが、MCP サーバーはカスタムツールやサービスとの接続においてより柔軟性があります。