MCP（Model Context Protocol）は、AIアプリケーションが共通のプロトコルによって外部のツールやデータソースに接続できるようにするオープン規格です。 Revizto MCPサーバーを使用すると、AIツールをReviztoプロジェクトのデータに安全に接続できます。 接続した後は、AIアシスタントに直接質問して、プロジェクトに関するインサイトを入手したり、ガイドに沿ってアクションを実行したりできます。

• 要件
• 接続パラメーター
• Revizto MCPサーバーURL
• MCP接続の設定
• 制限事項
• ベストプラクティス
• トラブルシューティング

関連項目：

• Revizto開発者ポータル

要件

Revizto MCPサーバーに接続する前に、次の項目が揃っていることを確認してください。

• プロジェクトデータが保存されているReviztoリージョンへのアクセス。
• リモートMCPサーバーに接続できる、サポート対象のAIツールへのアクセス。
• リージョンに対応するRevizto MCPサーバーURL。

また、Revizto MCPサーバーをAIツールに追加する前に、組織アカウントでRevizto MCPサーバーアプリが有効化されていることを確認する必要があります。 Revizto MCPサーバーアプリがご利用のアカウントでアクティブかどうかを確認するには、以下の手順に従います。

• アカウント所有者と管理者：［アカウント情報を管理］>［開発者ポータル］に移動します。
• 標準ユーザー：［アカウント情報］>［アプリのインテグレーション］に移動します。

Revizto MCPサーバーアプリがアクティブでない場合は、アカウント所有者または管理者にアクティブ化を依頼してください。 アカウント所有者と管理者は、Revizto開発者ポータルの手順に従い、開発者ポータルからRevizto MCP Serverアプリを有効化できます。

Reviztoデータの安全性を確保するため、常に所属組織の内部セキュリティポリシーに従ってください。

• Revizto MCPサーバーに接続する際は、信頼できるAIツールのみを使用してください。
• リージョンに対応する正しいRevizto MCPサーバーURLを使用してください。
• 書き込みアクションは、必ずレビューを経て実行するようにしてください。 計画された変更内容を適用の前に表示するよう、AIアシスタントに依頼してください。
• Revizto MCPサーバーは、ユーザーのReviztoアクセス権を使用します。 管理アクションを実行するには、管理者レベルのReviztoアクセス権が必要です。
• 所属組織のAI利用ポリシーに従ってください。 Reviztoのデータを接続する前に、どのAIツールが承認されているかを確認してください。

接続パラメーター

Revizto MCPサーバーは、Streamable HTTPを使用して接続します。 フィールド名はAIプラットフォームによって異なる場合がありますが、主要な接続要件は同じです。 また、クラウドベースのAIツールの中には、MCPサーバーを「カスタムコネクタ」として設定するものがあります。 認証プロセスを円滑にするため、Revizto MCPサーバーはOAuthクライアントIDを使用します。 

接続を設定する際は、次の表のパラメーター値を参照してください。 

構成ファイルでは、リージョンに対応するURLを含む次のような標準のStreamable HTTP構成を使用してください。

{
  "mcpServers": {
    "<サーバー名>": {
      "type": "http",
      "url": "https://api.<サーバーリージョン>.revizto.com/mcp",
      "oauth": {
        "clientID": "revizto-mcp"
      }
    }
  }
}

Revizto MCPサーバーURL

AIツールをRevizto MCPサーバーに接続する際は、Reviztoのデータがホストされているリージョンに対応するMCPサーバーURLを使用する必要があります。

複数のリージョンでホストされているReviztoアカウントでは、複数のRevizto MCPサーバーを同じAIツールに追加できます。 利用する各リージョンに対応するMCPサーバーURLを追加し、それぞれの接続を認可してください。 その後、接続済みの複数リージョンを横断する形で、イシュー数の比較、プロジェクトのリスクの要約、リージョン横断の調整ブリーフの作成などを行うよう、AIアシスタントに依頼できます。

これにより、AIツールは、接続された複数の承認済みリージョンのデータを同じ会話内で結合できます。 Reviztoのデータは元のリージョンに留まり、アシスタントはReviztoユーザーにアクセスが許可されているアカウント、ライセンス、プロジェクトにのみアクセスできます。

