---
title: "לאן למפתחים ולסוכנים"
description: "שרת MCP, ‏REST API ו־OAuth: כל מה שצריך כדי לחבר סוכן או תסריט לנתונים של משק בית, לקריאה בלבד."
canonical: https://lean.edog.app/developers
last-updated: 2026-10-20
---

# לאן למפתחים ולסוכנים

שרת MCP, ‏REST API ו־OAuth: כל מה שצריך כדי לחבר סוכן או תסריט לנתונים של משק בית, לקריאה בלבד.

## שרת MCP

הכתובת: https://lean.edog.app/mcp. השרת עובד ב־Streamable HTTP, והסוכן מתחבר עם OAuth 2.1 ו־PKCE בשם חבר במשק הבית, אחרי שאישר אותו. הכלים: list_cards, ‏search_transactions ו־spending_summary. כולם לקריאה בלבד.

## Claude Code

מריצים בטרמינל, ואז כותבים ‎/mcp‎ בתוך Claude Code כדי להתחבר:

```
claude mcp add --transport http lean https://lean.edog.app/mcp
```

## REST API

הכתובת: https://lean.edog.app/api/v1. המסמך: https://lean.edog.app/api/openapi.json (OpenAPI 3.1), והתיעוד: https://lean.edog.app/api/docs, וגם ב־Markdown בכתובת https://lean.edog.app/api/docs.md. מזדהים עם מפתח API בכותרת x-api-key, או עם אסימון OAuth בכותרת Authorization: Bearer.

## אימות והרשאות

- סוכנים: OAuth 2.1 עם PKCE. רישום לקוח דינמי (RFC 7591) או מסמך מטא־דאטה של לקוח.
- אסימוני גישה תקפים 15 דקות. עם offline_access מקבלים גם אסימון רענון.
- הרשאות: cards:read, ‏transactions:read ו־scrapes:write.
- מפתחות API: חברי משק בית יוצרים אותם בהגדרות. הם לקריאה בלבד כברירת מחדל, ופגים אחרי עד שנה.

## מגבלות וניסיונות חוזרים

- מגבלת קצב: 120 בקשות בדקה לכל אדם, בכל החיבורים, המפתחות והאפליקציות שלו יחד. כל תשובה מציינת כמה נשאר, בכותרות RateLimit-Policy ו־RateLimit. כשהמכסה נגמרת, התשובה היא 429 עם Retry-After.
- ניסיונות חוזרים: הוספת כרטיס ובקשת עדכון מקבלות כותרת Idempotency-Key. ניסיון חוזר עם אותו מפתח בתוך 24 שעות מקבל את התשובה הראשונה, עם Idempotent-Replayed: true, ושום דבר לא קורה פעמיים.
- עדכון לוקח זמן: בקשת עדכון עונה 202 עם כותרת Location. בודקים את הכרטיס שם עד שהסטטוס שלו succeeded או failed.

## גרסאות והוצאה משימוש

ה־API נמצא ב־‎/api/v1‎, וגרסה 1 רק מקבלת נקודות קצה, שדות רשות וערכים חדשים ברשימות פתוחות, כמו החברה או הבנק של כרטיס. שינוי שובר ייצא כ־‎/api/v2‎, ו־‎/api/v1‎ ימשיך לעבוד לפחות 6 חודשים אחרי זה. עד שיוצא משימוש, התשובות שלו יכללו כותרות Deprecation ו־Sunset, והעמוד הזה יציין את התאריך.

## קבצים לסוכנים

- [llms.txt](https://lean.edog.app/llms.txt): סקירה לסוכנים
- [auth.md](https://lean.edog.app/auth.md): איך סוכן מקבל הרשאה, צעד אחר צעד
- [SKILL.md](https://lean.edog.app/.well-known/agent-skills/lean/SKILL.md): סקיל לסוכנים שעובדים עם לאן
- [ai-catalog.json](https://lean.edog.app/.well-known/ai-catalog.json): הקטלוג של כל מה שלאן מציעה לסוכנים
- [api-catalog](https://lean.edog.app/.well-known/api-catalog): קטלוג ה־API לפי RFC 9727
- [server-card](https://lean.edog.app/mcp/server-card): כרטיס שרת ה־MCP
- [openapi.json](https://lean.edog.app/api/openapi.json): מסמך ה־OpenAPI
- [docs.md](https://lean.edog.app/api/docs.md): תיעוד ה־API ב־Markdown
- [api/llms.txt](https://lean.edog.app/api/llms.txt): אינדקס של נקודות הקצה ב־API