Lipi MCP 서버
최종 수정:
이 문서는 참고용 번역본이에요. 영문 원본이 우선해요.
요약. Lipi에는
https://api.lipi.com.np/mcp의 원격 MCP 서버가 있어요. AI 어시스턴트에 추가하고 Lipi에 로그인한 뒤 읽기 전용 또는 전체 권한을 고르세요. 그러면 어시스턴트가 돈에 관한 질문에 답하고, 전체 권한이면 장부도 최신으로 유지해 줘요. 어시스턴트가 한 모든 동작은 Lipi의 설정 → AI 어시스턴트에서 확인하고, 언제든지 연결을 끊을 수 있어요.
할 수 있는 일
Lipi의 MCP 서버를 쓰면 AI 어시스턴트가 이용자의 Lipi 장부를 사용할 수 있어요. 계좌, 지출과 수입, 예산, 은행 대출과 EMI, 사람별 장부, 분할 정산, 자산, 청구서, 리포트가 포함돼요. 이런 질문을 해 보세요.
- 이번 달 식비가 지난달보다 얼마나 늘었어?
- 지금 한도에 가까워진 예산은 뭐야?
- 내 순자산은 얼마고, 변동 중 달러 환율 때문인 부분은 얼마야?
- 오늘 Bhatbhateni에서 산 식료품 Rs 1,250을 Nabil 계좌에서 나간 걸로 추가해 줘.
- 주택 대출 명세서 사진이야. EMI 일정을 업데이트해 줘.
어시스턴트는 Lipi 앱에서 이용자가 할 수 있는 일을 같은 검사와 플랜 한도 안에서 할 수 있고, 그 이상은 할 수 없어요. Lipi 계정이 필요해요. 무료로 가입하기.
연결
서버 URL은 어디서나 같아요.
https://api.lipi.com.np/mcp
어시스턴트가 처음 연결되면 브라우저에서 Lipi 로그인 페이지가 열려요. 로그인하고, 접근 권한을 고른 뒤 허용을 선택하세요.
Claude (claude.ai, 데스크톱, 모바일)
- 설정 → 커넥터를 열고 커스텀 커넥터 추가를 선택하세요.
- 이름을
Lipi로 정하고 서버 URL을 붙여 넣은 뒤 추가를 선택하세요. - 연결을 선택하고 Lipi에 로그인하세요.
Claude Code
Lipi 플러그인을 설치하세요. 서버와 함께 월간 리뷰, 현금 흐름 예측 같은 선택 스킬이 추가돼요.
/plugin marketplace add LipiTechnology/lipi-expense-tracker
/plugin install lipi-expense-tracker@lipi
그런 다음 /mcp를 실행하고 lipi를 선택해 로그인하세요. 서버만 추가하려면 claude mcp add --transport http lipi https://api.lipi.com.np/mcp를 실행하세요.
ChatGPT
Lipi는 ChatGPT의 플러그인 디렉터리에 있어서 서버 URL이나 개발자 모드가 필요 없어요. 웹, 데스크톱 앱, 휴대폰 앱 모두 단계가 같아요.
- ChatGPT 사이드바에서 플러그인을 열어요(또는 플러그인 디렉터리의 Lipi를 열어요).
- Lipi를 열고 플러그인 설치, 이어서 연결을 선택하세요.
- ChatGPT가 Lipi로 이동시키면 로그인하고, 접근 권한을 고른 뒤 허용을 선택하세요.
대화에서 쓰려면 @Lipi를 입력하거나 **+**를 선택해 Lipi를 고르세요. 돈에 관해 물으면 ChatGPT가 알아서 Lipi를 쓰기도 해요. 연결을 끊으려면 설정 → 플러그인에서 Lipi를 선택하고 연결 해제를 고르거나, Lipi의 설정 → AI 어시스턴트에서 삭제하세요.
그 밖의 어시스턴트
OAuth를 쓰는 Streamable HTTP 방식의 원격 MCP 서버를 지원하는 클라이언트라면 모두 쓸 수 있어요. 예를 들면 다음과 같아요.
| 어시스턴트 | 파일 | 추가할 내용 |
|---|---|---|
| Cursor | ~/.cursor/mcp.json |
{ "mcpServers": { "lipi": { "url": "https://api.lipi.com.np/mcp" } } } |
| VS Code (GitHub Copilot) | .vscode/mcp.json |
{ "servers": { "lipi": { "type": "http", "url": "https://api.lipi.com.np/mcp" } } } |
| Codex | ~/.codex/config.toml |
[mcp_servers.lipi]와 url = "https://api.lipi.com.np/mcp", 그런 다음 codex mcp login lipi |
| Gemini CLI | ~/.gemini/settings.json |
{ "mcpServers": { "lipi": { "httpUrl": "https://api.lipi.com.np/mcp" } } } |
더 많은 어시스턴트를 위한 플러그인, 스킬, 설정 방법은 GitHub에 있어요.
접근 권한
연결할 때 하나를 고르고, 나중에 Lipi의 설정 → AI 어시스턴트에서 바꿀 수 있어요.
- 읽기 전용(기본값). 어시스턴트가 계좌, 거래, 예산, 대출, 자산, 청구서, 리포트를 볼 수 있어요. 아무것도 바꿀 수 없어요.
- 전체 권한. 어시스턴트가 기록을 추가, 변경, 삭제할 수도 있어요. 모든 쓰기는 앱과 같은 검사와 플랜 한도를 거쳐요.
어느 권한이든 어시스턴트는 이용자의 비밀번호를 볼 수 없고, 로그인 정보를 바꾸거나 Lipi 계정을 삭제할 수 없어요. Lipi는 어시스턴트에게 무언가를 삭제하기 전에 먼저 물어보고, 일괄 변경 전에는 쓸 내용을 보여 주라고 알려 줘요.
도구
모든 도구에는 어시스턴트가 알 수 있도록 표시가 붙어 있어요. 읽기 도구는 읽기 전용, 삭제 도구는 파괴적으로 표시되고, 이용자 본인의 Lipi 데이터 밖으로 나가는 도구는 없어요. 일부 도구는 Premium이 필요하며, 무료 플랜에서는 답하는 대신 그렇다고 알려 줘요.
| 영역 | 읽기 | 쓰기(전체 권한) |
|---|---|---|
| 시작과 프로필 | get_overview, get_plan, get_settings, list_notifications, search |
update_settings, mark_notifications_read |
| 계좌 | list_accounts, get_account, get_account_balance_trend |
create_account, update_account, delete_account |
| 카테고리 | list_categories |
create_category, update_category, delete_category |
| 거래 | list_transactions, get_transaction, get_transaction_summary |
create_transaction, create_transactions, create_transfer, update_transaction, delete_transaction |
| 예산 | list_budgets, get_budget_progress |
create_budget, update_budget, delete_budget |
| 리포트 | get_cash_flow, get_savings_rate, get_net_worth_trend, get_spending_forecast, get_recurring_expenses, get_category_movers, get_bills_radar, get_unusual_spend, get_spending_by_intent, get_intent_trend, get_activity_log |
export_transactions_csv |
| 반복 및 예약 | list_recurring, list_scheduled |
create_recurring, update_recurring, toggle_recurring, post_recurring_now, delete_recurring, create_scheduled, update_scheduled, post_scheduled_now, cancel_scheduled, delete_scheduled |
| 은행 대출과 EMI | list_bank_loans, get_bank_loan |
save_bank_loan, set_bank_loan_rows, pay_bank_loan_rows, unpay_bank_loan_rows, save_bank_loan_event, delete_bank_loan_event, delete_bank_loan |
| 사람별 장부 | list_ledgers, get_ledger |
save_ledger, save_ledger_entry, delete_ledger_entry, delete_ledger |
| 분할 정산 | list_splits, get_split, get_splits_summary |
create_split, update_split, record_split_settlement |
| 자산 | list_assets, get_asset_summary |
create_asset, update_asset, delete_asset |
| 청구서 | list_invoices, get_invoice, list_clients, list_identities |
create_invoice, update_invoice, set_invoice_status, record_invoice_payment, save_client, delete_invoice |
| 영수증과 파일 | get_scan, read_document |
scan_receipt, attach_file |
| 환율과 시장 | list_currencies, get_exchange_rates, convert_currency, get_metal_prices, get_nepse_index |
서버는 전체 워크플로를 담은 가이드 리소스 lipi://guide와, 월간 리뷰와 대출 일정 가져오기라는 두 가지 프롬프트도 제공해요.
규칙
- 금액은 계좌의 통화로
"1500.00"같은 십진수 문자열이에요. - 날짜는 그레고리력
YYYY-MM-DD예요. 비크람 삼밧(Bikram Sambat)으로 말하면 어시스턴트가 변환하며, 어느 달력을 뜻하는지 밝혀야 해요. - 유출 금액은 세 가지 구분 중 하나에 속해요. 지출, 제외(보험, 투자, 대출 원금), 세금이에요. 합계는 어느 구분을 포함하는지 알려 줘요.
- 본인 계좌끼리 돈을 옮기는 것은 이체이며, 지출과 수입의 조합이 아니에요.
- 환율은 오늘이 아니라 거래 날짜의 환율을 써요.
로그인과 보안
- 서버는 PKCE(S256)와 동적 클라이언트 등록을 쓰는 OAuth 2.1을 사용해요. 디스커버리는
https://api.lipi.com.np/.well-known/oauth-authorization-server와https://api.lipi.com.np/.well-known/oauth-protected-resource/mcp에 있어요. - 각 토큰은
https://api.lipi.com.np/mcp에 묶여 있어서 다른 곳에서는 쓸 수 없어요. - 액세스 토큰은 1시간 유지돼요. 리프레시 토큰은 90일 유지되고 사용할 때마다 바뀌어요.
- 연결마다 분당 120건까지 요청할 수 있어요.
- 어시스턴트는 Lipi 비밀번호를 볼 수 없어요. 로그인은 Lipi의 자체 페이지에서 해요.
활동 확인과 연결 해제
Lipi를 열고 설정 → AI 어시스턴트로 이동하세요. 연결된 어시스턴트별로 부여한 권한, 마지막 사용 시각, 수행한 모든 동작의 로그를 볼 수 있어요. 로그는 30일 동안 보관돼요.
연결 해제를 선택하면 어시스턴트가 즉시 멈춰요. 이용자에게 다시 요청하지 않고는 재연결할 수 없어요.
개인정보
어시스턴트에 무언가를 물으면 답변에 필요한 Lipi 기록이 Anthropic이나 OpenAI 같은 그 어시스턴트의 제공업체로 전달돼요. 그곳에서의 처리는 이용자와 해당 제공업체 간의 계약이 정해요. Lipi가 연결마다 보관하는 정보는 개인정보 처리방침에 있어요. 서버 이용에는 이용약관이 적용돼요.
문제 해결
- 어시스턴트가 변경할 수 없다고 해요. 읽기 전용으로 연결했기 때문이에요. 설정 → AI 어시스턴트에서 전체 권한으로 바꾸세요.
- 도구가 Premium이 필요하다고 해요. 앱에서와 마찬가지로 그 기능은 Premium에 포함돼 있어요.
- 로그인이 계속 다시 나와요. 접근이 해제되었거나, 사용하지 않은 채 90일이 지나 리프레시 토큰이 만료된 거예요. 다시 연결하세요.
- 금액이 이상해요. 계좌의 통화와 구분을 확인하세요. 기본 통화 합계는 각 거래 날짜의 환율을 써요.
지원
support@lipi.com.np로 이메일을 보내 주세요. 개인정보 관련 문의는 privacy@lipi.com.np로 보내 주세요.
Lipi Technology, Balkumari-9, Lalitpur, Nepal (company registration no. 610048917)가 Lipi와 MCP 서버를 운영해요. 공식 이메일: info@lipi.com.np.