ERFit MCP 등록 및 사용 방법 | ERFit

nexFLOW 기술 가이드 · 2026-10-11

개요

ERFit MCP는 AI 에이전트와 브라우저에서 열어 둔 ERFit 모델을 연결합니다. 모델 조회부터 새 모델 초안 작성, 기존 모델 변경, Apply와 Undo까지 사용할 수 있습니다. ERFit Desktop이나 별도 MCP 프로그램을 사용자 PC에 설치할 필요는 없습니다.

홈페이지 로그인은 회원 편집기를 여는 데 사용합니다. 에이전트에는 MCP 주소를 등록하고, 앱이 여는 브라우저에서 nexFLOW 로그인 후 접근 권한을 허용합니다. 연결한 편집기 탭은 작업하는 동안 열어 두세요.

일반 모델 도구는 MCP 크레딧을 사용합니다. 서버 운영자가 AI 공급자를 연결한 환경에서는 analyze_model_ai로 열린 모델의 구조를 읽기 전용으로 분석할 수 있으며, 이 호출은 AI 크레딧과 일일 한도를 사용합니다. 공급자 연결이 없는 환경에는 해당 도구가 표시되지 않습니다. AI 분석 결과는 모델에 자동 반영되지 않습니다. 외부 에이전트의 구독료나 자체 AI 사용료는 nexFLOW 크레딧과 별개입니다.

아래 설정은 https://nexflow.im/mcp/erfit 기준입니다. OAuth와 My Account에서 발급한 개인 토큰 중 하나로 인증할 수 있습니다. 개인 토큰 하나는 ERFit·ContextMeta에 함께 사용하며, OAuth는 서비스·앱별로 연결을 허용하고 연결된 앱에서 해제합니다.

활용 목표

회원 모델의 MCP 자동 연결

하네스에서 편집을 결정하고 Apply·Undo

앱별 연결 권한 확인·해제

적용 절차

MCP 주소 등록 후 브라우저에서 연결 허용

사용하는 앱에 아래 주소를 등록합니다. 인증을 시작하면 열리는 nexFLOW 화면에서 연결 계정·앱·조회/편집/AI 권한을 확인하고 “연결 허용”을 누르세요. 편집 또는 AI 권한에는 조회 권한도 포함되며, 실제 작업에는 현재 플랜·크레딧과 편집기 연결 조건을 함께 적용합니다.

연결된 앱 관리

text

https://nexflow.im/mcp/erfit

Codex에 등록

Codex 설정의 MCP 서버에서 Streamable HTTP 주소를 등록하거나 ~/.codex/config.toml에 아래 항목을 추가합니다. 조회·편집 권한으로 연결하려면 codex mcp login erfit_web --scopes erfit:read,erfit:edit를 실행합니다. AI 기능도 사용할 때는 --scopes 값에 erfit:ai를 추가합니다.

Codex 공식 MCP 설정

toml

[mcp_servers.erfit_web]
url = "https://nexflow.im/mcp/erfit"
tool_timeout_sec = 120

Claude Code에 등록

아래 명령으로 HTTP 서버를 추가한 뒤 Claude Code의 /mcp에서 ERFit 인증을 시작합니다. 브라우저에서 로그인과 권한 동의를 마치고 앱으로 돌아옵니다.

Claude Code 공식 MCP 설정

bash

claude mcp add --transport http erfit_web https://nexflow.im/mcp/erfit

OpenCode 설정 예시

opencode.json 또는 opencode.jsonc에 아래 설정을 병합하고 opencode mcp auth erfit_web을 실행합니다. 조회·편집 권한을 요청하는 예시이며 AI 기능도 사용할 때는 oauth.scope에 erfit:ai를 추가합니다. 브라우저에서 로그인·동의하면 앱이 인증을 보관하고 갱신합니다.

OpenCode 공식 MCP 설정

json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "erfit_web": {
      "type": "remote",
      "url": "https://nexflow.im/mcp/erfit",
      "oauth": {
        "scope": "erfit:read erfit:edit"
      },
      "enabled": true
    }
  }
}

Cursor에 등록

Cursor의 MCP 설정에 아래 원격 서버를 추가하고 연결 인증을 선택합니다. 브라우저 동의를 마친 뒤 서버 상태와 도구 목록을 확인하세요.

Cursor MCP 문서

json

{
  "mcpServers": {
    "erfit_web": {
      "url": "https://nexflow.im/mcp/erfit"
    }
  }
}

개인 토큰으로 연결하기 · Codex

OAuth 대신 키를 사용하려면 My Account → MCP 연결에서 개인 토큰을 발급합니다. 발급 직후 한 번만 표시되며 ERFit·ContextMeta에서 함께 사용할 수 있습니다. 실행 환경의 ERFIT_MCP_TOKEN에 원문을 보관하고 Codex 설정을 아래처럼 사용합니다. 키를 교체하면 양쪽 서비스의 이전 키 연결이 중단됩니다.

개인 토큰 발급·관리

toml

[mcp_servers.erfit_web]
url = "https://nexflow.im/mcp/erfit"
bearer_token_env_var = "ERFIT_MCP_TOKEN"
tool_timeout_sec = 120

개인 토큰 설정 · Claude Code

키 방식을 선택했다면 .mcp.json에 아래 설정을 사용합니다. ${ERFIT_MCP_TOKEN}은 환경변수 참조입니다. 실제 원문을 파일에 넣거나 공유하지 않습니다.

json

