테마
AI 어시스턴트 통합
Claude Code · Cursor · Codex 같은 AI 코딩 어시스턴트에서 logi RP 통합을 자동화하기 위한 skill/prompt 모음입니다. 이 페이지는 계속 업데이트됩니다.
외부 개발자 안내
이 페이지에 등록된 skill / prompt 는 본인 RP 환경에 그대로 적용 가능한 일반화 버전입니다. logi IdP 자체는 https://api.1pass.dev 에 라이브로 운영 중이므로 직접 호스팅할 필요가 없고, RP 등록은 logi CLI 또는 개발자 콘솔 을 통해 합니다.
통합 모드(OAuth / QR / App Clip / macOS) 가 어떻게 동작하는지 먼저 눈으로 확인하고 싶다면 demo.1pass.dev 의 시나리오 카탈로그를 둘러보세요.
llms.txt — 모든 AI 에이전트용 표준 엔드포인트
logi 의 모든 개발자 문서를 LLM 친화 마크다운으로 한 번에 받을 수 있는 엔드포인트가 있습니다. llmstxt.org 표준을 따르고, VitePress 전용 문법(:::tip 등) 은 일반 마크다운 admonition 으로, 사이트 상대 링크는 절대 URL 로 변환해두어 어떤 LLM 도 추가 해석 없이 바로 읽을 수 있습니다.
| 엔드포인트 | 용도 | 크기 |
|---|---|---|
https://docs.1pass.dev/llms.txt | 토픽 인덱스 + 1줄 요약 + 사용 가이드 | ~11 KB |
https://docs.1pass.dev/llms-full.txt | 전체 문서 한 파일 번들 | ~280 KB |
https://docs.1pass.dev/llms/<path>.md | 토픽별 분리본 (예: llms/guide/registering-apps.md) | 평균 6 KB |
어떻게 쓰나요?
작은 컨텍스트 모델 / 정확한 토픽이 정해진 경우 — 인덱스로 토픽 위치를 찾고 그 파일만 fetch:
bash
curl https://docs.1pass.dev/llms.txt | grep -i "registering"
curl https://docs.1pass.dev/llms/guide/registering-apps.md긴 컨텍스트 모델 / 전체를 한 번에 보고 싶은 경우 — 번들 통째로:
bash
curl https://docs.1pass.dev/llms-full.txtClaude Code 에서 직접 읽히기
세션 안에서 logi 통합 작업을 시작할 때 다음 한 줄을 prompt 에 붙이면 됩니다:
"logi 통합 전에 https://docs.1pass.dev/llms-full.txt 를 먼저 읽고 시작해줘."
Claude Code 의 WebFetch tool 이 자동으로 markdown 그대로 받아서 컨텍스트에 넣습니다. 이미 작성된 logi-rp-integrate skill 은 내부적으로 이 엔드포인트를 사용해 최신 가이드를 참조합니다.
Cursor / Continue / Aider 에서
대부분의 어시스턴트는 외부 URL 직접 fetch 가 안 되므로, 대신:
curl https://docs.1pass.dev/llms-full.txt > .cursor/logi-docs.md로 로컬 저장- Cursor settings → "Documentation" 에 추가하거나, Continue 의
@docs로 indexing - 이후 자연어로 "logi 등록 가이드대로 RP 추가" 같이 호출 → 모델이 indexed docs 참조
INFO
번들은 매 docs build 마다 자동 갱신됩니다. 6시간 이상 캐싱하면 stale 가이드를 참조할 수 있으니 CI 에서 정기 재다운로드 권장.
Claude Code skills
logi-rp-integrate — RP 통합 5분 자동화
기존 Rails / Flutter / Next.js / iOS 프로젝트에 logi SSO 를 RP 로 붙이는 표준 절차를 한 번의 skill 호출로 끝냅니다. 기술 스택 자동 감지 → 표준 컨트롤러/서비스 드롭인 → logi 서버에 RP 등록 → 배포 플랫폼 env 주입 → live 검증까지 7단계.
언제 트리거되는가
- "logi 로그인 적용" / "1pass 통합" / "logi RP 등록" / "logi SSO 추가" 같은 요청
- 다중 프로젝트에 일괄 적용 ("다른쪽에도 적용", "프로젝트 전반 적용")
핵심 명령 미리보기 (skill 본문에서 추출)
bash
# 1. RP 등록 (CLI 권장 — SSH fallback 도 있음)
logi apps create \
--name "$PROJECT" \
--redirect-uri "$SERVICE_URL/auth/logi/callback" \
--scope "openid profile:basic email"
# 2. 배포 플랫폼 env 4개 주입 (Render 예시)
# LOGI_API_URL / LOGI_CLIENT_ID / LOGI_CLIENT_SECRET / LOGI_SCOPES
# 3. Post-deploy host 검증 (자주 빠지는 단계)
curl -sI "$SERVICE_URL/auth/logi/start" | grep -i "^location:" \
| grep -q "api.1pass.dev" && echo "✓ env OK"설치 / 등록
- skill 파일을 본인 Claude Code skills 디렉토리에 추가합니다.bash
mkdir -p ~/.claude/skills/logi-rp-integrate curl -fsSL https://docs.1pass.dev/skills/logi-rp-integrate/SKILL.md \ -o ~/.claude/skills/logi-rp-integrate/SKILL.md - 본인 logi 계정으로 로그인합니다 (
logi login). - Claude Code 세션에서 "logi RP 등록해줘" 같은 자연어로 호출하면 자동으로 발동합니다.
환경별 설정 값
skill 은 다음 값들을 자동으로 감지하거나 프롬프트로 질문합니다. 미리 알아두면 작업이 빨라집니다.
| 항목 | 설명 | 예시 |
|---|---|---|
| logi API endpoint | RP 등록·OIDC 검증에 사용 | https://api.1pass.dev (기본값, 변경 불필요) |
| RP 서비스 도메인 | 본인 앱의 prod URL — redirect_uri 자동 생성에 사용 | https://app.example.com |
| 배포 플랫폼 | env 주입 방식 자동 분기 | Render / Vercel / Fly / Heroku / self-hosted |
| env prefix | 코드베이스 컨벤션 | LOGI_* (권장) |
| logi 계정 | logi login 으로 로그인된 계정 | 본인 logi developer 계정 |
Cursor rules
아직 없음. 추가 예정.
기타 어시스턴트 (Codex / Aider / Continue / ...)
아직 없음. 추가 예정.
기여하기
자체 어시스턴트용 skill / prompt / rule 등록 채널은 준비 중입니다.
관련 문서
- Quickstart — 5분 통합 (수동)
- Rails 통합 — 코드 레벨 가이드
- Troubleshooting — 실패 시나리오 7개 + env 점검 체크리스트