Integration Guide  ·  연동 가이드

Claude Code Desktop

ArkComposer as MCP Server · 대화로 작곡하기

Connect ArkComposer to Claude Code Desktop via MCP stdio mode.
Once connected, you can compose, edit, and arrange music entirely through natural language conversation.
ArkComposer를 Claude Code Desktop에 MCP로 연결하면, 자연어 대화만으로 작곡·편집·편곡이 가능합니다.

01
Configure JSON
JSON 설정 등록
Add ArkComposer to claude_desktop_config.json via Settings → Developer

설정 → 개발자 → 구성 편집에서 JSON에 등록
02
Enable Connector
커넥터 활성화
Open Claude Code Desktop → Click + → Connector → Toggle arkcomposer ON

커넥터 메뉴에서 arkcomposer 토글 활성화
03
Compose via Chat
대화로 작곡
Type your musical intent in natural language. Claude composes directly into ArkComposer in real time.

자연어로 원하는 음악을 말하면 Claude가 실시간으로 악보를 작성합니다.
01
Settings → Developer → Edit Config
설정 → 개발자 → 구성 편집

Open Claude Code Desktop. Go to Settings (설정) → Developer (개발자) → Click Edit Config (구성 편집).
This opens claude_desktop_config.json in your editor.
Claude Code Desktop 실행 → 설정 → 개발자 → 구성 편집 클릭 → JSON 파일이 편집기에서 열립니다.

Claude Code Desktop Settings - Developer - Edit Config
Settings → Developer → Edit Config (구성 편집) → claude_desktop_config.json

Add the arkcomposer entry inside mcpServers. Set the command to the full path of your ArkComposer.exe.
mcpServers 안에 arkcomposer 항목을 추가하고, command에 ArkComposer.exe의 전체 경로를 입력합니다.

{ "mcpServers": { "arkcomposer": { "command": "C:\\path\\to\\ArkComposer.exe", "args": ["--mcp-mode"] } } } // Example from actual config · 실제 설정 예시: { "mcpServers": { "arkcomposer": { "command": "D:\\Source\\ArkComposer\\Builds\\VisualStudio2022\\Exec\\ArkComposer.exe", "args": ["--mcp-mode"] } } }
✅ Tip
Windows paths require double backslashes \\ in JSON.
Save the file and restart Claude Code Desktop to apply.
Windows 경로는 JSON에서 역슬래시를 두 번 \\ 써야 합니다. 저장 후 Claude Code Desktop을 재시작하세요.
02
Enable arkcomposer Connector
커넥터에서 arkcomposer 활성화

In the chat input area, click the + button → Connector (커넥터) → Toggle arkcomposer to ON (blue).
Once enabled, Claude Code Desktop will launch ArkComposer automatically in MCP stdio mode.
채팅 입력창의 + 버튼 → 커넥터 → arkcomposer 토글을 켜세요. 활성화하면 ArkComposer가 MCP stdio 모드로 자동 실행됩니다.

Claude Code Desktop Connector Menu - arkcomposer enabled
+ → Connector (커넥터) → arkcomposer toggle ON
03
Compose through Conversation
대화로 작곡하기

Once connected, simply describe the music you want. Claude will plan the structure, call ArkComposer's MCP tools, and build the score — all in one conversation.
연결되면 원하는 음악을 자연어로 설명하세요. Claude가 구조를 설계하고 MCP 도구를 호출해 악보를 실시간으로 완성합니다.

Launch ArkComposer and compose a 20-measure introduction in a sad ballad style with a breakup theme. Prefer using the batch tool to save tokens.
Claude · arkcomposer MCP
I'll set up the composition — a sad ballad in A minor, 4/4, at 60 BPM with piano (treble + bass) and strings. Let me build it all in structured batches.

Structure plan:
mm. 1–4: Am → F → C → E7 (intro, piano alone, sparse)
mm. 5–8: Am → Dm → G → C (strings enter softly)
mm. 9–12: Am → F → Dm → E (emotional swell)
mm. 13–16: Am → G → F → E7 (peak tension)
mm. 17–20: Am → Dm → E → Am (resignation, decay)
→ add_notes_batch · All 122 notes placed in a single batch call
Claude composing Last Letter - Breakup Ballad with ArkComposer MCP
Claude planning and composing 20 measures · 122 notes in a single batch call 한 번의 배치 호출로 20마디 122개 음표 작성
ArkComposer score - Last Letter Breakup Ballad initial result
ArkComposer score — real-time result of Claude's composition Claude가 작곡한 결과가 ArkComposer에 실시간 반영된 모습

You can also edit the score through conversation — delete tracks, modify passages, or restructure the arrangement, all by chatting.
대화로 트랙 삭제, 구간 수정, 편곡 변경 등 악보 편집도 가능합니다.

you made 4 tracks. delete track 0, and track3.
Claude · arkcomposer MCP
Let me check the current score first to confirm the track indices.
Confirmed. Deleting track 3 first (to avoid index shift), then track 0.
Done. Deleted in reverse order (3 → 0) to prevent index shifting.

Remaining tracks: Piano Right (Grand Piano), Piano Left (Grand Piano)
→ get_score · delete_track(3) · delete_track(0)
Claude deleting tracks via MCP conversation
Track deletion via natural language — Claude handles index order automatically 자연어로 트랙 삭제 — 인덱스 순서는 Claude가 자동으로 처리
ArkComposer final score after editing
Final score after editing — Last Letter: Breakup Ballad · Piano + String Ensemble 편집 완료 후 최종 악보 — Last Letter: Breakup Ballad
04
How to Disconnect & Close
종료 방법

Always disable the connector before closing ArkComposer to ensure a clean shutdown.
ArkComposer를 닫기 전에 반드시 커넥터를 먼저 비활성화하세요.

⚠️ Warning
Closing ArkComposer without disabling the connector first may cause Claude Code Desktop to hang or show MCP errors on the next session.
커넥터를 비활성화하지 않고 ArkComposer를 먼저 닫으면 다음 세션에서 MCP 오류가 발생할 수 있습니다.
—
Troubleshooting
문제 해결

If ArkComposer is not responding, tools are not loading, or the connection feels stuck — follow these steps.
ArkComposer가 응답하지 않거나, 도구가 로드되지 않거나, 연결이 불안정하면 아래 방법을 시도하세요.

💡 Key Rule · 핵심 원칙
When something goes wrong, a full restart almost always fixes it.
The most common cause of issues is a leftover Claude or ArkComposer process in memory.
Always verify via Task Manager that both processes are completely gone before restarting.
문제가 생기면 완전 재시작이 거의 항상 해결책입니다.
가장 흔한 원인은 메모리에 남아있는 Claude 또는 ArkComposer 프로세스입니다.
재시작 전 작업 관리자에서 두 프로세스가 완전히 없어졌는지 반드시 확인하세요.
—
Tips for Better Results
더 좋은 결과를 위한 팁