# איך נותנים ל־Cursor לתמלל אודיו ווידאו?

> מוסיפים את שרת ה־MCP של KolWrite ל־~/.cursor/mcp.json (או פותחים את קישור ההתקנה שלמטה). הסוכן של Cursor יכול אז לתמלל הקלטות מהפרויקט לטקסט, לכתוביות או לתרגום. החיוב הוא לפי שנייה מתוך הקרדיטים שלכם ב־KolWrite.

עודכן לאחרונה: 2026-11-21 · HTML: https://console.kolwrite.com/he/agents/cursor

## מה עושים פעם אחת

פותחים חשבון ויוצרים מפתח בעצמכם ב־[console.kolwrite.com](https://console.kolwrite.com/auth?lang=he): נרשמים, טוענים קרדיטים, נכנסים ל־API Keys ויוצרים מפתח. סוכן לא יכול לעשות את זה במקומכם.

שומרים את המפתח בקובץ הפרופיל של ה־shell (`~/.zshrc`,‏ `~/.bashrc`) כדי שכל סשן של סוכן יוכל לקרוא אותו, ופותחים טרמינל חדש:

```bash
export KOLWRITE_API_KEY=...   # paste the key from API Keys
```

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

## מוסיפים את שרת ה־MCP

ב־`~/.cursor/mcp.json` (לכל הפרויקטים) או ב־`.cursor/mcp.json` (לפרויקט אחד). ‏`${env:KOLWRITE_API_KEY}` קורא את המפתח מהסביבה שבה Cursor הופעל:

```json
{
  "mcpServers": {
    "kolwrite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz"
      ],
      "env": {
        "KOLWRITE_API_KEY": "${env:KOLWRITE_API_KEY}"
      }
    }
  }
}
```

אפשר גם לפתוח את הקישור הזה בדפדפן במחשב שבו Cursor מותקן. Cursor שואל לפני שהוא מוסיף את השרת: [Add KolWrite to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=kolwrite&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImh0dHBzOi8vY29uc29sZS5rb2x3cml0ZS5jb20vbWNwL2tvbHdyaXRlLW1jcC0wLjEuMC50Z3oiXSwiZW52Ijp7IktPTFdSSVRFX0FQSV9LRVkiOiIke2VudjpLT0xXUklURV9BUElfS0VZfSJ9fQ==)

השרת נותן לסוכן שישה כלים: `transcribe_file`, `transcribe_url`, `upload_file`, `get_job`, `list_models`, `list_languages`. הוא רץ על המחשב שלכם עם Node.js 18 ומעלה, והוא מורד מ־https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz (SHA-256 `0dcd6ff169b860b9363044837b8545279efa585c4987b20d81035f920f6ac7ca`).

אם הכלים לא מופיעים, מפעילים את Cursor מטרמינל שבו `KOLWRITE_API_KEY` מוגדר, או פותחים את Cursor Settings, אחר כך MCP, ובודקים את סטטוס השרת.

## מוסיפים rule לפרויקט

כדי שהסוכן יכיר את ה־API גם כשהוא כותב קוד, מוסיפים rule בקובץ `.cursor/rules/kolwrite.mdc`:

```markdown
---
description: Speech-to-text with the KolWrite API
alwaysApply: false
---
For speech-to-text use the KolWrite API; read https://console.kolwrite.com/agent-instructions.md first. The key is in KOLWRITE_API_KEY; never print it.
```

## מה מבקשים

שלוש בקשות לדוגמה ל־Cursor:

```text
תמלל את ~/Downloads/interview.m4a עם KolWrite ושמור את הטקסט בקובץ interview.txt באותה תיקייה.

הכן כתוביות SRT באנגלית ל־talk.mp4 עם KolWrite, כתובית אחת לכל משפט.

מי אמר מה ב־team-call.mp3? תמלל אותו עם זיהוי דוברים במודל oracle, ואז רשום לכל דובר את המשימות שלו.
```

## כמה זה עולה

| משימה | מודל | עלות |
| --- | --- | --- |
| ראיון של 30 דקות, טקסט רגיל | `base` | 0.24 דולר |
| פגישה של שעה עם זיהוי דוברים | `oracle` | 1.56 דולר |
| הרצאה של שעה בעברית עם כתוביות באנגלית | `oracle` | 1.44 דולר |
| שעה של אודיו רועש עם דיבור חופף | `oracle_max` | 3.60 דולר |

החיוב הוא לפי שנייה של אודיו מתוך הקרדיטים שלכם, בלי מינימום. זיהוי דוברים מוסיף 0.10 קרדיטים לשעת אודיו. שרת ה־MCP ו־kolwrite.py משתמשים ב־`base` אלא אם אתם או הסוכן קובעים מודל אחר, וב־`oracle_mini` בתרגום. כל התעריפים: [/he/models](https://console.kolwrite.com/he/models).

## מה אסור לסוכן לעשות

- לבקש מכם את המפתח בצ׳אט, להדפיס אותו או לכתוב אותו לקובץ, לפקודה או ל־commit.
- להפעיל שוב את אותו תמלול אחרי timeout או שגיאת רשת. כל הפעלה היא משימה חדשה שמחויבת בנפרד, ולכן במקום זה צריך לבדוק את המשימה הקיימת או לשאול אתכם.
- להקליד חותמות זמן בעצמו. כדי לחתוך או לצטט לפי זמן הוא לוקח מספרי מקטעים מהתמליל ומחשב את הזמנים בקוד, לפי זמני המילים.
- לשלוח כתובת של YouTube או של דף אינטרנט אחר בתור המדיה. צריך את קובץ המדיה עצמו.
- לתמלל הקלטות ארוכות (מעל שעה) בלי לומר לכם קודם מה העלות הצפויה.

## שאלות ותשובות

### האם זה עובד במצב Ask?

כלי MCP רצים בסוכן. כדי לתמלל משתמשים בסוכן, ובמצב Ask אפשר לקרוא את התמליל אחר כך.

## דפים קשורים

- [Claude Code](https://console.kolwrite.com/he/agents/claude-code)
- [כל סוכן: kolwrite.py וה־skill](https://console.kolwrite.com/he/agents/any-agent)
- [עריכת וידאו עם סוכני AI](https://console.kolwrite.com/he/guides/video-editing-with-ai)
- [API לכתוביות SRT](https://console.kolwrite.com/he/guides/srt-subtitles-api)
- [תיעוד ה־API](https://console.kolwrite.com/he/public_api_docs)

---
קבלת מפתח API: https://console.kolwrite.com/auth?lang=he · תיעוד ה־API: https://console.kolwrite.com/he/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
