Skip to content

MCP 서비스 / MCP 코딩

7.6.0 버전에서 새로 추가됨

MCP 코딩은 DataFlux Func의 기능으로, AI Agent가 Func에서 스크립트를 작성하고 관리할 수 있도록 지원합니다.

사용자는 MCP 서비스 방식을 통해 AI Agent가 DataFlux Func에서 함수 작성 및 관리에 참여하도록 허용할 수 있습니다.

1. 연결 단계

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

1.1 Access Token 생성

DataFlux Func의 MCP Coding 서비스에 접속하려면 Access Token을 생성하고 MCP 코딩 기능을 활성화해야 합니다.

그리고 규칙에서 노출이 필요한 함수를 지정할 수 있습니다(예: 스크립트 세트 ID 기준).

add-access-token.png

add-access-token-2.png

1.2 권한 규칙

권한 규칙은 수동으로 편집할 수 있으며, 위에서 아래로 순서대로 매칭하여 첫 번째로 일치하는 규칙에 따라 권한이 결정됩니다.

예시는 다음과 같습니다.

규칙(정확히 일치하는 ID) 매칭 대상 매칭 ID 권한
scriptSet:mytest:r 스크립트 세트 mytest 읽기
scriptSet:mytest:rw 스크립트 세트 mytest 읽기, 수정
scriptSet:mytest:rwx 스크립트 세트 mytest 읽기, 수정, 실행
scriptSet:mytest:rwxp 스크립트 세트 mytest 읽기, 수정, 실행, 배포
script:mytest__demo:r 스크립트 mytest__demo 읽기
규칙(와일드카드 ID) 매칭 대상 와일드카드 ID 권한
scriptSet:my*:r 스크립트 세트 my* 와일드카드 기준 읽기
script:mytest__de*:r 스크립트 mytest__de* 와일드카드 기준 읽기

1.3 MCP 클라이언트 설정

DataFlux Func의 MCP 서비스는 MCP 규격을 준수합니다

실제 연결 전에는 MCP Inspector를 사용한 디버깅을 권장합니다

MCP 클라이언트 / AI Agent에 다음과 같은 설정을 추가합니다.

설정 항목
URL 주소 {DataFlux Func 접속 주소}/mcp/coding
요청 헤더 X-Dff-Access-Token: atk-xxxxx:xxxxx
예시: OpenCode 설정
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "mcp": {
    "dataflux-func-mcp-coding": {
      "enabled": true,
      "type"   : "remote",
      "url"    : "{DataFlux Func 접속 주소}/mcp/coding",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}
예시: Codex 설정
1
2
3
4
[mcp_servers.dataflux-func-mcp-coding]
enabled      = true
url          = "{DataFlux Func 접속 주소}/mcp/coding"
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-coding": {
      "type": "http",
      "url": "{DataFlux Func 접속 주소}/mcp/coding",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}
예시: 범용 JSON 설정
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
  "mcpServers": {
    "dataflux-func-mcp-coding": {
      "url": "{DataFlux Func 접속 주소}/mcp/coding",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}

1.4 로컬 협업 지침 초기화

최신 버전 MCP Coding 서비스의 help 도구에는 권장되는 로컬 AGENTS.md 협업 지침이 이미 포함되어 있어 사용자가 직접 만들 필요가 없습니다.

연결 후에는 AI Agent가 MCP 서비스 dataflux-func-testinghelp 도구를 먼저 호출하고, 반환된 권장 사항에 따라 초기화를 수행하는 것이 좋습니다.

2. 실제 작업 예시

MCP Coding에는 Func 개발을 위한 다양한 프롬프트와 도구 설명이 이미 내장되어 있습니다. 프롬프트를 입력할 때는 "AI Agent가 Func의 모범 사용 방식을 충분히 이해하고 있다"는 전제로 목표를 설명하면 됩니다.

예를 들어:

  • MCP 서비스 dataflux-func-testing의 권장 사항에 따라 초기화
  • 스크립트 세트 demo의 모든 코드를 동기화

먼저 AI Agent가 DataFlux Func의 MCP Coding 서비스에 성공적으로 연결되었는지 확인하세요:

opencode-mcp-status.png

이후에는 평소처럼 프롬프트를 입력하면 됩니다.

opencode-process.png

opencode-process-2.png

AI Agent 완료 후, DataFlux Func에서 새로고침하면 AI가 작성한 코드를 확인할 수 있습니다.

code.png