AI 커넥터 설정 도우미

Claude Code AI 커넥터 설정법

Anthropic / 확인일 2026-09-20

공개 저장소의 스킬 묶음이 이 도구를 기준으로 쓰여 있어요. 처음이라면 여기가 길이 가장 또렷해요.

이 안내는 게임사가 연 기능을 켜는 방법만 알려 줘요. 게임을 대신 조작하는 프로그램이 아니고 넥슨과 관계도 없어요.

넥슨과 무관한 안내예요. 게임 이름은 무엇에 대한 안내인지 가리킬 때만 써요.

  1. 1. 준비물을 먼저 갖춰요

    PC 버전 게임(2026-09-17 이후 판), Node.js 18 이상, Git for Windows, 그리고 Claude Code 가 필요해요. Git 은 Claude Code 가 명령을 돌릴 때 써요.

    확인일 2026-09-20 / 출처 KwangB, 공개 저장소 윈도우 설치 문서 (문서 기준)

    저장소가 2026-09-19 에 생겨서 쓰는 사람의 기록이 아직 쌓이지 않았어요.

  2. 2. Claude Code 를 깔아요

    윈도우라면 이 한 줄이 가장 짧아요. 시작 메뉴에서 PowerShell 을 열고 붙여넣은 다음 엔터를 눌러요.

    winget install Anthropic.ClaudeCode
    칠 자리: 윈도우 PowerShell

    확인일 2026-09-20 / 출처 Anthropic, Claude Code 공식 설치 문서 (문서 기준)

  3. 3. npm 으로 깔 거면 Node 버전을 봐요

    npm 으로 까는 길도 있는데, 2.1.198 판부터 Node.js 22 이상이 필요해요. 낮은 판이면 EBADENGINE 경고가 뜨고 설치 자체는 돼요. 깔고 나면 실행할 때는 Node 를 안 써요.

    npm install -g @anthropic-ai/claude-code
    칠 자리: 윈도우 PowerShell

    확인일 2026-09-20 / 출처 Anthropic, Claude Code 공식 설치 문서 (문서 기준)

  4. 4. 공개 저장소를 내려받아요

    이 명령은 저장소를 지금 있는 폴더 아래로 통째로 내려받아요. 우리가 파일을 대신 주지 않고, 만든 사람 쪽에서 바로 받아요.

    git clone https://github.com/KwangB/mabinogi-mobile-ai-agent.git
    칠 자리: 윈도우 PowerShell

    확인일 2026-09-20 / 출처 KwangB, 공개 저장소 README (MIT) (문서 기준)

    넥슨과 무관한 비공식 팬 프로젝트예요. 저장소 스스로 그렇게 적고 있어요.

  5. 5. 제대로 받아졌는지 확인해요

    내려받은 폴더 안에서 이 명령을 돌려요. 마지막 줄이 37/37 passed 로 끝나면 된 거예요.

    node server/test/smoke.mjs
    칠 자리: 내려받은 폴더 안의 PowerShell

    확인일 2026-09-20 / 출처 KwangB, 공개 저장소 README (MIT) (문서 기준)

    넥슨과 무관한 비공식 팬 프로젝트예요. 저장소 스스로 그렇게 적고 있어요.

  6. 6. 게임에서 AI 커넥터를 켜요

    게임 안에서 메뉴(삼선)를 누르고 환경 설정, 게임, AI 제어 순서로 들어가요. 거기 AI 커넥터(Beta) 토글이 있어요.

    확인일 2026-09-20 / 출처 넥슨, 공식 가이드, AI 커넥터(Beta) 안내 (문서 기준)

    이 페이지는 자동으로 그려지는 꼴이라 글자 단위로 대조하지 못했어요. 값이 다르면 이 문서가 맞아요.

  7. 7. AI 도구가 게임을 알아보는지 봐요

    따로 키를 발급하는 단계는 없어요. 토글을 켜면 PC 에 깔린 AI 도구가 게임을 알아봐요. 게임이 기본 설치 경로에 없으면 못 찾을 수 있어서, 그때는 경로를 따로 알려 줘야 해요.

    확인일 2026-09-20 / 출처 blueapgit, 다른 공개 저장소, 도구별 스킬 모음 (문서 기준)

    여기 적힌 확인 항목은 만든 사람이 미리 적어 둔 것이지 누가 겪은 일이 아니에요.

  8. 8. 제한을 미리 알아 둬요

    활동 1회당 정령의 날개 5개가 들어요. 1시간 동안 계속 실행되면 확인 팝업이 떠요. 7일간 안 쓰면 이 옵션이 저절로 꺼져요.

    확인일 2026-09-20 / 출처 넥슨, 공식 가이드, AI 커넥터(Beta) 안내 (문서 기준)

    이 페이지는 자동으로 그려지는 꼴이라 글자 단위로 대조하지 못했어요. 값이 다르면 이 문서가 맞아요.

  9. 9. Claude Code 를 열고 연결을 허락해요

    내려받은 폴더에서 claude 라고 치면 열려요. mabinogi 라는 MCP 서버를 쓸지 물어보면 허락하고, 그다음 /mabi-start 라고 치면 돼요.

    claude
    칠 자리: 내려받은 폴더 안의 PowerShell

    확인일 2026-09-20 / 출처 KwangB, 공개 저장소 README (MIT) (문서 기준)

    넥슨과 무관한 비공식 팬 프로젝트예요. 저장소 스스로 그렇게 적고 있어요.

돈은 누가 내나요

Pro, Max, Team, Enterprise, Console 가운데 하나가 있어야 써요. 무료 claude.ai 요금제로는 안 돼요. Bedrock, Vertex, Foundry 같은 바깥 API 로도 쓸 수 있어요.

출처 Anthropic, Claude Code 공식 비용 문서

설정 파일이 사는 자리

작업 폴더 안의 .mcp.json 파일

출처 Anthropic, Claude Code 공식 MCP 문서

막혔을 때 보는 진단표

어느 단계가 여기 적힌 대로 안 됐으면 증상부터 거기서 찾아요.

다른 도구