MCP 연동

메뉴 위치

• 화면 맨 아래 상태바 왼쪽의 ● MCP 대기 중 (클릭: 연동 안내)를 누르면 RelatiQ MCP 연동 안내 창이 열립니다. 설정에 필요한 내용을 여기서 바로 복사할 수 있습니다.
• AI 툴에 등록하는 MCP 서버 파일은 설치 폴더의 McpServer\RelatiQ.McpServer.exe입니다. 기본 설치 위치라면 C:\Program Files (x86)\ExaPeak Soft Solutions\RelatiQ ER Designer\McpServer\RelatiQ.McpServer.exe입니다. 같은 폴더의 연결안내.txt에도 설정 방법이 적혀 있습니다.

화면과 버튼

RelatiQ MCP 연동 안내 창의 구성입니다. Esc나 닫기로 닫습니다.

MCP 서버 파일을 찾지 못하면 "※ 서버 실행파일(RelatiQ.McpServer.exe)을 이 PC 에서 찾지 못했습니다."가 함께 나옵니다. 이때 보이는 경로는 기본 설치 위치 기준입니다.

따라 하기

Claude Desktop에 등록하기

1. RelatiQ를 실행합니다

   상태바에 ● MCP 대기 중이 보이는지 확인합니다.

2. 설정 JSON을 복사합니다

   ● MCP 대기 중을 눌러 안내 창을 열고 설정 JSON 복사를 누릅니다.

3. 설정 파일을 엽니다

   Claude 설정 폴더 열기를 누르고, 열린 폴더의 claude_desktop_config.json을 메모장으로 엽니다. 파일이 없으면 새로 만듭니다.

4. 붙여 넣고 저장합니다

   파일이 비어 있으면 복사한 내용을 그대로 붙여 넣습니다. 이미 mcpServers 항목이 있으면 그 안에 relatiq 항목만 추가합니다.

5. Claude Desktop을 다시 시작합니다

   완전히 종료했다가 다시 실행하면 도구 목록에 relatiq가 나타납니다.

복사되는 설정 JSON은 기본 설치 위치라면 다음과 같습니다.

{ "mcpServers": { "relatiq": { "command": "C:\\Program Files (x86)\\ExaPeak Soft Solutions\\RelatiQ ER Designer\\McpServer\\RelatiQ.McpServer.exe" } } }

Cursor에 등록하기

1. 서버 경로를 복사합니다

   안내 창의 서버 exe 경로 복사를 누릅니다.

2. MCP 서버를 추가합니다

   Cursor 설정의 MCP 항목에서 새 서버를 추가하고, 이름은 relatiq, 실행 명령에는 복사한 경로를 넣습니다. 프로젝트 폴더의 .cursor\mcp.json 파일에 설정 JSON을 넣어도 됩니다.

3. 도구 목록을 확인합니다

   RelatiQ를 실행한 상태에서 Cursor의 MCP 목록에 relatiq 도구가 보이면 됩니다.

Claude Code에 등록하기

1. 서버 경로를 복사합니다

   안내 창의 서버 exe 경로 복사를 누릅니다.

2. 터미널에서 한 줄을 실행합니다

   claude mcp add relatiq -- "서버 exe 경로" 형식으로, 따옴표 안에 복사한 경로를 넣습니다.

AI 툴에서 써 보기

1. RelatiQ에서 프로젝트를 엽니다

   프로젝트 시작 창에 머물러 있어도 됩니다. 이때 AI가 데이터베이스 종류를 정하면서 새 프로젝트를 엽니다.

2. AI 툴에 요청합니다

   예: "현재 열린 ERD 를 읽고 정규화·누락 FK 관점에서 문제를 찾아줘".

3. 캔버스에서 결과를 확인합니다

   AI가 바꾼 내용이 RelatiQ 캔버스에 바로 나타납니다. 필요 없으면 RelatiQ에서 Ctrl+Z로 되돌리고, 남기려면 Ctrl+S로 저장합니다.

이렇게 말해 보세요

• "현재 열린 ERD 를 읽고 정규화·누락 FK 관점에서 문제를 찾아줘"
• "회원(MEMBER)과 주문(ORDER) 엔티티를 만들고 1:N 관계로 연결해"
• "모든 테이블에 created_at, updated_at 컬럼을 추가해"
• "수퍼마켓 POS 시스템 데이터 모델을 설계해서 캔버스에 그려줘"
• "PostgreSQL DDL 을 생성해서 보여줘"
• "열린 탭 목록 보여줘", "두 번째 탭으로 전환해서 작업해줘"

동작 규칙

• RelatiQ가 실행 중일 때만 도구가 보입니다. 꺼져 있으면 도구 목록이 비고, RelatiQ를 켜면 MCP 서버가 AI 툴에 도구 목록이 바뀌었다고 알려 다시 나타납니다.
• AI가 한 변경은 캔버스에 바로 반영되고 RelatiQ에서 Ctrl+Z로 되돌릴 수 있습니다. 저장은 직접 하세요(AI에게 저장을 요청할 수도 있습니다).
• RelatiQ와 AI 툴 사이의 연결은 이 PC 안에서, 지금 Windows에 로그인한 사용자에게만 열립니다. 외부 네트워크로 포트를 열지 않습니다.
• 모든 도구는 지금 활성 탭 하나를 대상으로 동작합니다. 프로젝트가 여러 개 열려 있으면 AI가 탭 목록을 확인하고 대상 탭을 고릅니다.
• MCP 연동에는 RelatiQ의 AI 기능 설정(API 키)이 필요 없습니다. AI 툴이 자기 계정과 모델로 동작합니다.
• 앱 안의 AI 어시스턴트(툴바 ✦)도 같은 도구를 씁니다. 따로 설정하지 않고 바로 쓰려면 그쪽이 빠릅니다 → AI 기능.
• MCP 연동은 무료판에서도 모두 쓸 수 있습니다.

MCP 도구 목록

AI 툴이 호출하는 도구 이름입니다. 대화에서 도구 이름을 직접 말할 필요는 없지만, 원하는 동작을 정확히 시키고 싶을 때 참고하세요.

알아 두기

자주 묻는 것

관련 항목