본문으로 건너뛰기
Kiku.sh

에이전트

에이전트 연결하기.

어떤 에이전트가 무엇을 읽을지 정하고 나면, Claude Code, Claude Desktop, Cursor 또는 직접 만든 스크립트가 Mac에서 Kiku를 통해 통화를 읽을 수 있습니다. 세 단계면 됩니다.

  1. 1에이전트 켜기

    Kiku의 설정에서 ‘에이전트’ 아래의 ‘에이전트가 통화를 읽도록 허용’을 켜세요. ‘메모리’도 켜져 있어야 합니다. Kiku는 실행 중일 때 에이전트에 응답합니다.

  2. 2에이전트 연결

    ‘에이전트 연결’을 클릭하고 Claude처럼 이름을 붙이세요. 무엇을 읽을지(‘메모’ 또는 ‘메모와 인용’), 어떤 통화를 읽을지(‘최근 90일’, ‘전체’ 또는 ‘지금부터’), 얼마 동안 읽을지(‘30일’, ‘90일’ 또는 ‘취소할 때까지’) 고르세요.

  3. 3키 복사

    Kiku는 kk_로 시작하는 에이전트의 키를 한 번만 보여 주며, 아래의 설정 줄도 미리 채워 둡니다. 지금 복사하세요. Kiku는 키의 지문만 보관합니다.

MCP

에이전트에 Kiku 추가하기.

Kiku의 MCP 서버는 앱 안에 있는 kiku 도우미입니다. 에이전트가 KIKU_TOKEN에 담긴 키로 알아서 실행합니다. 줄에 kk_...라고 적힌 곳에 키를 넣으세요.

Claude Code

터미널에서, 모든 프로젝트에 적용:

claude mcp add --scope user kiku -e KIKU_TOKEN=kk_... -- /Applications/Kiku.app/Contents/Helpers/kiku mcp

그다음 Claude Code에서 /mcp를 입력하면 kiku와 그 도구들이 나옵니다.

Claude Desktop

Claude에서 설정, 개발자, 구성 편집을 누르면 claude_desktop_config.json이 열립니다. 다음을 추가하고 Claude를 다시 시작하세요:

{
  "mcpServers": {
    "kiku": {
      "command": "/Applications/Kiku.app/Contents/Helpers/kiku",
      "args": [
        "mcp"
      ],
      "env": {
        "KIKU_TOKEN": "kk_..."
      }
    }
  }
}

Cursor

모든 프로젝트에는 ~/.cursor/mcp.json에, 한 프로젝트에만은 .cursor/mcp.json에 같은 블록을 넣으세요(키는 git에 올리지 마세요). 그다음 Cursor 설정의 MCP에서 kiku를 켜세요.

그 밖의 MCP 앱

명령 /Applications/Kiku.app/Contents/Helpers/kiku, 인수 mcp, 그리고 KIKU_TOKEN 환경 변수에 키.

그다음 이렇게 물어보세요. “출시일에 대해 뭐라고 결정했지?” 또는 “오늘 아침 통화의 후속 메일을 써 줘.”

명령줄

스크립트를 위한 kiku api.

같은 도우미가 셸에서도 응답하며, 작업마다 하위 명령이 하나씩 있습니다. kiku api는 전체 목록을, kiku api list_meetings --help는 하나의 설명을 보여 줍니다. 파이프로 넘기면(또는 --json을 붙이면) JSON을, 터미널에서는 표를 출력합니다.

export KIKU_TOKEN=kk_...
alias kiku=/Applications/Kiku.app/Contents/Helpers/kiku
kiku api list_meetings --since 7d
kiku api get_meeting 1791194400000-launch01 --json | jq .result.notes
kiku api brief --people "Léa Martin" --people "Tom Becker"

로컬 API

Mac에 머무는 REST API.

그 바탕에는 Kiku 폴더 안의 소켓 위에서 돌아가는 REST API가 있고, 이 소켓은 본인만 열 수 있습니다. 네트워크 포트가 없으니 어떤 웹 페이지도, 다른 사용자도 닿을 수 없습니다. API는 /v1/openapi.json에서, 그리고 페이지를 읽는 에이전트를 위해 /v1/llms.txt에서 스스로를 설명합니다. 모든 응답은 출처가 된 통화를 밝힙니다.

curl --unix-socket "$HOME/Library/Application Support/Kiku/api.sock" \
  -H "Authorization: Bearer $KIKU_TOKEN" \
  "http://localhost/v1/meetings?since=7d"

응답하는 것

search
키워드로 지난 통화를 찾고, 가장 잘 맞는 것부터 일치하는 줄과 함께 보여 줍니다.
list_meetings
통화를 최신순으로, 날짜, 사람 또는 앱별로.
get_meeting
한 통화의 노트: 요약, 결정 사항, 다음 할 일.
list_people
Kiku가 통화에서 알게 된 사람들.
get_person
어떤 사람과의 통화, 그리고 서로에게 남은 다음 할 일.
list_commitments
아직 남은 다음 할 일, 내 것이든 상대의 것이든.
list_decisions
어떤 주제에 대해 결정된 것.
brief
이 사람들과의 회의 전 브리핑.

응답이 없다면

unauthorized
Kiku가 모르는 키입니다. 에이전트가 취소됐거나 키가 잘못 입력됐습니다.
off
Kiku의 설정에서 ‘에이전트’가 꺼져 있습니다.
needs_app
Kiku가 실행 중이 아닙니다. 열어 주세요.

여러분의 손에

여러분에게 남는 것.

Kiku 자체는 아무것도 보내지 않습니다. 연결한 에이전트는 보통 답하기 위해 읽은 내용을 그 모델의 회사로 보내고, 통화에 함께한 다른 사람들은 그것을 선택하지 않았습니다. 이 Mac에서 여러분의 권한으로 실행되는 프로그램은 Kiku의 폴더를 직접 읽을 수도 있습니다. 키는 그 프로그램들이 Kiku를 통해 얻는 것만 제어합니다.

Claude Code는 셸을 통해 파일을 읽을 수 있습니다. 허용한 범위로 제한하려면 ~/.claude/settings.json에 다음을 추가하세요:

"permissions": {
  "deny": [
    "Read(~/Library/Application Support/Kiku/**)",
    "Bash(*Application Support/Kiku*)"
  ]
}