DigitalBase Docs

MCP

MCP（Model Context Protocol）サーバー。Microsoft Copilot Studio・Claude Desktop・Cursor などの外部 MCP クライアントから、社内ツール（ファイル・データ・RAG・コード実行）をデータを外に出さずに呼び出す。

対象:開発者 / 管理者

エンドポイント

項目値
URLPOST /mcp
トランスポートStreamable HTTP（JSON-RPC 2.0）
認証Authorization: Bearer <API_KEY> または x-api-key: <API_KEY>（APIアクセスキー）。Entra ID の OAuth アクセストークンも可（下記）
対応メソッドinitialize / ping / tools/list / tools/call / resources/list / resources/read / prompts/list / prompts/get
  • resources: キーに紐づくアシスタントで選んだナレッジの文書を読み取り専用で公開する。本文は取り込んだテキストで、原本ファイルは出さない。
  • prompts: アシスタントで選んだプロンプト（プロンプトライブラリ）を公開する。
  • sampling は非対応。

Entra ID（OAuth）で認証する

API キーの代わりに、Entra ID で発行したアクセストークンで接続できる。.env に次を設定する（環境変数）。

  • MCP_OAUTH_AUDIENCE: MCP 用に登録した API のアプリケーション ID URI かクライアント ID
  • MCP_OAUTH_TENANT_ID: 空なら OIDC_TENANT_ID
  • MCP_OAUTH_ASSISTANT_ID: 適用するアシスタント
  • MCP_OAUTH_SCOPES: 任意

トークンの利用者は DigitalBase の有効なユーザーである必要がある。いなければ 403。

公開されるツール

チャットのツールと同一。キーに紐づくアシスタントのスコープで選んだ分（個人フォルダは既定で含む）を、ツール権限上限で絞り込む。

分類できること
ファイル選んだフォルダのファイルの一覧・読み取り・作成・編集・検索、シェル
データセットデータセットの一覧・列の確認・SQL での参照
SQL 接続「LLMからの使用を許可」した保存済み DB への読み取り専用 SQL
ナレッジ（RAG）ナレッジの一覧・ベクトル検索
API 接続保存済みの API 接続の呼び出し
フロー実行ワークフローの実行と実行結果の確認
画像・動画生成管理者が設定したエンジンでの画像・動画の生成
コード実行Python の実行
カスタム MCPアシスタントで選んだカスタム MCP（外部接続で作る Python の tool 群）の tool
  • アシスタントを紐づけていないキーではツールなし。
  • キーに file_root があれば、個人フォルダはその中だけで、シェルは出さない。
  • 実際に提示されるツール名は GET /v1/tools（OpenAI 互換 API）で確認できる。

接続例

MCP クライアントの設定例。

{
  "mcpServers": {
    "digitalbase": {
      "url": "https://<HOST>/mcp",
      "headers": { "Authorization": "Bearer <API_KEY>" }
    }
  }
}
注意

stdio 経由の MCP のみ対応のクライアントは、HTTP-MCP ブリッジを介して接続する。

Microsoft Copilot Studio から接続する

Copilot Studio のエージェントに登録し、Teams / Microsoft 365 Copilot から社内データを検索する。

  1. APIアクセスキーを発行する。公開範囲とツール権限上限はキー側で設定する。
  2. Copilot Studio でエージェントを開く。
  3. [ツール] ＞ [ツールを追加する] ＞ [新規追加] ＞ [MCP] を選ぶ。
  4. 次を入力して作成する。
    • サーバー名・サーバーの記述
    • サーバー URL: https://<HOST>/mcp
    • 認証: [API キー] ／ タイプ: [ヘッダー] ／ ヘッダー名: x-api-key
  5. 接続の作成を求められたら、発行した API キーを貼り付ける。 → 接続が緑のチェックになる。
  6. [追加] でエージェントにツールを追加する。
  7. テストパネルで確認する。
  8. エージェントを公開する。
  9. [チャネル] ＞ [Microsoft 365 と Microsoft Teams] で配布する。
補足

Copilot Studio はクラウドから接続するため、/mcp に社外から HTTPS（DNS 名と正規の証明書）で到達できる必要がある。ネットワーク

関連