kmsg 개발자 리소스

이 페이지는 kmsg를 script, local automation, coding agent 또는 MCP client에 연결할 때 필요한 first-party 문서를 예측 가능한 한곳에 모읍니다. kmsg의 public interface는 macOS에서 실행되는 CLI, structured JSON output, newline event stream, native stdio MCP server입니다.

CLI와 structured JSON API

사용법 문서는 command, option, environment variable, output format과 troubleshooting을 다룹니다. kmsg chats, kmsg read, kmsg watch는 structured JSON을 제공하고 진단용 AX trace는 stderr로 분리합니다. kmsg는 hosted HTTP API나 REST OpenAPI specification을 제공하지 않습니다. 따라서 API key를 발급하거나 network endpoint에 request를 보내는 방식이 아니라 설치한 binary를 local process로 호출해야 합니다.

Authentication 문서

kmsg authentication은 KakaoTalk desktop login과 macOS Accessibility permission을 확인하는 local flow입니다. kmsg auth login은 필요한 credential을 사용자의 Mac에 암호화해 저장하며, terminal이 없는 caller는 이미 저장된 credential에 의존합니다. hosted OAuth, bearer token, cloud account 또는 remote authentication endpoint는 없습니다. 상세한 lock-mode와 non-interactive 동작은 usage 문서의 authentication 절을 따릅니다.

MCP server

MCP 문서에 있는 kmsg mcp-server command는 stdio transport로 kmsg_read, kmsg_send, kmsg_send_image tool을 노출합니다. MCP client는 installed binary를 command로 실행하고 JSON-RPC를 standard input/output으로 교환합니다. 현재 first-party Streamable HTTP MCP endpoint나 /.well-known/mcp live handshake는 제공하지 않습니다. GitHub Pages는 static host이므로 POST 기반 MCP session을 가장하지 않습니다.

Events와 webhooks

실시간 message event는 kmsg watch --json을 별도 local process로 실행해 한 줄당 JSON object로 받습니다. kmsg는 public webhook delivery service나 callback registration API를 운영하지 않습니다. 외부 workflow가 webhook을 필요로 하면 사용자가 관리하는 supervisor가 local watch event를 검증하고 승인 정책을 적용한 뒤 자신의 endpoint로 전달해야 합니다. repository에는 제3자 webhook credential을 저장하지 마세요.

Source, architecture와 변경 계약

Architecture는 Accessibility wrapper, KakaoTalk domain service, command layer, cache와 MCP adapter의 경계를 설명합니다. source build는 Swift 6을 사용하며 release version은 repository VERSION과 tag로 관리합니다. contribution 전에는 current issue, tests, release policy를 확인하고 message send처럼 외부 상태를 바꾸는 변경에는 dry-run 또는 explicit confirmation 경계를 유지하세요.