Skip to content

@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):

json
{
  "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_whoamiPAK 연결 확인 (앱 목록 조회로 키를 검증)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_passkeysPasskey 목록passkeys:read
logi_delete_passkeyPasskey 삭제 (되돌릴 수 없음)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_quickstartagent quickstart 가이드 (lang=ko|en)—
logi_get_doc특정 doc path fetch (guide/, oauth/, cli/ 등 허용 prefix)—
logi_list_docsllms.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_uriredirect URI 추가 (이미 있으면 그대로)apps:manage
logi_remove_redirect_uriredirect 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 항목 전체를 삭제합니다. 아래 블록이 제거 대상입니다:

json
{
  "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 변경 등이 다시 필요하면 설치 단계를 반복해 언제든 다시 마운트할 수 있습니다.

다음 ​

Identity가 제품의 신뢰를 만듭니다.