FastComments.com

Menu Icon

שפה 🇮🇱 עברית
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇫🇷 Français (France) 🇩🇪 Deutsch 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇷🇸 Srpski (Latinica) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

שילוב LLM

קבל את ערכת LLM

שרת MCP

שרת MCP

הקמת חשבון סוכן

תן לסוכן להקים את החשבון שלך

ערכת LLM

ערכת LLM

ערכת LLM של FastComments מסייעת לעוזרי קידוד מבוססי בינה מלאכותית כמו Claude, ChatGPT ו-Cursor להבין ולהשתלב עם FastComments על‑ידי מתן גישה לתיעוד המלא שלנו באמצעות ממשק חיפוש פשוט (API).

על‑ידי הוספת קטע לקובץ AGENT.md או CLAUDE.md של הפרויקט שלך, אתה מאפשר לעוזרי ה-AI לחפש במהירות ולהביא את תיעוד FastComments הרלוונטי, מה שהופך את היישום למהיר ומדויק יותר.

קבל את ערכת LLM Internal Link

הוסף קטע קוד זה לקבצי התצורה של עוזר ה-AI בפרויקט שלך (כמו AGENT.md או CLAUDE.md) שמלמד עוזרי קידוד AI כיצד לחפש ולגשת לתיעוד של FastComments.

FastComments LLM Kit
Copy Copy
1
2## FastComments Integration
3
4FastComments is an embeddable live commenting platform with libraries for many frontend and backend integrations, along with client and server-side SDKs and APIs.
5
6When working with FastComments, you can search the FastComments documentation by calling this API:
7
8https://docs-search.fastcomments.com/search?query=<search_query>&full=true&tenantId=demo
9
10Replace `<search_query>` with your search terms (URL encoded). The API returns relevant documentation snippets to help with implementation.
11

כך עוזר ה-AI שלך יכול בקלות לקבל מידע עדכני ולספק מימושים מדויקים יותר בפחות זמן.

דוגמת שימוש

כאשר אתה משתמש בעוזר AI כמו Claude Code או Cursor, אתה יכול לשאול שאלות כמו:

  • "איך מתקינים FastComments ב-React?"
  • "הראה לי איך להגדיר SSO עם FastComments"
  • "מהן אפשרויות האימות של FastComments API?"

עוזר ה-AI יחפש אוטומטית בתיעוד באמצעות נקודת הקצה של ה-API שסופקה ויתן לך תשובות מדויקות ועדכניות המבוססות על התיעוד הרשמי.

שרת MCP Internal Link

FastComments מריץ שרת מודל קונטקסט פרוטוקול (MCP) מתארח כך שעוזרי AI ולקוחות סוכניים יכולים לקרוא ישירות ל-API של FastComments. כל כלי שהשרת MCP מציג נוצר אוטומטית ממפרט OpenAPI הציבורי, ולכן כל מה שה-REST API יכול לעשות, לקוח MCP יכול לעשות.

הקצה הוא חסר-מצב (stateless) ומתבסס על HTTP זורם. אין סשן לשמור בחיים ואין מצב בצד השרת לכל לקוח.

Endpoint

קצה MCP
Copy Copy
1
2https://fastcomments.com/mcp
3

Connect with OAuth

כל לקוח MCP שתומך בשרתים מרוחקים עם OAuth (Claude, ChatGPT, Claude Code, Cursor ואחרים) יכול להתחבר לקצה שלמעלה ללא הגדרה מצד FastComments. הלקוח נרשם דרך רישום לקוח דינמי או מזהה את עצמו עם מסמך מטא-נתוני מזהה לקוח, פותח דפדפן כדי שתוכל להתחבר ל-FastComments ולאשר גישה, ומקבל טוקן הקשור לחשבון שבו נכנסת.

המסמכי גילוי נמצאים במיקומים הסטנדרטיים:

גילוי
Copy Copy
1
2https://fastcomments.com/.well-known/oauth-protected-resource/mcp
3https://fastcomments.com/.well-known/oauth-authorization-server
4

המשתמש שלך צריך את הרשאת API Admin על החשבון כדי לאשר חיבור. אם אתה מנהל כמה חשבונות, עבור לחשבון הנכון בלוח הבקרה לפני האישור.

לקוח יכול לבקש את ההיקף read, את ההיקף write, או את שניהם. לקוח שלא מבקש דבר מקבל את שניהם. כלים שמשנים נתונים אינם מוצעים לטוקן קריאה בלבד.

לוח הבקרה כולל עוזר הגדרה עם קטעי קוד מוכנים להדבקה. פתח Integrate -> MCP Server, או בקר ישירות:

דף הגדרה
Copy Copy
1
2https://fastcomments.com/auth/my-account/mcp-setup
3

Claude Code

רשום את שרת FastComments עם פקודה אחת, ואז הרץ /mcp בתוך סשן כדי להתחבר ולרשום את הכלים הזמינים:

הגדרת Claude Code
Copy Copy
1
2claude mcp add --transport http fastcomments https://fastcomments.com/mcp
3

Cursor and other config-file clients

