MCP · Markedfile

MCP

חברו את Claude, Cursor, VS Code, ChatGPT או Grok כדי לסמן ולזהות קבצים בסביבת עבודה שבבעלותכם.

הדביקו את כתובת המחבר בלקוח שמדבר MCP דרך Streamable HTTP. אין מפתח API ואין CLI לקבצים. Markedfile מחבר אתכם עם אותו חשבון, כולל SSO ומאמת, ואז שואל באיזו סביבת עבודה האפליקציה רשאית להשתמש.

הגדרת חיבור

1הוסיפו שרת MCP בלקוח ובחרו Streamable HTTP, שלפעמים מופיע בשם HTTP.
2הדביקו את https://markedfile.com/api/mcp. הקטעים למטה הם המקום הרגיל שבו כל לקוח שומר את הכתובת.
3סיימו את הכניסה בדפדפן ובחרו סביבת עבודה.
4אשרו סימון וזיהוי. אפשר לבטל את החיבור אחר כך בהגדרות סביבת העבודה.

איך הכניסה עובדת

החיבור משתמש ב-OAuth 2.1 עם PKCE ‏(S256). מאשרים סביבת עבודה אחת. הלקוח לא רואה את הסיסמה.

1הלקוח נרשם בעצמו ושולח אתגר קוד.
2הדפדפן פותח את הכניסה ל-Markedfile. SSO והמאמת הם אלה שהחשבון כבר משתמש בהם.
3בוחרים סביבת עבודה שבבעלותכם ומאשרים סימון, זיהוי או את שניהם.
4Markedfile מחזיר קוד חד-פעמי לכתובת החזרה הרשומה. הלקוח מחליף אותו באסימון גישה.
5אסימון הגישה נמשך שעה ונשמר רק כגיבוב. אסימון הרענון מתחלף בכל שימוש.
6האסימון יכול לסמן ולזהות רק בסביבת העבודה שנבחרה. קובץ שסומן בסביבה אחרת לא נפתר.
7ביטול החיבור מבטל את האסימונים מיד.

הגדרת הלקוח

השתמשו ב-Streamable HTTP. העדיפו file_url כשהקובץ כבר ציבורי. אחרת קראו ל-create_upload_url, שלחו את הבייטים הגולמיים ב-PUT או POST והעבירו file_id. השתמשו ב-file_base64 רק לקובץ קטן מאוד, בערך 100 KB.

Claude

ב-claude.ai פתחו הגדרות, אחר כך מחברים, והוסיפו מחבר מותאם. ב-Claude Desktop פתחו הגדרות, אחר כך מחברים, והוסיפו מחבר מותאם.
הדביקו את כתובת המחבר. תנו ללקוח לסיים את הכניסה בדפדפן.
היכנסו ל-Markedfile, דרך SSO או מאמת אם החשבון משתמש בהם, ובחרו סביבת עבודה.

Claude

https://markedfile.com/api/mcp

Cursor

פתחו את הגדרות Cursor, אחר כך MCP, והוסיפו שרת. אפשר גם להוסיף את ה-JSON למטה להגדרות MCP.
בחרו Streamable HTTP והדביקו את כתובת המחבר.
סיימו את הכניסה בדפדפן ובחרו סביבת עבודה. Cursor שומר את אסימון הרענון מקומית.

Cursor

{
  "mcpServers": {
    "markedfile": {
      "url": "https://markedfile.com/api/mcp"
    }
  }
}

VS Code

ב-VS Code הריצו MCP: Add Server מלוח הפקודות, או הוסיפו את ה-JSON למטה ב-mcp.json.
קבעו את הסוג ל-http ואת הכתובת לכתובת המחבר.
סיימו את הכניסה בדפדפן ובחרו סביבת עבודה.

VS Code

{
  "servers": {
    "markedfile": {
      "type": "http",
      "url": "https://markedfile.com/api/mcp"
    }
  }
}

ChatGPT

ב-ChatGPT פתחו הגדרות ואחר כך מחברים. מצב מפתח יכול גם להוסיף מחבר או אפליקציה מותאמים.
הוסיפו את כתובת המחבר והתחילו כניסה.
היכנסו ל-Markedfile ובחרו סביבת עבודה.

ChatGPT

https://markedfile.com/api/mcp

Grok Bot

ב-Grok Bot בקשו מהבוט בצ'אט להוסיף מחבר עם הכתובת למטה.
אשרו את חשבון Markedfile במסך OAuth שנפתח.

Grok Bot

https://markedfile.com/api/mcp

כלים

create_upload_url: יוצר כתובת העלאה קצרת-מועד לסביבת העבודה המחוברת. שלחו את בייטי הקובץ הגולמיים אל upload_url ב-PUT או POST. curl יכול להשתמש ב--upload-file או ב--data-binary. אחר כך העבירו file_id אל mark_file או detect_file. הכתובת תקפה כ-15 דקות. max_bytes הוא תקרת המסלול של סביבת העבודה, כולל וידאו. הפעולה לא מסמנת את הקובץ ולא משתמשת במקום של קובץ פעיל.
mark_file: מסמן קובץ אחד לנמען אחד בסביבת העבודה המחוברת. העדיפו file_id מ-create_upload_url, או file_url כשהקובץ כבר ציבורי. שלחו file_base64 רק לקובץ קטן מאוד, בערך 100 KB. שלחו בדיוק אחד מבין file_id, file_url או file_base64. recipient או label הוא המזהה (1–32 תווים, בלי תווי בקרה). הקובץ המסומן חוזר כ-download_url, קישור קצר-מועד. הגדירו inline_base64 ל-true רק כשהקובץ המסומן הוא בערך 100 KB או פחות והבייטים חייבים להיות בתוצאה. סרטון נכנס לתור: התוצאה היא מזהה משימה ו-statusUrl, לא הבתים המסומנים.
detect_file: בודק קובץ אחד מול סביבת העבודה המחוברת. העדיפו file_id מ-create_upload_url, או file_url כשהקובץ כבר ציבורי. שלחו file_base64 רק לקובץ קטן מאוד, בערך 100 KB. שלחו בדיוק אחד מבין file_id, file_url או file_base64. הוא מחזיר את מזהה הנמען כשהסימון שייך לאותה סביבה. סרטון נכנס לתור: שאלו את statusUrl עד ש-result מופיע. צילום מסך של פריים אחד לא מזוהה כתמונה.

מגבלות

סימון מאפשר 40 בקשות בדקה, זיהוי 80 ו-create_upload_url 30, לחשבון. גודל הקובץ, עמודי PDF והווידאו עוקבים אחרי המסלול של סביבת העבודה. כתובת העלאה פוקעת אחרי כ-15 דקות, וכתובת ההורדה של הקובץ המסומן פוקעת אחרי כשעה. אף אחת מהן אינה קובץ פעיל.