Skip to content

MCP로 MT5를 Claude와 ChatGPT에 연결하는 방법

MetaTrader 5는 빌드 6060(2026년 7월)부터 내장 MCP 서버를 제공합니다. 도구 → 옵션 → MCP에서 활성화하고 복사를 클릭한 뒤, 설정을 Claude Code 또는 OpenAI의 Codex에 붙여넣으세요. 또는 외부 클라이언트를 건너뛰고 MT5 자체 AI Assistant의 모델로 Claude나 GPT를 선택할 수도 있습니다. 거래를 꺼둔 데모 계정에서 시작하세요.

Fintrix trading desk •

MCP란 무엇인가요?

MCP(Model Context Protocol)는 Claude나 ChatGPT 같은 AI 어시스턴트가 채팅 외부의 도구를 사용할 수 있게 해주는 개방형 표준입니다. 파일을 읽고, 데이터베이스를 조회하고, 트레이딩 플랫폼에 가격을 요청할 수 있습니다. Anthropic이 만들었으며 현재 Claude, ChatGPT 및 다수의 개발자 도구에서 지원됩니다. 프로젝트 자체 문서에서는 이를 USB-C 포트에 비유합니다. 기기마다 전용 케이블을 쓰는 대신 하나의 표준 플러그를 쓰는 것입니다.

세 가지 구성 요소가 관여합니다:

  • 클라이언트: 입력하는 AI 앱입니다(Claude Code, Codex, Claude Desktop, ChatGPT).
  • MCP 서버: "심볼의 캔들 가져오기"나 "열린 포지션 목록" 같은 도구목록을 노출하는 프로그램입니다. 모델은 도구 설명을 읽고 언제 호출할지 결정합니다.
  • 그 뒤의 시스템: 여기서는 MetaTrader 5 터미널과 로그인된 거래 계정입니다.

따라서 "이번 주 H4 차트에서 금의 범위는 얼마였나요?"라고 물으면 모델이 서버의 캔들 도구를 호출하고, 서버가 MT5에 요청하며, 답변이 모델이 읽을 수 있는 데이터로 돌아옵니다. 모델은 MT5 화면을 보지 못하고 도구가 반환하는 것만 봅니다.

MT5에 공식 MCP 서버가 있나요?

예. MetaQuotes는 MT5 데스크톱 터미널에 네이티브 MCP 지원을 추가했습니다: 빌드 6060(2026년 7월 23일)에 MT5 데스크톱 터미널에 네이티브 MCP 지원을 추가했으며, 내장 AI Assistant와 함께 이후 모든 빌드(6090, 6140, 6180, 그리고 2026년 9월 24일의 마지막 6230)에서 도구를 추가했습니다. MT5 도움말에는 외부 클라이언트로 Claude Code와 OpenAI의 Codex가 명시되어 있고 각각에 대한 바로 사용 가능한 설정이 제공됩니다. 도움말 → 정보에서 빌드를 확인하세요. MT5는 Live Update를 통해 자체 업데이트됩니다. AI 기능은 Windows 7에서 비활성화됩니다.

터미널은 세 개의 MCP 서버를 노출합니다:

서버주소기능
terminalhttp://127.0.0.1:22346/mcp (PC)MT5: 시장 관찰, 캔들 및 틱, 차트 및 지표, 계정 및 거래 내역, Expert Advisor, 전략 테스터, 저널, 주문 도구
metaeditorhttp://127.0.0.1:22345/mcp (PC)MetaEditor: MQL5 코드 생성, 편집 및 컴파일
marketdatahttps://www.metatrader.com/mcp (MetaQuotes 클라우드)MetaTrader.com 시장 데이터, 뉴스 및 경제 캘린더

각 연결은 터미널이 생성하는 API 키(베어러 토큰)로 인증됩니다. 두 로컬 서버는 127.0.0.1에서 수신하므로 같은 컴퓨터의 프로그램만 접근할 수 있습니다.

