@1pass/mcp — Claude/Cursor에서 logi 조작
Claude Code, Claude Desktop, Cursor 등 MCP를 지원하는 AI 도구에서 자연어로 logi를 관리합니다.
예: "내 logi 로그인 이력 최근 10건 보여줘", "easybracket 앱에 staging redirect URI 추가해줘"
개발 시점(dev-time) 전용 도구
@1pass/mcp는 RP를 logi에 온보딩하는 동안에만 쓰는 임시 개발 도구입니다. 앱의 런타임 의존성이 아닙니다 — 배포되는 애플리케이션은 이 MCP 서버 없이 동작하며, 인증은 SDK/OAuth 흐름만으로 완결됩니다.
용도: 내 OAuth 앱 확인·redirect URI 추가와 제거·연동 중 문서 조회 등 셋업 보조. 온보딩이 끝나면 아래처럼 언마운트(제거)해도 됩니다.
두 가지 사용 모드
| 모드 | 누구 | 무엇을 |
|---|---|---|
| End-User 모드 | 일반 사용자 | 본인 로그인 이력, Passkey, 연결된 앱 확인 |
| Developer 모드 | OAuth 앱 개발자 | 내 OAuth 앱 조회, redirect URI 추가·제거 |
도구 15개(End-User 8 · Developer 4 · Docs 3)가 항상 모두 노출됩니다. PAK(Personal API Key)에 그 도구가 요구하는 scope 가 없으면 서버가 호출을 403 insufficient_scope 로 거절합니다.
설치
npm 에 @1pass/mcp 로 배포되어 있습니다. Claude Code 는 플러그인 설치가 가장 간단합니다 (AI 어시스턴트 가이드 참고). 수동 설정은 아래처럼 합니다.
~/.claude.json (Claude Code):
{
"mcpServers": {
"logi": {
"command": "npx",
"args": ["-y", "@1pass/mcp"],
"env": {
"LOGI_API_URL": "https://api.1pass.dev",
"LOGI_API_KEY": "logi_pak_xxxxxxxxxxxxx"
}
}
}
}LOGI_API_URL 을 빼면 http://localhost:3000 으로 붙으니 반드시 넣습니다. Node 20 이상이 필요합니다.
PAK 발급은 start.1pass.dev → API Keys 또는 /api/v1/me/api_keys에서 합니다. 쓸 도구에 맞춰 scope 를 고릅니다.
- End-User 모드:
login_history:read·login_history:write·passkeys:read·passkeys:manage·profile:read(연결 확인용logi_whoami는apps:read도 필요) - Developer 모드:
apps:read(조회) ·apps:manage(redirect URI 변경)
End-User 모드 도구 (8종)
| Tool | 설명 | 필요 scope |
|---|---|---|
logi_whoami | PAK 연결 확인 (앱 목록 조회로 키를 검증) | apps:read 또는 apps:manage |
logi_list_login_history | 최근 로그인 이력 | login_history:read |
logi_delete_login_log | 특정 로그 소프트 삭제 (90일 안에 복구 가능) | 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 | 내가 허용한 외부 앱 + 공유한 정보 보기 | profile: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 정리해줘
> 내 이메일을 볼 수 있는 앱이 뭐야?Developer 모드 도구 (4종)
내가 소유한 OAuth 앱(RP)을 확인하고 redirect URI 를 바꿉니다.
| Tool | 설명 | 필요 scope |
|---|---|---|
logi_list_apps | 내가 소유한 앱 목록 (id·client_id·상태·redirect URI) | apps:read 또는 apps:manage |
logi_show_app | 앱 하나의 전체 설정 | apps:read 또는 apps:manage |
logi_add_redirect_uri | redirect URI 추가 (이미 있으면 그대로) | apps:manage |
logi_remove_redirect_uri | redirect URI 제거 (마지막 하나는 거절) | apps:manage |
logi_list_connected_apps 는 사용자로서 허용한 남의 앱이고, logi_list_apps 는 개발자로서 소유한 내 앱입니다.
앱 생성·client_secret 회전·앱 삭제·팀 초대·감사 로그 조회는 MCP 도구가 없습니다. Developer Console(웹) 에서 합니다. 네이티브(iOS/Android) 앱에는 어느 경우에도 노출되지 않습니다.
개발자 사용 예시
> 내 logi 앱 목록 보여줘
> easybracket 앱에 https://staging.easybracket.org/auth/callback 추가해줘
> 옛 onrender.com 콜백 주소는 지워줘흐름
Claude 가 도구를 부르고 결과를 받은 뒤 다음 작업을 제안합니다. 예: redirect URI 를 추가한 뒤 logi_show_app 으로 반영됐는지 확인.
보안
- PAK 는 환경 변수로만 넣고,
Authorization: Bearer헤더로만 보냅니다. MCP 서버는 시작할 때 서버 주소와 키 설정 여부(set/MISSING)만 출력하고 키 값은 출력하지 않습니다. - redirect URI 추가·제거는 서버가 URI 형식·허용 호스트를 검사하고, 변경 이력을 남깁니다.
- 되돌릴 수 없는 Passkey 삭제와 redirect URI 변경 도구는 부르기 전에 사용자에게 확인하도록 도구 설명에 적혀 있습니다. 로그 삭제는 90일 안에 복구할 수 있습니다.
온보딩 완료 후 제거
@1pass/mcp는 dev-time 도구이므로, RP 온보딩(앱 등록·redirect URI·secret·연동 검증)이 끝나면 AI 도구 설정에서 제거(언마운트)해도 됩니다. 제거해도 배포된 앱의 로그인은 그대로 동작합니다 — 런타임은 MCP에 의존하지 않기 때문입니다.
1. 설정에서 logi 블록 삭제
~/.claude.json (Claude Code)에서 mcpServers 아래의 logi 항목 전체를 삭제합니다. 아래 블록이 제거 대상입니다:
{
"mcpServers": {
"logi": {
"command": "npx",
"args": ["-y", "@1pass/mcp"],
"env": {
"LOGI_API_URL": "https://api.1pass.dev",
"LOGI_API_KEY": "logi_pak_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 해 두는 것을 권장합니다.
나중에 redirect URI 변경 등이 다시 필요하면 설치 단계를 반복해 언제든 다시 마운트할 수 있습니다.