{
  "mcpServers": {
    "erfit_web": {
      "type": "http",
      "url": "https://nexflow.im/mcp/erfit",
      "headers": {
        "Authorization": "Bearer ${ERFIT_MCP_TOKEN}"
      }
    }
  }
}

개인 토큰 설정 · OpenCode

OpenCode의 키 방식은 oauth:false와 환경변수 헤더를 함께 사용합니다. OAuth 방식을 선택한 경우에는 앞의 OAuth 설정만 사용합니다.

json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "erfit_web": {
      "type": "remote",
      "url": "https://nexflow.im/mcp/erfit",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:ERFIT_MCP_TOKEN}"
      },
      "enabled": true
    }
  }
}

ERFit Web에서 작업 모델 열기

로그인한 회원이 ERFit Web을 열면 현재 모델이 MCP에 자동 연결됩니다. 툴바의 MCP 연결에서 대상 모델과 주소를 확인할 수 있습니다. 조회만 할지 편집할지는 코딩 에이전트의 모드·도구 권한에서 정하세요. 에이전트의 Apply·Undo 요청은 ERFit에서 다시 승인받지 않고 실행됩니다. 작업 중에는 편집기 탭을 열어 두세요.

ERFit Web 열기

도구 목록 확인 후 모델 작업 요청

MCP 연결 상태와 실제 도구 목록을 확인합니다. 조회·미리보기는 모델을 바꾸지 않습니다. 하네스가 편집을 결정하고 Apply를 요청하면 모델 버전·해시와 접근 권한을 확인한 뒤 반영합니다. 아래는 가상 모델로 연습하는 요청 예시입니다.

text

1. ERFit MCP의 list_models로 연결된 모델을 확인해줘.
2. 이 모델에 고객 테이블 초안을 만들어줘.
   컬럼: 고객번호(기본키), 고객명, 이메일.
3. 변경 전후를 미리보기로 검증해줘.
4. 실제 ERFit 모델에 Apply해줘.
5. 적용 결과의 모델 버전과 테이블을 다시 확인해줘.

모델 저장·앱 연결 해제

Apply는 브라우저의 ERFit 모델을 변경합니다. 결과를 확인하고 파일을 저장하세요. 실제 데이터베이스 DDL 실행이나 Repository 자동 업로드는 아닙니다. 다른 앱 연결을 사용할 때는 ERFit 편집기를 다시 연결합니다. 앱의 접근 권한을 끝내려면 My Account → 연결된 앱에서 해당 연결을 해제하세요. 홈페이지 로그아웃이나 편집기 탭 종료와 앱 연결 해제는 별개입니다.

업무 흐름

에이전트 등록

MCP 주소 추가

로그인·동의

브라우저에서 앱 권한 허용

모델 자동 연결

회원 편집기에서 모델 열기

작업·저장

하네스에서 편집 결정·Apply 후 파일 저장

적용 범위와 한계

연결은 앱별로 허용하며 최대 30일 후 다시 인증합니다. My Account에서 해제하면 기존 인증으로 더 이상 실행할 수 없습니다.
사용할 모델의 온라인 연결 하나만 남기세요. 다른 앱 연결이 기존 초안·승인 내용을 이어받을 수 없으며 편집기를 다시 연결해야 합니다.
MCP 도구 조회와 실제 모델 작업은 구분됩니다. 게스트 편집기나 연결이 종료된 탭에는 모델 변경을 수행할 수 없습니다.

자주 묻는 질문

401 / MCP_AUTH_REQUIRED가 나옵니다.

OAuth는 앱에서 인증을 다시 시작하고 브라우저 동의를 완료하세요. 키 방식은 개인 토큰이 폐기·교체됐는지, 앱 실행 환경에 원문이 전달됐는지 확인합니다. OAuth와 개인 토큰 설정을 섞지 말고 선택한 방식으로 다시 연결하세요.

403 / insufficient_scope가 나옵니다.

조회 권한만 허용한 OAuth 연결에서는 편집·AI 기능을 실행할 수 없습니다. 사용할 권한으로 앱 인증을 다시 진행하세요. 편집은 erfit:read erfit:edit, AI는 erfit:read erfit:ai가 필요합니다. 하네스의 모드와 도구 허용 설정도 확인하세요.

“Apply 도구가 없다”거나 미리보기 전용이라고 합니다.

Codex가 이전 도구 목록이나 대화의 설명을 유지할 수 있습니다. 실제 주소와 enabled_tools/disabled_tools 필터를 확인하고 MCP를 재연결한 새 채팅에서 tools/list를 확인하세요. 현재 웹은 apply_changeset, apply_model_draft와 Undo를 지원하며 ERFit에서 별도로 편집 허용을 선택하지 않습니다.

EDITOR_DISCONNECTED 또는 MULTIPLE_EDITORS가 나옵니다.

회원 편집기에서 작업 모델을 열면 자동 연결됩니다. 연결을 직접 해제했다면 MCP 연결 → 다시 연결을 누르세요. MULTIPLE_EDITORS는 같은 회원의 온라인 연결이 여러 개라는 뜻이므로 사용할 편집기 하나만 남깁니다.

모델 버전 충돌이 발생합니다.

미리보기 이후 수동 편집 등으로 모델이 달라졌을 수 있습니다. 최신 모델을 조회해 새 변경안을 만들고 다시 검토하세요. 추가 승인 창이 없어도 버전·해시 검사는 유지됩니다.

Apply하면 파일도 자동 저장되나요?

Apply는 연결된 브라우저 모델을 변경합니다. 결과를 확인한 뒤 파일 저장은 별도로 수행합니다.