דלגו לתוכן
Timix.co.il Timix.co.il

שרת MCP לסוכני AI

שרת MCP למעקב שעות עם 115 כלים

Timix.co.il מפעילה שרת MCP מרוחק מעל נתוני השעות לחיוב, התקציבים והחשבוניות שלה. סוכנים מתחברים ב-Streamable HTTP עם OAuth 2.1 או מפתח API, פועלים עם התפקיד של מי שעומד מאחורי המפתח, ורואים נתוני עלות ושולי רווח רק אם פתחתם את זה למפתח הספציפי.

ניסיון חינם של 90 יום, גישה מלאה, ללא כרטיס אשראי.

השרת בארבע שורות
  • כלים, 29 לקריאה בלבד ו-86 שכותבים 115
  • פרוטוקול תעבורה Streamable HTTP
  • אימות OAuth 2.1 או מפתח tmx_
  • מגבלת קריאות למפתח, לדקה 120 עד 1000

רישומים להמחשה

01 הבעיה

חיבור סוכן למערכת מעקב שעות הוא בדרך כלל עבודה בהתאמה אישית

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

קוד חיבור לכל לקוח

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

מפתח שיכול הכול

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

אין תמונה של מה הסוכן עשה

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

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

בלשונית הדוחות

דוחות שבאמת תפתחו

כל סביבת עבודה מגיעה עם עמודי דוח מובנים. אלה הדוחות שהצוות הזה חוזר אליהם שוב ושוב — כל אחד מהם ניתן לייצוא ל-PDF או CSV, מוכן לחיוב.

  • Unbilled Time
  • Customer Billing
  • Daily Summary
  • Weekly Timesheet

לפי תפקיד

ספר חשבונות אחד, זווית ראייה שונה לכל תפקיד

Owner, Admin, Finance, Manager, Member, Viewer — שישה תפקידים, מוגדרים כך שכל אחד רואה רק את מה שצריך לראות.

מפתח / בונה סוכנים

קראו את הקטלוג עם tools/list בלי אימות, צרו מפתח לכל לקוח, תנו לו שם ברור, הגדירו תפוגה והשאירו את ההרשאות שלו צרות.

Owner / Admin

החליטו מי יוצר מפתחות, השאירו נתונים רגישים כבויים אלא אם מפתח צריך אותם, ובטלו חיבור בעמוד ה-API Keys ברגע שהוא נחשף.

Finance / Manager

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

03 מכוונים את הסוכן אליו

פותחים ארגון, יוצרים מפתח, קוראים ל-tools/list

התחילו ניסיון חינם, פתחו את API Keys תחת Account, צרו מפתח ושלחו בקשת initialize לנקודת הקצה. אחר כך הציגו את הכלים שהתפקיד שלכם רשאי להשתמש בהם והפעילו אחד מהם מול הארגון שלכם. רק Owner ו-Admin יכולים ליצור מפתחות.

התחילו בחינם בלי כרטיס אשראי

ניסיון חינם של 90 יום, גישה מלאה, ללא כרטיס אשראי.

04 שאלות נפוצות

שרת MCP למעקב שעות — שאלות ותשובות

מהי נקודת הקצה, ובאיזה פרוטוקול תעבורה היא משתמשת?

https://api.timix.ai/api/integration/v1/mcp, בתעבורת Streamable HTTP. השרת חסר מצב: לא מונפקים סשנים, וכל הודעת JSON-RPC היא POST. תעבורת HTTP יחד עם SSE הישנה לא מוצעת, והשרת חושף כלים בלבד, לא משאבים ולא פרומפטים.

איך מאמתים סוכן?

בשתי דרכים. אפליקציות צ'אט משתמשות ב-OAuth 2.1 עם PKCE ו-dynamic client registration, בלי להעתיק מפתח. IDE, כלי שורת פקודה וסקריפטים שולחים מפתח API מסוג tmx_ כ-X-Api-Key או ככותרת Authorization מסוג Bearer. למפתח שמאחורי התחברות OAuth אין תפוגה ואין refresh token. הוא עובד עד שמבטלים אותו, או עד שבעליו מוסר או מושבת.

איך מחברים את Claude Code או את Cursor?

ב-Claude Code מריצים: claude mcp add --transport http timix https://api.timix.ai/api/integration/v1/mcp, ואז מריצים /mcp בתוך Claude Code כדי להתחבר. שימו לב: אם מגדירים כותרת Authorization, Claude Code משתמש בה ולא עובר ל-OAuth. ב-Cursor מוסיפים שרת עם url בכתובת https://api.timix.ai/api/integration/v1/mcp לקובץ mcp.json, ואם מעדיפים מפתח על פני OAuth, מוסיפים רשומת headers עם מפתח tmx_. התייחסו לקובץ הזה כאל סוד.

מה מפתח יכול לעשות, ומה לא?

הוא פועל עם התפקיד של בעליו בתוך ארגון אחד. מפתח שנוצר ידנית מתחיל עם ההרשאה read, ואת write, financial, destructive ו-admin מפעילים לכל מפתח בנפרד. נתוני עלות, רווח, שוליים ופרטי קשר מוסתרים אלא אם המפתח הופעל לכך. ביטול מפתח נכנס לתוקף מיד.

איזה מסלול צריך, ומה כל מסלול מגביל?

השרת, OAuth ומפתחות ה-API פתוחים בכל מסלול, כולל החינמי, ובמסלול החינמי יש 5 משתמשים. המסלול מגביל אילו כלים רצים וכמה קריאות בדקה: 120 ב-Free וב-Starter, 300 ב-Professional ו-1000 ב-Business או בתקופת ניסיון פעילה. כלים של חשבוניות, אישורי זמן, ייבוא המוני, דוחות מתוזמנים, תעריפי עלות, שדות מותאמים, לוחות זמנים וחגים, דוחות ניצולת ו-AI Insights דורשים את היכולת המתאימה בתשלום. ה-REST API וה-webhooks דורשים Professional ומעלה.

האם הסוכן משנה נתונים מיד?

רשומות זמן נוצרות כטיוטה. גם חשבוניות שנוצרות הן טיוטה. רוב שאר הכלים שכותבים, למשל יצירת לקוח או פרויקט, נכנסים לתוקף מיד. כלים שמוחקים, סוגרים תקופה או מנפיקים ומבטלים חשבונית מחזירים תצוגה מקדימה, ורצים רק כשקוראים להם שוב עם האישור שהתצוגה המקדימה מציינת. את הקריאה השנייה מבצע העוזר, לא Timix.co.il.

גם למערכות מעקב שעות אחרות יש שרת MCP. למה דווקא זה?

לכמה מהן יש. מה ש-Timix.co.il מציעה הוא עומק מאחורי הכלים: שעות לחיוב, תקציבים, שולי רווח וחשבוניות בקטלוג אחד, הסתרה לפי מפתח, שישה תפקידים בארגון וממשק באנגלית ובעברית עם תמיכה בכתיבה מימין לשמאל. השוו את רשימות הכלים ואת מודל האימות לדרישות שלכם.

האם Timix.co.il קשורה ל-Anthropic או ל-OpenAI?

לא. Timix.co.il היא עצמאית ואינה קשורה ל-Anthropic או ל-OpenAI, ואינה מאושרת או ממומנת על ידיהן. Claude הוא סימן מסחרי של Anthropic. ChatGPT הוא סימן מסחרי של OpenAI.

מוכנים? אנחנו כאן.

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

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