חיבור לקוח MCP
זמין בתוכניותFreeProResearch
Readsira מפעילה שרת Model Context Protocol, כך שעוזרים יכולים לחפש ולקרוא בספרייה שלכם בזמן שאתם עובדים. העוזר מביא את המודל שלו: Readsira רק מחזירה קטעים ומסמכים, עם קישור חזרה לכל מקור.
- כתובת השרת:
https://api.readsira.com/mcp - תעבורה: Streamable HTTP, חסרת מצב (אין הפעלה לשמור)
- אימות: כניסה עם Readsira (OAuth) ל-Claude ול-ChatGPT, או מפתח MCP שנשלח כ-
Authorization: Bearer pk_...ל-Claude Code, Cursor ולקוחות אחרים שמקבלים כותרת. שניהם מגיעים לאותם כלים, הרשאות ומגבלות.
Claude (אינטרנט ושולחן עבודה)
- ב-Claude פתחו Settings, Connectors ובחרו Add custom connector.
- הדביקו
https://api.readsira.com/mcpוהוסיפו אותו. Claude פותח את Readsira בדפדפן. - היכנסו אם מבקשים. מסך ההסכמה מראה מה Claude מבקש במילים פשוטות; בטלו סימון של כל מה שאינכם רוצים (כתיבה אף פעם לא נדרשת לחיפוש), ואז בחרו אישור.
- בקשו מ-Claude "search my Readsira library for sodium-ion storage".
לא מדביקים מפתח. החיבור מופיע תחת API ו-MCP ב-הגדרות, ברשימה אפליקציות מחוברות.
ChatGPT
- ב-ChatGPT פתחו Settings, Apps and connectors וצרו מחבר (מצב מפתח חייב להיות פעיל למחברים מותאמים).
- הדביקו
https://api.readsira.com/mcpככתובת השרת ובחרו OAuth כאימות. - ChatGPT פותח את Readsira: היכנסו, עברו על ההרשאות ובחרו אישור.
- הפעילו את המחבר בשיחה ובקשו ממנו לחפש בספרייה שלכם.
שמות התפריטים ב-Claude וב-ChatGPT משתנים מדי פעם; כתובת השרת ומסך ההסכמה של Readsira נשארים אותו דבר.
לקוחות עם כותרת: יצירת מפתח MCP
באפליקציה פתחו את הגדרות, בחרו API ו-MCP ובחרו יצירת מפתח MCP.
מפתח ברירת המחדל יכול רק לקרוא (mcp + read:library). הוסיפו read:projects כדי להשתמש בפרויקטים
שלכם. הוסיפו write:bookmarks או write:notes רק אם אתם רוצים שהעוזר ישמור קישורים או יוסיף הערות,
ורק אם אתם בודקים מה הוא עושה: טקסט בדפי אינטרנט יכול לנסות להטות עוזר. העתיקו את המפתח עכשיו; הוא
מוצג פעם אחת.
הוספת השרת ללקוח שלכם
Claude Code
claude mcp add --transport http readsira https://api.readsira.com/mcp \
--header "Authorization: Bearer pk_your_key"
אחר כך הקלידו /mcp בהפעלה של Claude Code: readsira מוצג כמחובר. בקשו "search my Readsira
library for sodium-ion storage". הפקודה הזו נבדקת מול שרת Readsira לפני כל גרסה (claude mcp list
מדווח שהיא מחוברת).
Cursor
הוסיפו ל-.cursor/mcp.json בפרויקט שלכם, או להגדרות ה-MCP הגלובליות של Cursor:
{
"mcpServers": {
"readsira": {
"url": "https://api.readsira.com/mcp",
"headers": { "Authorization": "Bearer pk_your_key" }
}
}
}
לקוחות אחרים שמקבלים כותרת
כל לקוח שתומך בשרתי MCP מרוחקים דרך Streamable HTTP עם כותרות מותאמות עובד עם אותה כתובת ואותה
כותרת Authorization.
לקוחות שרק נכנסים
לקוח שתומך במפרט האימות של MCP (OAuth 2.1 עם רישום לקוחות דינמי) צריך רק את כתובת השרת: הוא מגלה את הכניסה של Readsira מהשרת, כמו Claude ו-ChatGPT.
כלים
| כלי | הרשאה | מה הוא עושה |
|---|---|---|
search_library | read:library | הקטעים המתאימים ביותר עם כותרת, URL, עמוד PDF וחותמות זמן של מדיה (query, limit 1-20) |
get_document | read:library | טקסט של מסמך בעמודים (documentId, bookmarkId או url; offset, maxChars) ועוד התגיות, ההערות וההדגשות שלכם |
list_projects | read:projects | הפרויקטים שלכם, הפעילים לאחרונה קודם (status פעיל או בארכיון, limit 1-50) |
get_project_context | read:projects | ההנחיות של פרויקט, החלטות שהוחלטו, הערות מוצמדות ומקורות; עם query, הקטעים הטובים ביותר מהפרויקט (maxChars עד 32,000) |
add_bookmark | write:bookmarks | שמירת URL; שמירה של אחד שכבר יש לכם מחזירה created: false ורק מוסיפה תגיות. עם projectId (צריך גם write:projects), מוסיף אותו גם לפרויקט הזה |
create_note | write:notes | הוספת הערה לאחד מהפריטים השמורים שלכם (bookmarkId), או הוספת הערה לפרויקט (projectId, title אופציונלי; צריך write:projects); היא הופכת לניתנת לחיפוש |
כלים שהרשאות המפתח שלכם לא מאפשרות אינם מופיעים ברשימה. get_project_context נותן לעוזר את ההנחיות של
הפרויקט כדי שיוכל לפעול לפיהן בזמן שהוא עובד בשבילכם באותו פרויקט. כשההקשר ארוך מ-maxChars, מקורות
מוחרגים קודם, ואז קטעים, הערות והחלטות, והתוצאה אומרת truncated: true.
שגיאות כלים חוזרות כתוצאות כלי עם isError: true וקוד: SCOPE_REQUIRED, NOT_FOUND, RATE_LIMITED
(עם retryAfterSeconds), PLAN_REQUIRED, VALIDATION_FAILED, URL_REJECTED, ובכתיבות לפרויקט
PROJECT_LIMIT_REACHED (הפריטים לפרויקט של התוכנית) או PROJECT_ARCHIVED. אם חיפוש ה-AI מושהה להיום,
search_library עדיין עונה עם התאמת טקסט ואומר degraded: "lexical".
מגבלות
| Plan | MCP keys | Tool calls per day | Calls per hour per key | Tools |
|---|---|---|---|---|
| Free | 1 | 100 | 60 | read tools |
| Pro | 10 | 10,000 | 600 | all |
| Research | 10 | 25,000 | 1,200 | all |
הימים הם לפי UTC. רישום כלים אינו נספר; קריאת מסמך ארוך נספרת כקריאה אחת לכל 12,000 תווים, וכתיבות נספרות כשתיים. כל מגבלות התוכניות: מגבלות התוכניות.
ביטול ובדיקה
אפליקציות מחוברות תחת API ו-MCP ב-הגדרות מפרט כל אפליקציה שהרשיתם עם ההרשאות שלה, מתי התחברה ומתי השתמשה בספרייה שלכם לאחרונה. ניתוק עוצר אותה מיד (הקריאה הבאה שלה נדחית); כדי להשתמש בה שוב, חברו אותה שוב מהאפליקציה. אתם מקבלים הודעה באפליקציה בכל פעם שאפליקציה מתחברת, כך שחיבור בלתי צפוי גלוי.
אותו דף מפרט כל מפתח עם השימוש האחרון והלקוח שלו, וטבלת פעילות של כל קריאה לכלי (שעה, כלי, סטטוס, לקוח, מספר תוצאות). Readsira אף פעם לא רושמת שם את טקסט החיפוש או ההערות שלכם. ביטול עוצר מפתח מיד. בפעם הראשונה שמשתמשים במפתח אתם מקבלים הודעה באפליקציה שנותנת שם ללקוח, כך ששימוש בלתי צפוי גלוי.
למפתחי לקוחות: פרטי OAuth
Readsira היא שרת ההרשאה של עצמה, לפי מפרט האימות של MCP:
| מה | ערך |
|---|---|
| מטא-נתוני משאב מוגן (RFC 9728) | https://api.readsira.com/.well-known/oauth-protected-resource/mcp |
| מטא-נתוני שרת הרשאה (8414) | https://api.readsira.com/.well-known/oauth-authorization-server |
| רישום לקוחות דינמי (7591) | POST /oauth/register; לקוחות ציבוריים (none) או client_secret_post / _basic |
| הרשאה | GET /oauth/authorize, זרימת קוד עם PKCE S256 בלבד (plain נדחה), state נדרש |
| אסימון | POST /oauth/token: authorization_code, refresh_token |
| ביטול (7009) | POST /oauth/revoke |
| הרשאות | read:library (ברירת מחדל), read:projects, write:projects, write:bookmarks, write:notes |
- תשובת 401 מ-
/mcpנושאתWWW-Authenticate: Bearer resource_metadata="...", כך שלקוחות יכולים להתחיל גילוי מכתובת השרת. - כתובות הפניה חייבות להיות רשומות ומותאמות במדויק:
https, אוhttpב-127.0.0.1,localhostאו[::1]לאפליקציות מקומיות. - תשובת ההרשאה נושאת
iss(RFC 9207). קודים חיים 60 שניות ופועלים פעם אחת. - אסימוני גישה חיים שעה אחת. אסימוני רענון מתחלפים בכל שימוש; הצגה חוזרת של אסימון רענון משומש מבטלת את כל החיבור.
- אסימונים הם לשרת ה-MCP בלבד; ה-REST API מקבל מפתחות API.
- הרישום מוגבל בקצב לפי כתובת IP, ולקוחות רשומים שלא משתמשים בהם 30 יום מוסרים.