דילוג לתוכן
Kin

למפתחים

עבדו עם המעגל של משפחה. לעולם אל תאשרו.

עוזר הבינה המלאכותית של בן משפחה מתחבר לשרת ה-MCP של Kin דרך התחברות ב-OAuth, או עם אסימון שבן המשפחה מעניק. התוכנה של סוכנות טיפול ביתי מדווחת על ביקורים דרך API חתום. שניהם קוראים ומציעים; אדם ב-Kin מאשר.

שרת MCP

חיבור עוזר

HTTP זורם, הודעת JSON-RPC אחת לכל בקשה, בלי סשן. גרסאות פרוטוקול 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. לקוח מתחבר דרך OAuth 2.1, או שבן המשפחה יוצר אסימון במסך העוזרים המחוברים.

נקודת קצה
https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp

התחברו מהלקוח שלכם

הוסיפו את הכתובת של Kin בלי אסימון. הלקוח מוצא את Kin מתשובת ה-401, נרשם ופותח את Kin בדפדפן; אתם מתחברים, בוחרים מה מותר לו ולכמה זמן, ומאשרים. Kin הוא שרת ההרשאות של עצמו לפי OAuth 2.1: PKCE עם S256, מסמכי מטא-נתונים של מזהה לקוח או רישום דינמי, מחוון המשאב, ובלי אסימון רענון.

Claude Code, עם התחברות
claude mcp add --transport http kin https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp
מטא-נתונים של שרת ההרשאות
https://mzdg4f3stk.us-east-1.awsapprunner.com/.well-known/oauth-authorization-server
Claude Code, עם אסימון
claude mcp add --transport http kin https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp --header "Authorization: Bearer <your-delegation-token>"
הגדרות לקוח MCP (.mcp.json)
{
  "mcpServers": {
    "kin": {
      "type": "http",
      "url": "https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-delegation-token>"
      }
    }
  }
}
כל לקוח HTTP
curl -s https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp \
  -H "Authorization: Bearer <your-delegation-token>" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2026-07-28" -H "Mcp-Method: tools/list" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

הכלים

אותם כלים ואותו שער כמו במסך „לשאול את Kin”. tools/list מציג רק את מה שהתפקיד של החבר וההיקף של האסימון מתירים.

  • get_poolקורא

    The circle's pool: its confirmed balance now, this month's money paid in, paid out and PayPal fees, and what this month's spending went on by category (bills, receipts members paid from their own pocket, and purchases). Use it for any question about how much money there is, or how much was spent on something this month.

  • list_billsקורא

    The circle's bills: those the family expects next, those waiting for approval, and those paid, with payee, amount and day. A caregiver sees only their own. It does not hold receipts or purchases: for what was spent on something, use get_pool.

  • get_fairnessקורא

    This month's fairness, as Kin's money core calculates it: each sharing member's agreed share, what they gave, and who owes whom to settle. Use it for any question about shares, fairness or who owes whom.

  • check_claimקורא

    Checks a demand for money against the record, with Kin's fixed rules: is the payee known, is there an open bill of that amount, was it already paid. It only reads; nobody is alerted. Use it when someone asks whether a demand, call or letter is real.

  • list_proposalsקורא

    The payments waiting for a yes, and who still has to say yes to each, as the approval engine decided. Kin cannot answer for anyone.

  • get_recordקורא

    The newest entries of the circle's ledger: what happened, to whom, how much and on which day, and whether it was simulated.

  • get_paypal_payout_statusקורא

    Whether someone has been paid: the payouts the record holds for a payee or caregiver, and, for a real payout, its status read from PayPal now. Simulated payouts in a demo say so.

  • get_paypal_topup_statusקורא

    The members' top-ups into the pool: amount, day and, for a real top-up, the status of its capture read from PayPal now. Simulated top-ups in a demo say so.

  • get_subscription_statusקורא

    Each member's monthly share through PayPal subscriptions: its amount, its state and its next charge, read from PayPal for a real one. Simulated shares in a demo say so.

  • get_paypal_orderקורא

    PayPal's own record of a top-up, read from PayPal now through the PayPal Agent Toolkit: the PayPal order behind the newest real top-up, its status, amount, times and capture. A simulated top-up has no PayPal record, and the result says so. Use it when someone asks what PayPal itself says about a top-up.

  • get_paypal_invoiceקורא

    PayPal's own record of an invoice Kin sent a member, read from PayPal now through the PayPal Agent Toolkit: its number, status, amount and what was paid on it. A simulated invoice has no PayPal record, and the result says so. Use it when someone asks whether an invoice was paid or where it stands at PayPal.

  • list_paypal_disputesקורא

    Whether anyone has disputed one of the circle's newest real top-ups with PayPal, read from PayPal now through the PayPal Agent Toolkit: each dispute's status, reason and amount. Use it when someone asks about a dispute, a chargeback or a payment someone says they did not make.

  • propose_refillמציע

    Asks Kin to propose a refill the family's rules already allow, at the rule's own price. It buys nothing: the refill then waits for the yeses the family agreement names, unless the parent's standing permission covers it. Use it only when the person asks for a reorder or refill.

  • propose_giftמציע

    For the parent only: asks Kin to send a small payment from her own Purse, such as a gift, a tip or a donation, to someone she names. It pays nothing: Kin reads the payment back and it waits for her own yes, and Kin's rules hold it for a day, with the family told, when the person is not in her address book, the amount is above her limit or the request looks pressured. Use it only when she asks to send, give or pay someone money from her Purse.

