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 מפעילה שרת Model Context Protocol (MCP) מאוחסן כך שעוזרי AI ולקוחות אגנטיים יוכלו לקרוא ל-API של FastComments ישירות. כל כלי שהשרת חושף נוצר אוטומטית מהמפרט הציבורי של OpenAPI, ולכן כל מה שה-REST API יכול לעשות, לקוח MCP יכול לעשות.

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

Endpoint

MCP Endpoint
Copy Copy
1
2https://fastcomments.com/mcp
3

התחברות עם OAuth

כל לקוח MCP שתומך בשרתים מרוחקים עם OAuth (Claude, ChatGPT, Claude Code, Cursor ואחרים) יכול להתחבר ל-endpoint שלמעלה ללא הגדרות בצד FastComments. הלקוח רושם את עצמו באמצעות Dynamic Client Registration או מזהה את עצמו באמצעות Client ID Metadata Document, פותח דפדפן כדי שתוכלו להתחבר ל-FastComments ולאשר גישה, ומקבל טוקן הקשור לחשבון שהייתם מחוברים אליו.

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

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

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

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

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

Setup Page
Copy Copy
1
2https://fastcomments.com/auth/my-account/mcp-setup
3

Claude Code

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

Claude Code Setup
Copy Copy
1
2claude mcp add --transport http fastcomments https://fastcomments.com/mcp
3

Cursor ולקוחות אחרים מבוססי קובץ קונפיגורציה

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

MCP Client Config
Copy Copy
1
2{
3 "mcpServers": {
4 "fastcomments": {
5 "type": "http",
6 "url": "https://fastcomments.com/mcp"
7 }
8 }
9}
10

שלילת גישה

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

שימוש בטוקן עם ה-REST API

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

Bearer Token
Copy Copy
1
2curl -H "Authorization: Bearer fcat_..." https://fastcomments.com/api/v1/comments
3

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

התחברות עם מפתח API

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

API Key Endpoint
Copy Copy
1
2https://fastcomments.com/mcp?tenantId=YOUR_TENANT_ID&API_KEY=YOUR_API_KEY
3

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

אבטחה

URL של endpoint שמכיל מפתח API הוא סוד: אל תדביקו אותו בצ'אטים ציבוריים, בצילומי מסך או בקומיטים. אם מפתח נחשף, החליפו אותו בעמוד API Keys בדשבורד שלכם. טוקני 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.

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