MCP接続の設定

Revizto MCPサーバーは、HTTPSを使用するリモートMCPサーバーです。 トランスポートのタイプを尋ねられるツールでは、Streamable HTTPまたはリモートMCPサーバーを選択してください。

設定手順はツールによって異なりますが、一般的なプロセスは次のとおりです。

1. ツールの設定を開きます。
2. 設定で、コネクタ、アプリ、MCP、ツール、インテグレーションといった項目を見つけます。
3. 新しいカスタムコネクタ、カスタムアプリ、またはMCPサーバーを追加します。
4. URLの設定を見つけ、リージョンに対応するRevizto MCPサーバーURLを入力します。
5. OAuthクライアントIDのフィールドを見つけ、Revizto MCPクライアントIDを入力します。
6. OAuthクライアント シークレットは空欄のままにします。
7. 接続を保存します。
8. 認証を求められたら、Reviztoアカウントにサインインします。
9. 利用可能なReviztoのツールを一覧表示するか、接続を確認するよう、AIアシスタントに依頼します。

AIツールによっては、MCPサーバーを追加した直後、またはReviztoのデータを必要とする最初のプロンプトの入力後に、Reviztoアカウントへのサインインを求められる場合があります。 AIツールが認証プロセスを開始すると、Reviztoのサインインウィンドウが開きます。 利用するReviztoアカウントで要求されている認証方法（メールアドレスとパスワード、またはSSOなど）を使用してサインインします。

認可の後、AIツールは認証済みのReviztoユーザーに限定されたアクセス権を受け取ります。 つまり、AIツールはアカウント、ライセンス、プロジェクトでそのユーザーに付与されたアクセス権に従い、そのユーザーに許可されたデータとアクションのみが機能します。

以下では、一般的なAIツール向けの追加設定について説明します。

{
  "servers": {
    "<サーバー名>": {
      "type": "http",
      "url": "https://api.<サーバーリージョン>.revizto.com/mcp",
      "oauth": {
        "clientId": "Revizto MCP"
      }
    }
  }
}

設定が正しく機能したことを確認するには、次のプロンプトを使用します。 

Revizto MCPの接続を確認してください。 あなたがアクセスできるReviztoアカウントとリージョンを教えてください。それから、利用可能なReviztoのツールを一覧表示してください。平易な言葉でお願いします。

AIアシスタントが「Reviztoにアクセスできません」と言う場合は、次の点を確認してください。

• Revizto MCP Serverがアカウントで有効である。 標準アカウントのメンバーがアプリのインテグレーションを確認できる。 アカウント所有者とアカウント管理者が開発者ポータルを確認できる。
• リージョンに対応する正しいURLを使用している。
• ReviztoのOAuthサインインを完了済みである。
• 使用しているAIツールがリモートMCPサーバーに対応している。
• 使用しているReviztoユーザーに、該当のアカウント、ライセンス、プロジェクトへのアクセス権がある。

制限事項

Revizto MCPサーバーは多くのコーディネーションワークフローに対応していますが、留意すべき制限がいくつかあります。

• モデルとオブジェクトのプロパティ（オブジェクト検索、変更済み要素、オブジェクト プロパティの読み取り、イシューからオブジェクトへの推論を含む）は、MCP経由では公開されません。 （近日対応予定）
• スクリーンショットや画像は、MCP経由では公開されません。
• イベントサブスクリプションやWebhookは、MCP経由では公開されません。
• プロジェクト、ライセンス、アカウントのログは、MCP経由では公開されません。
• モデルのインポートとエクスポートは、MCP経由では公開されません。
• 大規模なプロジェクトでは、AIの応答が遅くなったり高コストになったりしないよう、慎重なフィルタリングが必要となる場合があります。
• AIツールによっては、同時に使用できるMCPツールの数に制限があります。 目的のツールが表示されない場合は、AIツールで未使用のMCPサーバーや未使用のツールを無効にしてください。

ベスト プラクティス

Revizto MCPサーバーが設定された後、AIアシスタントはReviztoのツールを使用して、イシュー、コメント、干渉、シート、レポート、ワークフロー、スタンプ テンプレート、ライセンス、プロジェクト、ユーザーなどのコーディネーションデータを読み取ることができます。 ユーザーのアクセス権と最終的なリリース設定によっては、アシスタントが特定の更新の準備や適用を支援できる場合もあります。