הגבול

מה שאף גורם חיצוני לא יכול לעשות

  • אף כלי לא מאשר, משלם, חותם או מזיז כסף. כלי שמציע מחזיר את המזהה של ההצעה ואת המסך שבו אדם מאשר אותה, וההצעה ממתינה לאותו אדם גם כשההיתר הקבוע של ההורה היה מכסה אותה.
  • הכלים של PayPal עצמה, כולל כלי הכתיבה, נשארים בשרת של Kin ולא מוצעים כאן לעולם.
  • היקף האסימון רק מצמצם את התפקיד של החבר עצמו. ביטול ההרשאה דוחה כבר את הקריאה הבאה.
  • טקסט מהרישום (שמות, הערות, מכתבים) חוזר מסומן כנתונים, בתוך תג שאי אפשר לסגור.
  • בקשה בלי אסימון פעיל מקבלת 401 וכותרת WWW-Authenticate שמצביעה על המטא־נתונים של המשאב המוגן.

API לחברות סיעוד

דיווח על ביקור

שלחו ביקור אחד ב־POST אל /api/v1/visits, חתום במפתח שמארגן המעגל יצר. Kin שומר אותו כראיה לצד המשמרת. הוא לא משלם דבר.

חתמו על הגוף הגולמי
BODY='{"externalId":"visit-1042","caregiver":"צוות טיפול","kind":"aide","startsAt":"2026-11-09T09:00:00-05:00","endsAt":"2026-11-09T13:00:00-05:00","checkedInAt":"2026-11-09T09:02:00-05:00","checkedOutAt":"2026-11-09T13:00:00-05:00"}'
T=$(date +%s)
SIG=$(printf '%s.%s' "$T" "$BODY" | openssl dgst -sha256 -hmac 'kin_ags_…' | sed 's/^.* //')
curl -s https://mzdg4f3stk.us-east-1.awsapprunner.com/api/v1/visits \
  -H "Content-Type: application/json" \
  -H "Kin-Agency-Key: agk_…" \
  -H "Kin-Signature: t=$T,v1=$SIG" \
  -d "$BODY"

201 נשמר · 200 כבר נשמר · 401 מפתח או חתימה · 409 אותו מזהה, גוף אחר · 422 נשמר אך לא קריא

API לחברות סיעוד

לשלוח חשבונית

שלחו חשבונית ב-POST אל ‎/api/v1/invoices, חתומה בדיוק כמו ביקור. כל שורה מציינת ביקור שהחברה כבר דיווחה, בסנטים שלמים; Kin מחשבת את הסכום בעצמה. החשבונית הופכת לחשבון שהמשפחה בודקת מול הביקורים שאישרה. היא לא משלמת דבר בעצמה.

לחתום ולשלוח חשבונית
BODY='{"invoiceNumber":"INV-1042","periodStart":"2026-11-01","periodEnd":"2026-11-30","lines":[{"visitId":"visit-1042","minutes":240,"amountCents":11200,"currency":"USD"}],"totalCents":11200,"currency":"USD","dueOn":"2026-12-15","paypalEmail":"billing@agency.example"}'
T=$(date +%s)
SIG=$(printf '%s.%s' "$T" "$BODY" | openssl dgst -sha256 -hmac 'kin_ags_…' | sed 's/^.* //')
curl -s https://mzdg4f3stk.us-east-1.awsapprunner.com/api/v1/invoices \
  -H "Content-Type: application/json" \
  -H "Kin-Agency-Key: agk_…" \
  -H "Kin-Signature: t=$T,v1=$SIG" \
  -d "$BODY"
לשאול מה מצבה (חתמו על הנתיב)
P=/api/v1/invoices/INV-1042
T=$(date +%s)
SIG=$(printf '%s.%s' "$T" "$P" | openssl dgst -sha256 -hmac 'kin_ags_…' | sed 's/^.* //')
curl -s https://mzdg4f3stk.us-east-1.awsapprunner.com$P \
  -H "Kin-Agency-Key: agk_…" \
  -H "Kin-Signature: t=$T,v1=$SIG"

201 נשמרה לבדיקה · 200 כבר נשמרה · 401 מפתח או חתימה · 409 אותו מספר, תוכן אחר · 422 נשמרה אך נדחתה, עם הסיבה · GET: received, under_review, approved, paid, declined

OpenAPI

המסמך שפורסם

נבנה מהסכמות שמולן השרת בודק בקשות, ולכן אינו יכול לסטות מהן.

לפתוח את מסמך ה־OpenAPI

ערכות פיתוח ל-TypeScript ול-Python, שנוצרו על ידי APIMatic מאותו מסמך. בכל אחת יש דוגמה חתומה לממשק הסוכנויות.

התחילו בשיחה אחת עם המשפחה.