> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AIエージェントに企業ドキュメントに対する権限に応じた安全なアクセス権限を提供する

> AIエージェントに、Boxに保存されている企業ドキュメントへの安全なアクセス権限を提供します。Box MCPサーバーおよびBox APIは、認証されたユーザーまたはアプリケーションとして動作します。スコープ、コラボレーション、およびウォーターフォール型の権限が引き続き適用されます。

export const RelatedLinks = ({title, items = []}) => {
  const getBadgeClass = badge => {
    if (!badge) return "badge-default";
    const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
    return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
  };
  if (!items || items.length === 0) {
    return null;
  }
  return <div className="my-8">
      {}
      <h3 className="text-sm font-bold uppercase tracking-wider mb-4">{title}</h3>

      {}
      <div className="flex flex-col gap-3">
        {items.map((item, index) => <a key={index} href={item.href} className="py-2 px-3 rounded related_link hover:bg-[#f2f2f2] dark:hover:bg-[#111827] flex items-center gap-3 group no-underline hover:no-underline border-b-0">
            {}
            <span className={`px-2 py-1 rounded-full text-xs font-semibold uppercase tracking-wide flex-shrink-0 ${getBadgeClass(item.badge)}`}>
              {item.badge}
            </span>

            {}
            <span className="text-base">{item.label}</span>
          </a>)}
      </div>
    </div>;
};

export const Link = ({href, children, className, ...props}) => {
  const localizedHref = localizeLink(href);
  return <a href={localizedHref} className={className} {...props}>
      {children}
    </a>;
};

エージェントを認証済みのBox IDとして接続します。

エージェントがMCPをサポートしている場合は、ホスト型<Link href="/guides/box-mcp">Box MCPサーバー</Link> (`https://mcp.box.com`) を使用します。エージェントがコードを実行する場合は、Box API、SDK、または<Link href="/guides/cli">Box CLI</Link>を使用します。いずれの場合も、エージェントが参照できるのは、認証されたユーザーまたはアプリケーションがすでにアクセス権限を持っているファイルのみです。

どのようなエージェントプラットフォームをBoxに接続しても、ファイル権限を回避することは**ありません**。Boxはすべてのリクエストでコラボレーション、ウォーターフォール型のフォルダ権限、およびアプリケーションスコープを確認します。

## アクセス権限の仕組み

すべてのリクエストに以下の3つのレイヤーが適用されます。

| レイヤー | 制御対象 |
| - | - |
| **ID** | エージェントがエンドユーザー (OAuth) またはサービスアカウント/CCGアプリケーションのどちらとして動作するか。 |
| **スコープ** | 統合がリクエストできるアクション数の上限。スコープによって、IDが開けないファイルへのアクセス権限が付与されることはありません。 |
| **コンテンツの権限** | コラボレーション、ウォーターフォール型のフォルダ権限、共有リンク、Shield、および分類ポリシー。 |

MCPサーバーが他のユーザーになりすましたり、IDがすでに権限を持っていない限り企業内を検索したりすることはありません。<Link href="/guides/getting-started/why-box#does-the-box-mcp-server-bypass-box-permissions">Box MCPサーバーはBoxの権限を回避しますか?</Link> を参照してください。

## IDを選択する

<AccordionGroup>
  <Accordion title="エンドユーザーOAuth (MCPのデフォルト)">
    エージェントは、サインインしたBoxユーザーとして動作します。この方法は、そのユーザーのファイルを操作するアシスタントに使用します。たとえば、Copilot、Cursor、Claude、Foundry Toolsなどのクライアントが該当します。

    管理コンソールでMCPを有効にし、統合資格情報を作成したうえで、エージェントに必要なスコープのみをリクエストします。<Link href="/guides/box-mcp/setup">MCPサーバーの設定</Link>を参照してください。
  </Accordion>

  <Accordion title="サービスアカウントまたはCCG (自動化)">
    サーバー側ジョブ (アップロード時の抽出、Hubへの公開、スケジュール設定されたレビュー) では通常、<Link href="/guides/authentication/client-credentials">クライアント資格情報許可</Link>を利用するサービスアカウントとして認証します。

    そのサービスアカウントを特定のフォルダにコラボレータとして追加します。対話型エージェントに対して、サービスアカウントを隠れたスーパーユーザーとして利用しないでください。また、資格情報をブラウザや信頼できない実行環境に渡す場合は、トークンをダウンスコープします。<Link href="/guides/authentication/tokens/downscope">トークンのダウンスコープ</Link>を参照してください。
  </Accordion>
</AccordionGroup>

## 本番環境とローカルテスト

ツールを学習する段階では、<Link href="https://account.box.com/signup/developer">無料のDeveloperアカウント</Link>とサンプルファイルを利用します。<Link href="/tutorials/connect-an-agent-to-box">BoxとAIエージェントの接続</Link>チュートリアルでは、ローカルの設定について説明し、コーディングエージェントに本番環境のコンテンツへのアクセスを許可しないよう注意喚起しています。

本番環境の場合:

1. 管理者が管理コンソールでMCPを有効にします (またはPlatformアプリを承認します)。
2. 専用の統合資格情報を作成し、必要なスコープのみをリクエストします。
3. Boxユーザーまたはサービスアカウントを慎重に選択します。エージェントがアクセスする必要があるフォルダにコラボレータとして追加します。
4. そのIDでテストを実施します。検索や質問でファイルが表示されない場合は、モデルではなく、まずコラボレーションを確認してください。

## Microsoftのエージェントプラットフォーム

GitHub CopilotおよびMicrosoft Foundry Toolsは、MCPを介してBoxに接続します。権限モデルは以下のように他のクライアントと同じです。

* 接続を承認したBoxユーザーがIDとなります。
* 管理者が構成したスコープにより、クライアントがリクエストできるアクション数の上限が決まります。
* Boxファイルに対する権限がSharePointやGraphの権限に置き換えられることはありません。

設定手順については、<Link href="/guides/box-mcp/integrations/microsoft-foundry-tools">Microsoft Foundry Tools</Link>および<Link href="/guides/box-mcp/integrations/github-copilot">GitHub Copilot</Link>を参照してください。ツールのリストについては、<Link href="/guides/box-mcp/tools">利用可能なツール</Link>を参照してください。

## 関連パターン

* HubsとAskを利用して、厳選されたナレッジベースに対してクエリを実行する: <Link href="/guides/hubs-api/access-controlled-knowledge-base">アクセス制御されたAIナレッジベース</Link>
* ベクトルインデックスにエクスポートする前にまずBoxによって管理される取得を利用する: <Link href="/ai/rag">Boxに保存されている企業ドキュメントを対象としたRAGの構築</Link>

<RelatedLinks
  title="関連するガイド"
  items={[
{ label: translate("Box MCP server"), href: "/guides/box-mcp", badge: "GUIDE" },
{ label: translate("Set up the MCP server"), href: "/guides/box-mcp/setup", badge: "GUIDE" },
{ label: translate("Security overview"), href: "/guides/security", badge: "GUIDE" },
{ label: translate("Connect an AI agent to Box (lab)"), href: "/tutorials/connect-an-agent-to-box", badge: "TUTORIAL" }
]}
/>