MetaQuotes의 자체 도구 목록에 따른 terminal 서버의 기능: 시장 관찰, 캔들(get_chart_history) 및 틱 읽기, 차트 열기 및 지표 추가, 잔액, 자본, 증거금, 미결제 포지션 및 거래 내역 읽기, Expert Advisor 연결 및 백테스트와 최적화 실행(tester_run_backtest, tester_get_report), 플랫폼 및 Experts 저널 읽기, 주문 배치, 수정 및 종료(trade_send_market_order, trade_modify_sl_tp, trade_close_single_position 등). 일부 범용 도구는 셸 명령을 실행하고 파일을 작성할 수도 있습니다. 바로 이 마지막 그룹 때문에 아래의 안전 설정이 가장 먼저 나옵니다.

MetaQuotes는 도구 목록이 계속 늘어나고 있으며, 사용 가능한 도구를 확인하는 신뢰할 수 있는 방법은 에이전트에게 묻는 것이라고 말합니다: "MetaTrader MCP 서버를 사용해, 접근할 수 있는 모든 도구의 표를 제공해 주세요."

어떤 경로를 사용해야 할까요?

Claude나 GPT 모델을 MT5 데이터에 활용하는 방법은 세 가지입니다:

경로모델입력 위치설정
MT5 내장 AI Assistant기본적으로 MQL5 Lite(무료), 또는 자체 API 키로 Claude, GPT 등MT5 내부MQL5.community에 로그인하고 설정에서 공급자 API 키를 추가
Claude CodeClaudeClaude Code(터미널 또는 데스크톱 앱)MT5의 설정을 다음에 붙여넣기: .mcp.json
CodexOpenAI의 모델Codex 앱MT5의 설정을 다음에 붙여넣기: .codex\config.toml

내장 Assistant는 Claude나 GPT가 차트와 거래 내역을 읽게 하려는 경우 가장 짧은 경로입니다: 설정 파일이 필요 없고, 거래 및 셸 권한이 같은 설정 탭에 있습니다. Claude Code와 Codex는 MT5뿐 아니라 자신의 파일, 메모, 스크립트 전반에서 작업하려는 경우에 적합합니다.

무엇이든 연결하기 전에 어떻게 잠글 수 있을까요?

먼저 다음에서 하세요: 데모 계정.

  1. 열기 도구 → 옵션 → AI 어시스턴트.
  2. 설정거래를 전혀 거래하지 않음으로 설정하세요. 다른 선택지는 명시적 확인 요청과 실행에 대한 전체 권한입니다.
  3. 설정웹를 GET 요청만 또는 잠금 상태로 두세요. 웹 접근이 필요하지 않다면 그대로 두면 됩니다.
  4. 남겨두기위험한 셸 작업: PowerShell, Python 등은 꺼 두세요. 이 옵션을 켜면 어시스턴트가 MT5 자체 폴더 외부에서 컴퓨터의 명령을 실행할 수 있습니다.
  5. 클릭 확인.

MetaQuotes에 따르면 이 설정은 터미널과 MetaEditor가 공유하며, 에이전트가 보는 도구 목록은 "거래, 웹 접근, 셸 작업에 대한 구성에 따라 달라질 수 있습니다". 외부 클라이언트를 연결한 후에는 해당 클라이언트에 도구 표를 요청하고, 계속 진행하기 전에 trade_ 도구가 나타나지 않는지 확인하세요.

