MCP サービス / MCP 関数

バージョン 7.5.0 で追加

「MCP 関数」は、AI Agent による Func 内の関数呼び出しをサポートする DataFlux Func の機能です。

ユーザーは、MCP サービスを介して、DataFlux Func 内の一部の関数を AI Agent に提供できます。

1. 接続手順

次の手順に従って、MCP クライアント / AI Agent を DataFlux Func の MCP サービスに接続できます。

1.1 Access Token の作成

DataFlux Func の MCP サービスにアクセスするには、Access Token を作成し、「MCP 関数」機能を有効にする必要があります。

また、ルール内で公開する関数を指定できます（例：category フィールドの値による指定）。

1.2 権限ルール

権限ルールは手動で編集でき、上から下へ順に照合され、最初に一致したルールに基づいて権限が決定されます。

以下に例を示します。

ルール（完全一致 ID）	呼び出し許可
category:math	category が math の関数
scriptSet:mytest	スクリプトセット mytest に属する関数
script:mytest__demo	スクリプト mytest__demo に属する関数
func:mytest__demo.func	ID が mytest__demo.func の関数

ルール（ワイルドカード ID）	呼び出し許可
scriptSet:myte*	スクリプトセット ID が myte* にワイルドカード一致する関数
script:mytest__de*	スクリプト ID が mytest__de* にワイルドカード一致する関数
func:mytest__demo.fu*	関数 ID が mytest__demo.fu* にワイルドカード一致する関数

ルール（禁止）	呼び出し禁止
!category:math	category が math の関数

1.3 MCP クライアントの設定

DataFlux Func の MCP サービスは MCP 仕様に準拠しています

実際の接続前に、MCP Inspector を使用したデバッグを推奨します。

MCP クライアント / AI Agent に以下の設定を追加します。

設定項目	値
URL アドレス	{DataFlux Func アクセスアドレス}/mcp または /mcp2、/mcp3 具体的な違いは下記「MCP サービスモード」を参照
リクエストヘッダー	X-Dff-Access-Token: atk-xxxxx:xxxxx

OpenCodeCodexClaude Code汎用 JSON

{
  "mcp": {
    "dataflux-func-mcp": {
      "enabled": true,
      "type"   : "remote",
      "url"    : "{DataFlux Func アクセスアドレス}/mcp",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}

[mcp_servers.dataflux-func-mcp]
enabled      = true
url          = "{DataFlux Func アクセスアドレス}/mcp"
http_headers = { "X-Dff-Access-Token" = "atk-xxxxx:xxxxx" }

{
  "mcpServers": {
    "dataflux-func-mcp": {
      "type": "http",
      "url": "{DataFlux Func アクセスアドレス}/mcp",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}

{
  "mcpServers": {
    "dataflux-func-mcp": {
      "url": "{DataFlux Func アクセスアドレス}/mcp",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}

設定変更後は AI Agent を再起動してください

多くの AI Agent は起動時のみ MCP サービス設定を読み込みます。MCP サービス設定を変更した後、新しい設定が反映されない場合は、AI Agent を再起動してください。たとえば、VS Code で Codex などの AI Agent プラグインを使用している場合は、Ctrl + P を押して >Reload Window と入力すると、ウィンドウを再読み込みできます。

2. MCP サービスモード

DataFlux Func の MCP サービスは、接続パスに応じて 3 つのモードをサポートしています：

パス	モード
/mcp	基礎モード
/mcp2	List-Call モード
/mcp3	Search-Call モード（推奨）

Access Token の設定が以下のとおりであり、コードベースに以下の関数が存在すると仮定します：

!category:test
category:math

2.1 /mcp 基礎モード

利用可能なすべての関数を Tool として直接一覧表示します。

注意：関数リストが変更された場合、リストを更新するにはクライアントの再接続が必要です

2.2 /mcp2 List-Call モード

2 つの Tool のみを提供します：

• list-func：関数を一覧表示する
• call-func：関数を呼び出す

動的な関数リストを実現できます。AI Agent / モデルが List-Call 方式に従って正常に呼び出しを行える必要があります。

2.3 /mcp3 Search-Call モード

2 つの Tool のみを提供します：

• search-func：関数を検索する
• call-func：関数を呼び出す

キーワードに基づいて必要な関数を検索できます。AI Agent / モデルが Search-Call 方式に従って正常に呼び出しを行える必要があります。

関数の数が多い場合、コンテキストの長さを大幅に削減できます。