@logi/mcp — Claude/Cursor에서 logi 조작

Claude Code, Claude Desktop, Cursor 등 MCP를 지원하는 AI 도구에서 자연어로 logi를 관리합니다.

예: "내 logi 앱 중 production tier가 아닌 것 모두 보여줘", "alice@example.com 한테 admin 권한으로 초대 보내줘"

두 가지 사용 모드

모드	누구	무엇을
End-User 모드	일반 사용자	본인 로그인 이력, Passkey, 연결된 앱 관리
Developer 모드	OAuth 앱 개발자	OAuth 앱 CRUD, secret 회전, 팀 관리

발급받는 PAK(Personal API Key)의 scope에 따라 노출되는 도구 셋이 달라집니다.

설치

출시 전

정식 npm publish 이전입니다. 현재는 로컬 빌드 후 직접 연결.

git clone https://github.com/seunghan91/logi.git
cd logi/mcp && npm install && npm run build

~/.claude.json (Claude Code):

{
  "mcpServers": {
    "logi": {
      "command": "node",
      "args": ["/Users/you/toy/logi/mcp/dist/index.js"],
      "env": {
        "LOGI_API_URL": "https://api.1pass.dev",
        "LOGI_TOKEN": "lpa_pat_xxxxxxxxxxxxx"
      }
    }
  }
}

publish 이후:

{
  "command": "npx",
  "args": ["-y", "@logi-auth/mcp"]
}

PAK 발급은 start.1pass.dev → API Keys 또는 /api/v1/me/api_keys에서. End-User 모드면 login_history:read 등을, Developer 모드면 apps:manage와 apps:read를 체크.

End-User 모드 도구 (8종)

Tool	설명	필요 scope
logi_whoami	연결 상태 + 계정 확인	—
logi_list_login_history	최근 로그인 이력	login_history:read
logi_delete_login_log	특정 로그 소프트 삭제	login_history:write
logi_list_trashed_logs	휴지통 조회	login_history:write
logi_restore_login_log	복구	login_history:write
logi_list_passkeys	Passkey 목록	passkeys:read
logi_delete_passkey	Passkey 삭제	passkeys:manage
logi_list_connected_apps	연결된 앱 + 권한 보기	apps:read

사용 예시

> 내 logi 로그인 이력 최근 10건 보여줘
> 어제 의심스러운 로그인 있었어? 한국 외 지역만 필터.
> 더 이상 안 쓰는 Passkey 정리해줘
> Notion 연결 해제하고 싶어

Developer 모드 도구 (출시 예정)

OAuth 앱 개발자가 Claude/Cursor에서 자연어로 앱을 관리:

Tool	설명	필요 scope
logi_apps_list	내 조직의 앱 목록	apps:read
logi_apps_create	새 앱 등록	apps:manage
logi_apps_show	앱 상세	apps:read
logi_apps_edit	메타·redirect URI 수정	apps:manage
logi_apps_rotate_secret	client_secret 회전	apps:manage
logi_apps_delete	앱 삭제	apps:manage
logi_team_invite	멤버 초대	org:manage
logi_audit_logs	감사 로그 조회	org:read

개발자 사용 예시

> "Demo Test App"의 client_secret 회전하고 새 값을 .env에 적어줘
> 우리 조직에 alice@example.com을 admin으로 초대해줘
> 지난주 redirect URI 변경한 사람 누구야?
> staging 환경 앱 새로 하나 만들고 redirect_uri는 https://staging.acme.com/cb

흐름

Claude가 도구 호출 → 결과 반환 → 다음 작업 제안. 예: secret 회전 후 자동으로 .env 파일 업데이트 제안.

보안

• 모든 호출은 PAK 인증 (env로만 주입, 메모리·로그 노출 X)
• 민감 작업(삭제, secret 회전)은 향후 iOS 앱 step-up 푸시 승인 추가 예정
• MCP 서버는 stdout/stderr에 PAK prefix 8자만 출력, 본문 마스킹

다음

• PAK 발급 + scope 모델
• 감사 로그 — 누가 무엇을 했는지
• CLI도 지원