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

Source: reference/mcp.md · Live: https://docs.1pass.dev/reference/mcp LLM-sanitized: internal links absolutized, VitePress containers → admonitions, line numbers in the Jump-to Index reference this rendered file (1-indexed).

📍 Jump-to Index

• L32-L40: ## 두 가지 사용 모드
• L41-L73: ## 설치
• L74-L86: ## End-User 모드 도구 (8종)
• L87-L111: ## Docs 도구 (3종, 인증 불필요)
  • L103-L111: ### 사용 예시
• L112-L140: ## Developer 모드 도구 (출시 예정)
  • L129-L140: ### 개발자 사용 예시
• L141-L146: ## 보안
• L147-L183: ## 온보딩 완료 후 제거
• L184-L189: ## 다음

---

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

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

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

🚨 Danger: 개발 시점(dev-time) 전용 도구 @logi/mcp는 RP를 logi에 온보딩하는 동안에만 쓰는 임시 개발 도구입니다. 앱의 런타임 의존성이 아닙니다 — 배포되는 애플리케이션은 이 MCP 서버 없이 동작하며, 인증은 SDK/OAuth 흐름만으로 완결됩니다.

용도: OAuth 앱 등록·redirect URI 설정·secret 회전·연동 중 문서 조회 등 셋업 보조. 온보딩이 끝나면 아래처럼 언마운트(제거)해도 됩니다.

두 가지 사용 모드

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

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

설치

⚠️ Warning: 출시 전 정식 npm publish 이전입니다.

~/.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_API_KEY": "lpa_pat_xxxxxxxxxxxxx"
      }
    }
  }
}

publish 이후:

{
  "command": "npx",
  "args": ["-y", "@logi/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

Docs 도구 (3종, 인증 불필요)

API 키 설정 없이도 동작합니다. docs.1pass.dev/llms/* 의 public markdown 미러를 fetch — 에이전트가 logi 통합 시 첫 시도에서 정확한 문서를 참조하도록 설계 (LangChain mcpdoc 패턴).

Tool	설명	필요 scope
logi_fetch_quickstart	agent quickstart 가이드 (lang=ko|en)	—
logi_get_doc	특정 doc path fetch (guide/, oauth/, cli/ 등 허용 prefix)	—
logi_list_docs	llms.txt 사이트맵 — 사용 가능한 doc 경로 목록	—

> logi 통합 어떻게 해? (→ logi_fetch_quickstart)
> OAuth scope 종류 알려줘 (→ logi_get_doc path=oauth/scopes.md)
> logi docs 뭐 있어? (→ logi_list_docs)

사용 예시

> 내 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

감사 로그(audit logs) 조회는 현재 Developer Console (웹) 에서 합니다 — logi_audit_logs 등 위 Developer 모드 MCP 도구는 출시 예정이며, 어느 경우에도 네이티브(iOS/Android) 앱에는 노출되지 않습니다.

개발자 사용 예시

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

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

보안

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

온보딩 완료 후 제거

@logi/mcp는 dev-time 도구이므로, RP 온보딩(앱 등록·redirect URI·secret·연동 검증)이 끝나면 AI 도구 설정에서 제거(언마운트)해도 됩니다. 제거해도 배포된 앱의 로그인은 그대로 동작합니다 — 런타임은 MCP에 의존하지 않기 때문입니다.

1. 설정에서 logi 블록 삭제

~/.claude.json (Claude Code)에서 mcpServers 아래의 logi 항목 전체를 삭제합니다. 아래 블록이 제거 대상입니다:

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

logi가 유일한 항목이면 mcpServers 객체째 비우거나 지워도 됩니다.

Cursor·Claude Desktop 등 다른 도구도 각자의 MCP 설정 파일(예: Claude Desktop은 claude_desktop_config.json, Cursor는 .cursor/mcp.json)에서 logi 블록을 동일하게 삭제합니다.

2. AI 도구 재시작

Claude Code / Claude Desktop / Cursor를 재시작하면 logi MCP 도구가 더 이상 로드되지 않습니다.

3. (선택) PAK 폐기

더 이상 쓰지 않을 PAK는 start.1pass.dev → API Keys에서 revoke 해 두는 것을 권장합니다.

나중에 앱 관리·secret 회전 등이 다시 필요하면 설치 단계를 반복해 언제든 다시 마운트할 수 있습니다.

다음

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