Skip to content

MCP 서비스 / MCP 함수

7.5.0 버전에서 추가됨

"MCP 함수"는 DataFlux Func에서 AI Agent가 Func의 함수를 호출할 수 있도록 지원하는 기능입니다.

사용자는 MCP 서비스 방식으로 AI Agent에 DataFlux Func의 일부 함수를 제공할 수 있습니다.

1. 연동 단계

다음 단계에 따라 MCP 클라이언트 / AI Agent를 DataFlux Func의 MCP 서비스에 연동할 수 있습니다.

1.1 Access Token 생성

DataFlux Func의 MCP 서비스에 접근하려면 Access Token을 생성하고 'MCP 함수' 기능을 활성화해야 합니다.

또한 규칙에서 필요한 공개 함수를 지정할 수 있습니다(예: category 필드 값 기준).

add-access-token.png

add-access-token-2.png

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
예시: OpenCode 구성
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "mcp": {
    "dataflux-func-mcp": {
      "enabled": true,
      "type"   : "remote",
      "url"    : "{DataFlux Func 접속 주소}/mcp",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}
예시: Codex 구성
1
2
3
4
[mcp_servers.dataflux-func-mcp]
enabled      = true
url          = "{DataFlux Func 접속 주소}/mcp"
http_headers = { "X-Dff-Access-Token" = "atk-xxxxx:xxxxx" }
예시: Claude Code 구성
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{
  "mcpServers": {
    "dataflux-func-mcp": {
      "type": "http",
      "url": "{DataFlux Func 접속 주소}/mcp",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}
예시: 범용 JSON 구성
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
  "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 허용
1
2
!category:test
category:math

code.png

2.1 /mcp 기본 모드

사용 가능한 모든 함수를 Tool로 직접 나열합니다

참고: 함수 목록이 변경되면 클라이언트가 다시 연결해야 목록이 업데이트됩니다

2.2 /mcp2 List-Call 모드

두 개의 Tool만 제공합니다:

  • list-func: 함수 나열
  • call-func: 함수 호출

동적 함수 목록을 구현할 수 있으며, AI Agent / 모델이 List-Call 방식을 올바르게 따라 호출할 수 있어야 합니다

2.3 /mcp3 Search-Call 모드

두 개의 Tool만 제공합니다:

  • search-func: 함수 검색
  • call-func: 함수 호출

키워드로 필요한 함수를 조회할 수 있으며, AI Agent / 모델이 Search-Call 방식을 올바르게 따라 호출할 수 있어야 합니다

함수 수가 많을 때 컨텍스트 길이를 크게 줄일 수 있습니다