דלג לתוכן הראשי
עיון בתיעוד

Syncanix עם Fastify

הפכו API של Fastify למוכן לסוכנים: מה הגילוי קורא, איך מריצים אותו ואיך משחררים את ממשק הצ׳אט ושרת ה‑MCP.

Fastify עוטף נתיבים בפלאגינים ומעגן אותם עם קידומות. הגילוי עוקב אחרי register(plugin, { prefix }) בין קבצים, כך שנתיבי פלאגינים מקוטלגים בנתיביהם המלאים.

מה הגילוי קורא

הגילוי סטטי — הוא קורא את קוד המקור שלכם, לא את התעבורה. הוא מרכיב נתיבי בקשה מלאים בין קבצים, כך שקידומות שעוגנו הן חלק מכל נתיב שחולץ:

// server.ts
await fastify.register(ordersPlugin, { prefix: '/api' });

// orders.plugin.ts
fastify.get('/orders/:id', getOrder);        // → GET /api/orders/:id
fastify.post('/orders/:id/refund', refund);  // → POST /api/orders/:id/refund
נתיבים מייצגים שהמחלץ מרכיב — נתיבים מלאים, כולל קידומות.

המחלץ עוקב אחרי עיגוני register(plugin, { prefix }) בין קבצים — כולל קידומות שנגזרות מתיקיות ב‏‎@fastify/autoload ודריסות autoPrefix — כך שנתיבים עטופים בפלאגינים נושאים את נתיב העיגון המלא שלהם.

הרצת הגילוי

משורש המאגר, הריצו את פקודת init. היא מזהה את הפריימוורק אוטומטית, מבקשת את הסכמתכם לפני כל העשרה באמצעות LLM, וכותבת קטלוג דטרמיניסטי:

$ npx syncanix init
✓ detected framework
✓ scanned routes
✓ wrote .syncanix/catalog.json
→ review your capabilities in the dashboard

סקירת הקטלוג

הקטלוג ב‏‎.syncanix/catalog.json מפרט כל יכולת שהגילוי מצא — מתודה, נתיב והתיאור המועשר שהמשתמשים שלכם יראו. סקרו אותו כמו קוד לפני ההעלאה: זהו החוזה שממשק הצ׳אט ושרת ה‑MCP שלכם חושפים.

שחרור הממשק

לאחר העלאת הקטלוג, הטמיעו את הווידג׳ט לצ׳אט בתוך האפליקציה וחברו את שרת ה‑MCP הפר‑טננטי ל‑Claude, ‏ChatGPT ו‑Cursor. כל פעולת כתיבה נשארת מוגבלת בהרשאות, מאושרת ומתועדת.

השלבים הבאים