02 איך Timix.co.il מתאימה
שרת סטנדרטי, עם הבקרות מובנות
השרת הוא מתאם פרוטוקול דק מעל אותו תהליך אבטחה לכל בקשה שיש ל-REST API: בידוד בין ארגונים, בדיקות תפקיד והגבלת קצב. הוא פתוח בכל מסלול, והמסלול קובע אילו כלים רצים, לא אם אפשר להתחבר.
Streamable HTTP מרוחק וחסר מצב
נקודת קצה אחת מקבלת JSON-RPC ב-POST. השרת מדבר בגרסאות פרוטוקול MCP 2025-11-25, 2025-06-18, 2025-03-26 ו-2024-11-05. הוא חושף כלים בלבד, בלי משאבים ובלי פרומפטים, והוא לא מציע את תעבורת HTTP יחד עם SSE הישנה, ולכן לקוח שמדבר רק אותה לא יכול להתחבר.
https://api.timix.ai/api/integration/v1/mcp. בלי סשנים, בלי זרמים הניתנים להמשך, בלי אצוות JSON-RPC.
OAuth 2.1 לאפליקציות צ'אט, מפתחות API ל-IDE ולסקריפטים
לקוחות OAuth רושמים את עצמם בעזרת dynamic client registration ו-PKCE, ולכן אין מפתח להדביק. עבור Claude Code, Cursor וסקריפטים יוצרים מפתח tmx_ ושולחים אותו כ-X-Api-Key או כ-Bearer token. ב-Claude Code משתמשים ב-claude mcp add, וב-Cursor מוסיפים url ל-mcp.json.
claude mcp add --transport http timix https://api.timix.ai/api/integration/v1/mcp ואז /mcp כדי להתחבר. Cursor mcp.json: {"mcpServers":{"timix":{"url":"https://api.timix.ai/api/integration/v1/mcp"}}}
הרשאות לפי מפתח, ותפקיד מעליהן
מפתח שיוצרים ידנית מקבל כברירת מחדל את ההרשאה read. ההרשאות הן read, write, financial, destructive ו-admin. מעל ההרשאה, המפתח פועל עם התפקיד של בעליו בארגון, והארגון קבוע לפי המפתח: אין כלי שמציג או מחליף ארגונים. התחברות OAuth מעניקה כל יכולת שהתפקיד של האדם מתיר.
תפקידים: Owner, Admin, Finance, Manager, Member, Viewer. tools/list מציג רק מה שהתפקיד רשאי להשתמש בו, ו-tools/call בודק שוב.
נתונים רגישים מוסתרים כברירת מחדל
תעריפי עלות, נתוני רווח ושולי רווח, ופרטי קשר כמו אימייל, טלפון ומספר מזהה לצורכי מס מוחלפים בסימון לפני שתוצאה יוצאת מ-Timix.co.il. הכנסות, שעות, תקציבים ושמות נשארים גלויים. אפשר להפעיל למפתח גישה לכל הנתונים, אבל רק כל עוד לבעליו יש תפקיד שמורשה לכך. כל tools/call נרשם עם מי, איזה כלי, התוצאה והאם הוסתר מידע, אבל אף פעם לא הארגומנטים או התוצאה עצמה.
allowSensitiveData נקבע לכל מפתח בעת יצירתו. יומן הביקורת נמצא בצד של Timix.co.il, ואין מסך באפליקציה שמציג אותו.
כותרות והערות על כל כלי
לכל כלי יש כותרת MCP וההערות readOnlyHint, destructiveHint, idempotentHint ו-openWorldHint. 35 כלים שכותבים מציגים תצוגה מקדימה קודם, ורצים רק כשהעוזר קורא להם שוב עם האישור שהתצוגה המקדימה מציינת. את הקטלוג המלא אפשר לקרוא עם tools/list בלי אימות, כך שאפשר לבדוק אותו עוד לפני שנרשמים.
115 כלים: 29 לקריאה בלבד, 86 שכותבים. רשומות זמן נוצרות כטיוטה; רוב שאר הכלים שכותבים פועלים מיד.
מגבלות קצב ומגבלות מסלול, בגלוי
הקריאות נספרות לכל מפתח בחלון של 60 שניות: 120 ב-Free וב-Starter, 300 ב-Professional, ו-1000 ב-Business או בתקופת ניסיון פעילה. מעבר למגבלה מתקבל 429 עם כותרת Retry-After. כלים של יכולות בתשלום עונים בשגיאה שמציינת את היכולת החסרה ואת המסלול שכולל אותה. ה-REST API וה-webhooks נשארים מ-Professional ומעלה.
מסלול Free: 5 משתמשים. דוחות ניצולת מ-Professional ומעלה; ציון הבריאות של לקוח דורש AI Insights, ב-Business.
115 כלים, עם כותרת והערות על כל אחד
35 כלים שכותבים ומציגים תצוגה מקדימה לפני שהם רצים
5 הרשאות לכל מפתח: read, write, financial, destructive, admin