הוסף את הבלוק הזה לקונפיגורציית שרתי MCP של הלקוח שלך (mcp.json עבור Cursor). הלקוח פותח דפדפן כדי להתחבר בפעם הראשונה.

קונפיגורציית לקוח MCP
Copy Copy
1
2{
3 "mcpServers": {
4 "fastcomments": {
5 "type": "http",
6 "url": "https://fastcomments.com/mcp"
7 }
8 }
9}
10

Revoking access

כל חיבור מאושר מופיע תחת Integrate -> Connected Apps בלוח הבקרה. ביטול אחד מבטל את כל הטוקנים שהאפליקציה מחזיקה. אפליקציות נרשמות כאשר הן מתחברות ו-FastComments אינו סוקר אותן, ולכן בטל כל מה שאינך מזהה.

Using the token with the REST API

טוקן הגישה שלקוח MCP מקבל הוא אישור רגיל של API של FastComments. הוא פועל על כל קצה /api/v1 כטוקן נושא, ולכן אפליקציה שהתחברה דרך MCP יכולה גם לקרוא ישירות ל-REST API:

טוקן נושא
Copy Copy
1
2curl -H "Authorization: Bearer fcat_..." https://fastcomments.com/api/v1/comments
3

השוכר (tenant) נרמז על ידי הטוקן. עדיין ניתן להעביר tenantId אך הוא חייב להתאים. בקשות GET דורשות את ההיקף read וכל השאר דורש את ההיקף write.

Connect with an API key

לקוחות שלא יכולים להשלים התחברות בדפדפן, כגון שרתים ללא ממשק, יכולים לאמת באמצעות מפתח API במקום זאת. העבר tenantId ו-API_KEY כפרמטרי שאילתה, או ככותרות HTTP x-tenant-id ו-x-api-key אם הלקוח שלך תומך בכותרות מותאמות.

קצה מפתח API
Copy Copy
1
2https://fastcomments.com/mcp?tenantId=YOUR_TENANT_ID&API_KEY=YOUR_API_KEY
3

דף ההגדרה יוצר את ה-URL הזה עבור כל מפתח API שלך.

Security

כתובת קצה שמכילה מפתח API היא סוד: אל תדביק אותה בצ'אטים ציבוריים, צילומי מסך או קומיטים. אם מפתח נחשף, החלף אותו בעמוד מפתחות API בלוח הבקרה שלך. טוקני OAuth אינם נושאים סיכון כזה מכיוון שהם קשורים לאפליקציה אחת וניתן לבטל אותם מ-Connected Apps.

תן לסוכן להקים את החשבון שלך Internal Link

סוכן קידוד כגון Claude Code, Cursor, או עוזר מבוסס MCP יכול להגדיר את FastComments עבורך מבלי שתצטרך למלא את טופס ההרשמה. זה שימושי כאשר אתה מבקש מסוכן "להוסיף תגובות לאתר שלי" ואין לך עדיין חשבון.

איך זה עובד

  1. הסוכן יוצר חשבון חדש ומקבל מפתח API וקישור תביעה. מפתח ה-API פועל מיידית, כך שהסוכן יכול להגדיר את החשבון ולהתקין את הווידג'ט באתר שלך.
  2. הסוכן נותן לך את קישור התביעה. פתח אותו בדפדפן שלך, התחבר או צור חשבון, ואשר את התביעה. החשבון הופך להיות שלך: אתה מנהל אותו, את החיוב שלו, ואת מפתחות ה-API שלו מלוח הבקרה. העמוד מציג את מפתח ה-API שהסוכן מחזיק כדי שתוכל לבטלו אם אינך רוצה שהסוכן, או מי שמפעיל אותו, ימשיך לקבל גישה.
  3. אם אף אחד לא פותח את קישור התביעה בתוך 72 שעות, החשבון והמפתח שלו יימחקו. בקש מהסוכן ליצור אחד חדש.

עד שיתבע, החשבון מקבל את אותם מגבלות כמו ניסיון חינמי רגיל.

אם כבר יש לך חשבון

כל כניסה (login) מחזיקה חשבון אחד. אם אתה פותח קישור תביעה בזמן שאתה מחובר לחשבון קיים, העמוד מאפשר לך לבחור:

  • הצמד לחשבון שלי הופך את החשבון החדש לשוכר מנוהל של החשבון שאתה מחובר אליו. זה דורש תוכנית בתשלום עם מיתוג לבן, והשימוש של השוכר החדש מחויב לחשבון שלך.
  • התנתק ותבע עם כניסה אחרת מתנתק אותך ומחזיר אותך לעמוד התביעה כדי שתוכל לתבוע אותו עם כניסה שונה.

למחברי סוכנים

ההוראות לסוכנים בכתובת fastcomments.com/agents.md מתארות את קריאת יצירת החשבון, השדות בתגובה, וכיצד להעביר את קישור התביעה לאדם שאתה עובד עבורו. הקריאה אינה דורשת מפתח API והיא מוגבלת בקצב לפי כתובת IP.

תרום למדריך זה