Revizto MCPは、次の3種類のワークフローで役立ちます。

大規模なプロジェクトには大量のデータが含まれる場合があります。 対象を絞ったプロンプトから始め、続けてフォローアップの質問を行ってください。 これにより、トークンの使用量に応じて課金されるAIツールで、回答をより高速・明確かつ低コストに保てます。

より良い結果を得るためのヒントを紹介します。

• いずれかのプロジェクト、業種、ゾーン、または担当者を選んで始めてください。
• 長い一覧を求める場合は、事前に件数を尋ねて要約を依頼してください。
• 使用したフィルターを示すようアシスタントに依頼してください。
• まず上位10件の例を尋ね、必要に応じて数を増やしてください。
• 書き込みアクションでは、「変更を適用する前に承認を待ってください」という言葉をプロンプトに含めてください。
• 大規模なプロジェクトでは、すべてのイシュー、コメント、干渉、シートを一度に求めるプロンプトは避けてください。
• 意外に思える結果が表示された場合は、使用したソースレコードを示すようアシスタントに依頼してください。

開始するには、次の推奨プロンプトをお試しください。 

• <プロジェクト名>には描画シートが何枚ありますか？
• <プロジェクト名>には、深刻かつ未完了のイシューはいくつありますか？
• <ユーザーa>の未完了のイシューを<ユーザーb>に再割り当てし、<プロジェクト名>で、コメントに「<ユーザーa>によって再割り当て」と記載してください。 
• <プロジェクト名>で、30日以上前に作成された<ユーザーa>の解決済みイシューを終了してください。
• <プロジェクト名>で、<ユーザーa>の未完了のイシューに、期限として来週の金曜日を設定してください。
• <プロジェクト名>で、<ユーザーa>の未完了のイシューを「進行中」に変更してください。 
• <プロジェクト名>で、<ユーザーa>の未完了の配管と構造体イシューを「深刻」に設定してください。

トラブルシューティング

Q：AIツールがRevizto MCPサーバーに接続できません。 

A： リージョンに対応する正しいURLを使用していることと、AIツールがリモートMCPサーバーに対応していることを確認してください。 

Q：異なるSSO認証方法を使用する複数のReviztoアカウントがありますが、MCPサーバーが一部のアカウントに接続しませんでした。 そのようなアカウントはどのように認証すればよいですか？

A：Revizto MCPサーバーは、直近の認可フローで使用した認証方法でのみアカウントにアクセスできます。 異なる認証方法を使用するアカウントを承認するには、Revizto Workspaceのプロフィールに移動し、［アクティブなセッション］>［API］から必要なアカウントを許可してください。

Q：AIツールから、再びサインインするように求められます。 

A：Reviztoのサインインプロセスを完了してください。 複数のReviztoアカウントで異なるSSO認証方法を使用している場合は、Revizto Workspace のプロフィールで、［アクティブなセッション］>［API］ から必要なアカウントを承認してください。

Q：AIアシスタントがプロジェクトにアクセスできません。

A：Revizto MCP Serverアプリがあなたのアカウントで有効であること、プロジェクトに対して正しいリージョンにサインインしていること、認証済みのReviztoユーザーにそのプロジェクトへのアクセス権があることを確認してください。 Revizto MCP Serverの有効化が必要な場合は、AIツールで再認証し、MCP経由でアカウントにアクセスできることを確認してください。 

Q：一部のツールが利用できません。

A：AIツール側で有効なツールの数が制限されているか、Reviztoでそのツールを使用するための適切な権限をユーザーが持っていない可能性があります。 

Q：書き込みアクションが失敗しました。 

A：書き込み先のアカウント、ライセンス、プロジェクトに対するそのアクションがReviztoでの役割によって許可されていることを確認してください。 

Q：応答が遅い、またはコストが高すぎます。 

A：プロジェクト、日付、ステータス、担当者、ゾーン、または優先度件数の上限などを指定して、プロンプトの対象を絞り込んでください。 詳しいヒントについては、ベストプラクティスを参照してください。