MCP 서버

ccmux를 사용하세요 MCP 코딩 에이전트가 세션을 검사하고, 프로젝트 노트를 읽고, 사용량을 확인할 수 있도록 서버를 제공합니다. 세션 생성, 키 입력 및 종료는 변형을 활성화한 경우에만 사용할 수 있습니다.

서버 바이너리는 ccmux v0.3.0 이상에 포함되어 있습니다. ccmux 설치 클라이언트에 연결하기 전에 해당 데몬이 실행되고 있는지 확인하세요.

배선해

Claude Code에서 사용자 계정용 로컬 stdio 서버를 등록하세요:

claude mcp add --transport stdio --scope user ccmux -- ccmux-mcp

실행 /mcp Claude Code 내부에서 연결을 확인하세요. 보다 Claude Code의 MCP 문서 구성 범위 및 문제 해결을 위해.

프로젝트 범위 구성의 경우 다음을 사용합니다. .mcp.json 프로젝트 루트에서:

{
  "mcpServers": {
    "ccmux": { "command": "ccmux-mcp" }
  }
}

다른 MCP 클라이언트는 자체 설정 형식을 사용합니다. stdio 서버를 추가하고 다음 명령을 지정하세요: ccmux-mcp; 클라이언트가 PATH에서 바이너리를 찾을 수 없으면 바이너리의 절대 경로를 사용하십시오.

이제 에이전트에는 다음 도구가 있습니다.

이 도구는 읽기 전용입니다. 연결된 데몬에 사용 가능한 정보를 노출합니다.

하고 싶은 일이 있을 때

추가 --allow-mutate 를 서버 인수에 추가합니다. 프로젝트 범위 Claude Code 구성의 경우:

{
  "mcpServers": {
    "ccmux": { "command": "ccmux-mcp", "args": ["--allow-mutate"] }
  }
}

그러면 다음이 잠금 해제됩니다.

기본적으로 꺼진 이유는 다음과 같습니다. send_keys 은 귀하가 입력할 수 있는 모든 것을 입력할 수 있는 에이전트입니다. 플래그는 선택 사항입니다. 도구별 재정의가 없습니다. 전체 변경 세트를 켜거나 끄면 됩니다.

플래그가 없으면 돌연변이 도구가 없습니다. tools/list. 인수를 변경한 후 클라이언트를 통해 MCP 서버를 다시 시작합니다.

원격 머신 구동

CCMUX_HOST=mini.tail-xxxxx.ts.net:7474 ccmux-mcp
# or
ccmux-mcp --host mini.tail-xxxxx.ts.net:7474

에이전트는 로컬로 실행되고 Mac mini에서 데몬을 쿼리합니다. 돌연변이 도구에는 여전히 필요합니다. --allow-mutate. 동일한 프로토콜, 동일한 도구 — 로컬 Unix 소켓 대신 Tailscale HTTP 바로 위에 있습니다. "노트북에서 코딩 중인데 밤샘 작업인 Claude 작업은 미니에서 하는 경우"에 유용합니다.

이게 실제로 무슨 용도인지

몇 가지 구체적인 모양:

다중 세션 오케스트레이션. 한 세션의 에이전트가 다른 세션에서 도우미를 생성합니다(spawn_session 다른 프로젝트에서) 완료되면 출력을 읽습니다(read_pane), 결과를 다시 가져와 도우미를 죽입니다. 루프에 인간이 없습니다.

교차 기계 작업. 노트북에 있는 에이전트가 Mac mini에 있는 형제의 상태를 확인합니다(list_sessions, read_pane), SSH를 사용하지 않고. 또는 미니에서 장기 실행 빌드를 시작합니다(spawn_session MCP 서버를 구성한 후 --host 그리고 --allow-mutate) 로컬 작업을 계속합니다.

프로젝트 메모리입니다. 에이전트는 세션 시작 시 프로젝트 메모를 읽습니다(list_notes + read_note) 이전 에이전트가 수행한 작업을 반복하지 않습니다. 메모는 디스크에 일반 마크다운으로 표시됩니다. 상담원은 그것을 알 필요가 없습니다.

비용 인식. 대작을 시작하기 전 상담원이 확인하는 사항 get_usage 이번 주에 지출한 금액을 확인하고 get_daemon_health 이미 실행 중인 세션 수를 확인합니다.

이 중 어느 것도 새로운 인프라가 필요하지 않습니다. ccmux는 이미 모든 것을 가지고 있었습니다. MCP는 에이전트가 액세스할 수 있게 만드는 프로토콜일 뿐입니다.

보안 모델

• 운송. stdio를 사용합니다. 데몬의 Unix 소켓은 사용자 범위로 제한되며, HTTP 연결에는 같은 tailnet에 대한 접근 권한이 필요합니다.
• 돌연변이. 깃발을 뒤집지 않으면 꺼집니다.
• 제한된 읽기입니다. read_pane 은 500줄로 제한되므로 버그가 있는 에이전트는 호출할 때마다 전체 스크롤백을 요청하는 데몬을 아래로 끌 수 없습니다.
• 통화별 마감 기한입니다. 모든 핸들러는 30초 컨텍스트에서 실행됩니다.

전류 제한

서버는 요청/응답 도구를 제공합니다. 실시간 구독, 도구별 변형 권한 및 프롬프트 라이브러리는 현재 사용할 수 없습니다.

관련 가이드

• 원격 호스트 구성 데몬을 대상으로 하기 전에.
• HTTP API 참조 자료 읽기 ccmuxd에 대해 직접 클라이언트를 빌드합니다.

오류나 오래된 내용을 발견하셨나요? GitHub에서 이 페이지를 편집하세요..