התקנת שרת ה-MCP
השרת רץ אצלך ומשתמש באסימון שלך. אין חשבון משותף ואין מפתח מובנה.
שלב 1: אסימון API
- להיכנס ל-app.cig.chat.
- לפתוח את הבוט שרוצים לחבר.
- הגדרות ← API, ולהעתיק את האסימון.
אסימון אחד שולט בבוט אחד בדיוק. הוא מאפשר קריאת רשימת המנויים ושליחת הודעות בשמך - כדאי להתייחס אליו כמו לסיסמה, לא לשתף אותו ולא להעלות אותו לגיט. אם הוא נחשף, אפשר להנפיק חדש באותו מסך.
שלב 2: הוספת השרת
Claude Code
claude mcp add cigchat \
--env CIGCHAT_API_TOKEN=your-token-here \
-- npx -y @cig-chat/mcpClaude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"cigchat": {
"command": "npx",
"args": ["-y", "@cig-chat/mcp"],
"env": { "CIGCHAT_API_TOKEN": "your-token-here" }
}
}
}Cursor
~/.cursor/mcp.json
אותו מבנה בדיוק כמו Claude Desktop.
שלב 3: בדיקה
להריץ בטרמינל:
CIGCHAT_API_TOKEN=your-token-here npx -y @cig-chat/mcp --checkואז לשאול את העוזר: "לאיזה בוט שיג ושיח אני מחובר?"
הגדרות
| משתנה | ברירת מחדל | מה זה עושה |
|---|---|---|
CIGCHAT_API_TOKEN | — | חובה. האסימון של הבוט שלך. |
CIGCHAT_TOOLSETS | all | all, dynamic, או רשימת קבוצות מופרדת בפסיקים. |
CIGCHAT_ALLOW | all | אילו רמות סיכון לחשוף: read,write,send,broadcast,destructive. |
CIGCHAT_DRY_RUN | false | true הופך כל כתיבה לפעולה ריקה שמדווחת מה הייתה שולחת. |
CIGCHAT_MAX_BROADCAST_RECIPIENTS | 0 | סירוב לשידור מעל גודל קהל זה. 0 = בלי מגבלה. |
CIGCHAT_RPS | 5 | הגבלת קצב בקשות מצד הלקוח. |
התחלה בטוחה
להרצה ראשונה מומלץ להוסיף CIGCHAT_DRY_RUN=true. כל פעולת כתיבה תדווח בדיוק מה היא הייתה שולחת, בלי לשלוח דבר. קריאות ממשיכות לעבוד כרגיל.
תקלות נפוצות
| תסמין | סיבה |
|---|---|
| 401 / האסימון נדחה | האסימון שגוי, בוטל, או שייך לבוט אחר. להנפיק חדש בהגדרות ← API. |
| כלי חסר | הקבוצה או רמת הסיכון שלו כבויות. להריץ את הכלי cigchat_list_toolsets. |
| 429 הגבלת קצב | להוריד את CIGCHAT_RPS. שליחות לא נשלחות שוב אוטומטית - כדאי לוודא אם ההודעה יצאה לפני ניסיון חוזר. |
| 422 שדה חסר | פרמטר מסוג מערך צריך אובייקטים ולא מחרוזות, למשל [{"tag_ns":"f1t1"}]. |
| שידור מחזיר requires_confirmation | זו ההתנהגות הרצויה. להציג את הערכת הקהל לאדם, ורק אחרי אישור לקרוא שוב עם האסימון שהוחזר. |