AI Connector Setup Helper

1. 1. Get the prerequisites first

   You need the PC build of the game (2026-09-17 or later), Node.js 18 or newer, Git for Windows, and Claude Code itself. Git is what Claude Code runs its shell commands through.

   Checked on 2026-09-20 / Source KwangB, Open source repository, Windows setup document (from the document)

   The repository was created on 2026-09-19, so user reports have not accumulated yet.

   Done

2. 2. Install Claude Code

   On Windows this single line is the shortest route. Open PowerShell from the Start menu, paste it, press Enter.

   winget install Anthropic.ClaudeCode

   Copy commandWhere: Windows PowerShell

   Checked on 2026-09-20 / Source Anthropic, Claude Code setup documentation (from the document)

   Done

3. 3. If you install with npm, check your Node version

   You can install through npm instead, but from version 2.1.198 it wants Node.js 22 or newer. An older Node prints an EBADENGINE warning and still installs. Once installed it runs as a native binary and does not use Node.

   npm install -g @anthropic-ai/claude-code

   Copy commandWhere: Windows PowerShell

   Checked on 2026-09-20 / Source Anthropic, Claude Code setup documentation (from the document)

   Done

4. 4. Clone the open source repository

   This pulls the whole repository into the folder you are standing in. We never hand you the files ourselves, you take them from the author.

   git clone https://github.com/KwangB/mabinogi-mobile-ai-agent.git

   Copy commandWhere: Windows PowerShell

   Checked on 2026-09-20 / Source KwangB, Open source repository README (MIT) (from the document)

   An unofficial fan project, not affiliated with Nexon. The repository says so itself.

   Done

5. 5. Check that it landed correctly

   Run this inside the folder you just cloned. If the last line reads 37/37 passed, you are good.

   node server/test/smoke.mjs

   Copy commandWhere: PowerShell inside the cloned folder

   Checked on 2026-09-20 / Source KwangB, Open source repository README (MIT) (from the document)

   An unofficial fan project, not affiliated with Nexon. The repository says so itself.

   Done

6. 6. Switch the connector on inside the game

   In the game open the menu (three lines), then Settings, Game, AI Control. The AI Connector (Beta) toggle sits there.

   Checked on 2026-09-20 / Source Nexon, Official guide, AI Connector (Beta) (from the document)

   That page renders dynamically, so we could not diff it word for word. Where it differs, the official page wins.

   Done

7. 7. Check that the tool sees the game

   There is no key to issue. With the toggle on, the tool on your PC picks the game up. If the game is not in its default install folder the tool may miss it, and you have to point at the folder yourself.

   Checked on 2026-09-20 / Source blueapgit, Another open repository, skill sets per tool (from the document)

   Its troubleshooting notes were written in advance by the author, not collected from incidents.

   Done

8. 8. Know the limits before you start

   Each activity costs five Spirit Wings. After an hour of continuous running a confirmation popup appears. If you do not use it for seven days the option turns itself off.

   Checked on 2026-09-20 / Source Nexon, Official guide, AI Connector (Beta) (from the document)

   That page renders dynamically, so we could not diff it word for word. Where it differs, the official page wins.

   Done

9. 9. Open Claude Code and approve the connection

   Type claude inside that folder. When it asks whether to use the MCP server named mabinogi, approve it, then type /mabi-start.

   claude

   Copy commandWhere: PowerShell inside the cloned folder

   Checked on 2026-09-20 / Source KwangB, Open source repository README (MIT) (from the document)

   An unofficial fan project, not affiliated with Nexon. The repository says so itself.

   Done