MT5의 MCP 서버는 어떻게 활성화하나요?

  1. 열기 도구 → 옵션 → MCP.
  2. 체크 내부 서버 활성화. 이는 terminal 서버만 켜며, marketdata 또는 metaeditor.
  3. 다음을 그대로 두십시오: 주소 기본값(http://127.0.0.1:22346/mcp) 다른 프로그램이 이미 해당 포트를 사용하고 있지 않은 경우에만 그렇게 하십시오.
  4. 생성하기 API 키. 외부 클라이언트는 모든 요청에 이 키를 함께 전송합니다.
  5. 클릭 확인, 그런 다음 복사를 클릭하세요. MT5는 Claude Code용과 Codex용 두 섹션으로 구성된 설정을 클립보드에 바로 복사하며, 각 섹션에는 세 서버가 모두 나열됩니다.

작업하는 동안 MT5 터미널을 열어 두세요. 로컬 서버는 터미널이 실행 중일 때만 존재합니다.

MT5를 Claude Code에 어떻게 연결하나요?

  1. 이 작업을 위한 폴더를 만드세요. 예: D:\MT5 AI.
  2. 그 안에 다음 이름의 파일을 만드세요: .mcp.json 그리고 MT5의 Claude Code 섹션을 붙여넣으세요. 키가 Bearer 뒤에 오는 형태로 다음과 같습니다: Bearer를 노출합니다:

    {
    "mcpServers": {
    "terminal": {
    "type": "http",
    "url": "http://127.0.0.1:22346/mcp",
    "headers": { "Authorization": "Bearer <your MT5 API key>" }
    },
    "marketdata": {
    "type": "http",
    "url": "https://www.metatrader.com/mcp",
    "headers": { "Authorization": "Bearer <your MT5 API key>" }
    },
    "metaeditor": {
    "type": "http",
    "url": "http://127.0.0.1:22345/mcp",
    "headers": { "Authorization": "Bearer <your MT5 API key>" }
    }
    }
    }


    필요 없는 서버는 삭제하세요. MQL5 코드를 작성하지 않는다면 metaeditor를 삭제하세요. 모든 폴더에서 접근하려면 MetaQuotes는 동일한 블록을 ~/.claude.json에 넣으라고 안내합니다.
  3. Claude Code를 재시작하고 해당 폴더에서 열어 다음을 요청하세요: "MetaTrader MCP 서버를 사용해 접근 가능한 모든 도구의 표를 제공해 주세요."
  4. 읽기 전용 질문으로 테스트하세요. 예: "터미널 도구를 사용해 XAUUSD의 최근 일봉 10개와 각 봉의 고가-저가 범위를 가져와." Claude Code는 도구를 호출하기 전에 권한을 요청합니다. 허용하기 전에 실행하려는 내용을 읽어보세요.

Claude Desktop(채팅 앱)은 MetaQuotes의 가이드에서 다루지 않습니다. 이 앱의 설정 파일은 로컬 프로그램을 실행하며, 사용자 지정 커넥터는 Anthropic의 클라우드로 만들어져 127.0.0.1의 서버에 접근할 수 없습니다. 이 앱에서 MT5에 접근하려면 로컬 브리지가 필요합니다. 예를 들어 오픈소스 mcp-remote 패키지가 있지만, MT5와 함께 테스트한 적은 없습니다.

MT5를 ChatGPT에 어떻게 연결하나요?

MetaQuotes의 가이드는 Codex, 즉 컴퓨터에서 실행되며 로컬 서버에 직접 접근할 수 있는 OpenAI의 코딩 에이전트를 다룹니다:

  1. Codex 앱에서 파일 → 폴더 열기를 사용해 프로젝트 폴더를 선택하거나 생성하세요. 예: D:\MT5 AI.
  2. 하위 폴더 .codex 그리고 그 안에, 이름이 config.toml인 파일이 있습니다. MT5에서 Codex 섹션을 붙여넣으세요:

    [mcp_servers.terminal]
    url = "http://127.0.0.1:22346/mcp"
    enabled = true
    http_headers = { "Authorization" = "Bearer <your MT5 API key>" }

    [mcp_servers.marketdata]
    url = "https://www.metatrader.com/mcp"
    enabled = true
    http_headers = { "Authorization" = "Bearer <your MT5 API key>" }
  3. Codex를 다시 시작하고 확인하세요 파일 → 설정 → 플러그인 → MCP: MT5 서버가 나열되어야 합니다.
  4. 도구 표를 요청한 다음 위와 같이 읽기 전용 질문으로 시작하세요.

ChatGPT 웹 채팅 앱은 다른 경우입니다. OpenAI의 도움말 페이지에 따르면 이 앱은 "원격 MCP 서버에 연결"하며, 공개 HTTPS 주소를 통하거나 OpenAI의 보안 MCP 터널, 전체 커스텀 서버 접근에는 Business, Enterprise 또는 Edu 워크스페이스가 필요합니다(Pro 사용자는 읽기 및 가져오기 권한만 받습니다). MT5의 terminal 서버는 본인 PC에서만 수신 대기하므로, ChatGPT는 해당 PC에서 실행되는 터널을 통해서만 접근할 수 있습니다. 터미널 서버를 개방 포트에 절대 게시하지 마십시오. 접근할 수 있는 사람은 누구든 ChatGPT와 동일한 도구를 갖게 됩니다.

커뮤니티 MT5 MCP 서버는 어떤가요?

빌드 6060 이전에는 오픈소스 프로젝트가 이 공백을 메웠으며, 이들은 여전히 Windows에서 MetaQuotes의 MetaTrader5 Python 패키지를 통해 작동합니다. 2026년 11월 11일에 확인한 두 가지 예시는 metatrader-mcp-server(MIT, GitHub 스타 약 850개, 거래 가능)와 mt5-mcp(MIT, 설계상 읽기 전용: 주문 호출 차단)입니다. 둘 다 MetaQuotes, Anthropic, OpenAI 또는 Fintrix Markets와 제휴 관계가 없으며, 당사는 해당 코드를 감사하지 않았습니다.

대부분의 트레이더에게는 내장 서버가 더 나은 출발점입니다. MT5에 기본 포함되어 있고, Python 설치가 필요 없으며, API 키로 모든 클라이언트를 인증하고, 플랫폼의 더 많은 기능(전략 테스터, 저널, 차트 제어)을 노출합니다. 설정과 무관하게 주문을 넣을 수 없는 서버를 원하거나 공식 서버가 아직 제공하지 않는 도구를 원한다면 커뮤니티 서버도 여전히 합리적일 수 있습니다.

거래 계좌에 대한 AI 연결을 어떻게 안전하게 유지하나요?

모델은 도구 설명과 사용자의 말을 읽은 뒤 무엇을 호출할지 결정합니다. 요청을 잘못 해석하거나 소수점 위치를 착각하거나 오래된 가격에 따라 행동할 수 있습니다. 다음 규칙은 실수의 비용을 제한합니다:

  1. 데모 계좌에서 시작하십시오. 모든 새 클라이언트, 프롬프트, 워크플로를 먼저 데모에서 실행하고, 모델의 동작이 더 이상 놀랍지 않을 때까지 그곳에 머무르십시오.
  2. 거래를 끄고, 두 번 강제하십시오. MT5의 AI 설정에서 Trading을 전혀 거래하지 않음으로 설정하고, 터미널에는 계정의 투자자 비밀번호로 로그인하십시오. MetaTrader는 투자자 비밀번호를 "읽기 전용 모드(거래 작업 없음)" 접근으로 설명하며, AI 설정과 무관하게 거래 서버가 이를 강제합니다. 주문 처리 테스트를 결정했을 때만 데모에서 명시적 확인 요청로 전환하십시오.
  3. MT5 API 키를 비밀번호처럼 취급하십시오. 이 키는 .mcp.json 또는 config.toml에 평문으로 저장됩니다. 해당 파일을 공유 또는 동기화 폴더 밖에 두고, 키나 MT5 비밀번호를 채팅에 절대 붙여넣지 말며, 유출 시 새 키를 생성하십시오.
  4. 모델이 틀릴 수 있고, 잘못 인도될 수 있다고 가정하십시오. 실제 예시: 2026년 10월 30일, 금(XAUUSD)은 Fintrix Markets MT5 피드에서 4,028.70과 3,869.31 사이를 움직였으며, 이는 $159.39의 범위입니다. 100온스 계약 기준으로 이 범위의 가치는 $1,593.90 0.10랏 기준 그리고 $15,939 1.00랏 기준입니다. 0을 하나 빠뜨리는 모델은 첫 번째 숫자를 두 번째 숫자로 바꿔버립니다. 도구 결과, 뉴스 항목, 웹 페이지 또는 파일 안에서 모델이 읽는 텍스트에는 모델이 실수로 따르게 되는 지시가 포함될 수도 있으며, OpenAI의 도움말 페이지에서는 이를 프롬프트 인젝션이라고 경고합니다. 작업에 필요하지 않다면 웹 접근과 셸 작업은 꺼 두십시오.
  5. 모든 주문은 사람이 승인하도록 하십시오. 거래를 활성화하기로 했다면 명시적 확인을 선택하고, 클라이언트 자체의 권한 프롬프트를 켜 둔 채, 승인 전에 심볼, 방향, 거래량을 확인하십시오. MetaQuotes의 자체 도움말도 이를 분명히 밝힙니다. "AI 생성 콘텐츠, AI 지원 작업, 거래 결정, 거래 결과 및 그로 인한 모든 손실에 대한 책임은 전적으로 귀하에게 있습니다."

이 중 어느 것에든 의존하기 전에 두 가지를 더 확인하십시오:

  • 로그를 남기십시오. 무엇을 요청했는지, 모델이 무엇을 호출했는지, 무엇이 반환되었는지 기록하십시오. MT5는 또한 AI Assistant 채팅을 Navigator의 Chats 탭에 보관합니다.
  • 백테스트를 검증하듯 결과를 검증하십시오. 과거 가격 데이터에 대한 AI 요약도 여전히 과거에 대한 분석이며, AI가 수행한 최적화도 수동 최적화만큼이나 쉽게 과최적화될 수 있습니다. 미래 정보 편향(look-ahead bias) 강의에서는 당시에 가질 수 없었던 정보를 사용하는 결과가 왜 실제보다 좋아 보이는지 설명합니다.

MT5와 MCP는 무엇에 유용한가요?

AI 어시스턴트를 MT5에 연결한다고 해서 그 자체로 더 나은 트레이더가 되는 것은 아닙니다. 다만 자신의 정보에 더 빠르게 접근하는 방식이 바뀔 뿐입니다. 거래를 꺼 둔 상태에서의 일반적인 용도는 다음과 같습니다:

  • 거래 내역 요약: 보유 시간, 가장 많이 거래하는 상품, 손절로 청산되는 빈도.
  • 스프레드시트로 내보내지 않고 캔들을 가져와 범위나 평균을 계산.
  • 심볼 사양(계약 크기, 스왑, 거래 시간)을 쉬운 말로 확인.
  • Expert Advisor의 Strategy Tester 실행을 설정하고 보고서와 테스터 저널을 다시 읽기.
  • Experts 저널을 읽어 EA가 중단된 이유나 주문이 거부된 이유를 찾기.

모든 답변은 도구가 반환한 데이터와 모델의 해석만큼만 신뢰할 수 있습니다. 중요한 숫자는 MT5 자체에서 확인하십시오.

핵심 요점

  • MCP는 AI 앱이 도구를 호출할 수 있게 하는 개방형 표준입니다. 빌드 6060부터 MT5는 자체 MCP 서버를 제공합니다: terminal, metaeditor 그리고 marketdata.
  • Tools → Options → MCP에서 서버를 활성화하고, API 키를 생성한 뒤 Copy를 클릭하고, 설정을 Claude Code(.mcp.json) 또는 Codex(.codex\config.toml)에 붙여넣으십시오.
  • MT5에 내장된 AI Assistant는 외부 클라이언트 없이도 자체 API 키로 Claude 또는 GPT 모델에서 실행할 수 있습니다.
  • ChatGPT 웹 앱은 원격 서버에만 접속하므로, 로컬 MT5에는 OpenAI의 Secure MCP Tunnel이 필요합니다.
  • 데모로 시작하고, 거래를 꺼 두고, 투자자 비밀번호로 로그인하며, 모든 주문은 사람이 승인하도록 유지하세요.

관련 레슨

출처

배운 지식을 실전에 활용하세요

Fintrix Markets 계좌를 개설하거나 로그인하여 외환, 금, 지수 등 다양한 CFD 상품을 거래하세요.