MCP Server KR

🔌 MCP 서버

🔌 English · 한국어

MCP 클라이언트(Claude Desktop, Claude Code)에서 AI와 대화하며 CLITrigger를 제어하세요 — 프로젝트 조회, 할일 생성·실행, 상태 확인. CLITrigger는 로컬·원격 MCP 클라이언트가 붙을 수 있는 HTTP MCP 엔드포인트를 제공합니다.

연결

CLITrigger를 켜 둡니다. MCP 엔드포인트는 서버 안에서 동작하므로, 앱(또는 clitrigger)이 떠 있는 동안만 사용할 수 있습니다. 앱을 종료하면 도구도 응답하지 않습니다.
사이드바 ⚙ → 설정 → MCP 를 엽니다. 카드에 서버 URL과 접근 토큰이 이미 채워진 복붙용 config가 표시됩니다 — 포트를 몰라도 됩니다.
쓰는 MCP 클라이언트에 등록합니다:

Claude Code — 카드의 원커맨드를 그대로 실행:

claude mcp add --transport http clitrigger http://localhost:3000/mcp --header "Authorization: Bearer <token>"

Claude Desktop — 카드의 JSON 블록을 설정 → Connectors → 커스텀 커넥터 추가로 등록하거나, claude_desktop_config.json에 붙여넣습니다:

{
  "mcpServers": {
    "clitrigger": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Claude Desktop 버전의 설정이 stdio 서버만 지원한다면 mcp-remote로 우회하세요:
{ "mcpServers": { "clitrigger": {
  "command": "npx",
  "args": ["mcp-remote", "http://localhost:3000/mcp", "--header", "Authorization: Bearer <token>"]
}}}

AI에게 요청합니다: "CLITrigger 프로젝트 목록 보여줘", "myapp 프로젝트에 '로그인 버그 수정' 할일 만들고 실행해줘".

npm, 데스크톱 앱, 원격(터널) 사용자 모두 동일하게 동작합니다 — 엔드포인트가 실행 중인 서버의 일부이기 때문입니다. 원격이면 config의 URL만 localhost 대신 터널 주소가 됩니다.

도구

도구	하는 일
`list_projects`	등록된 모든 프로젝트 목록
`create_project`	새 프로젝트 등록 (이름 + 로컬 경로)
`create_todo`	프로젝트에 할일(TODO) 생성
`start_todo`	할일 실행 시작 (기본 headless)
`stop_todo`	실행 중인 할일 중지
`get_project_status`	프로젝트 실행 상태 요약
`get_todo_logs`	할일의 실행 로그

이 도구들로 헤드리스 태스크 흐름을 처음부터 끝까지 다룰 수 있습니다 — 웹 UI를 열지 않고 작업을 만들고 실행합니다. 인터랙티브 터미널 세션(실시간 스트리밍 입출력)은 MCP로 노출되지 않습니다.

접근 토큰

CLITrigger는 첫 실행 시 토큰을 생성해 로컬에 저장하며, 설정 → MCP 카드가 현재 토큰을 복붙용 config에 포함해 보여줍니다. 서버에 접근할 수 있고 이 토큰을 가진 사람은 누구나 전체 API 권한을 얻습니다 — 비밀번호처럼 취급하고, 터널로 서버를 노출할 때 특히 주의하세요.