# خلّ وكيل الذكاء الاصطناعي حقك يسوّي الموسيقى.

> خلّ Claude أو ChatGPT أو Codex أو Cursor يسوّي ألحان ويعدّلها، بأصوات عربية مثل الدربوكة والعود والناي. خذ مفتاح، الصق سطر، واطلب.

اربط Claude أو ChatGPT أو Codex أو Cursor بـ Shawarma. اطلب لحن بكلام عادي، وبعدين اطلب تغييرات: وكيلك يغيّر بس الجزء اللي طلبته، وكل نسخة تنحفظ.

[خذ مفتاح API](https://shawarma.studio/auth/google?return=%2Far)

أنت: سوّ موسيقى خلفية لمعركة الزعيم في لعبتي، وبعدين خلّ الطبول أثقل.

shawarma · `make_song`(description: «معركة الزعيم، خلفية للعبة»)

سوّيت «Boss Hall»: 140 BPM، وتريات غليظة وطبول حرب. shawarma.studio/s/k7qmz2

shawarma · `change_song`(song_id: "boss-hall", request: «طبول أثقل»)

النسخة 2: كيك ثاني وتوم أعلى. الوتريات ما تغيّرت.

نمط الطبول في النسخة 2: الكيك الثاني والتوم جديدة

Claude: الطبول صارت أثقل. تبغى ملف MP3؟

أنت: إيه، لو سمحت.

shawarma · `export_audio`(song_id: "boss-hall", format: "mp3")

boss-hall.mp3 · 1:12

## ألحان يقدر وكيلك *يكمّل يغيّر فيها*

أدوات الموسيقى الثانية بالذكاء الاصطناعي ترجّع لك ملف واحد جاهز: خذه أو جرّب من جديد. لحن Shawarma مكتوب ككود، فـ«طبول أكثف» تغيّر الطبول وبس. ووكيلك يقدر يفتح اللحن الأسبوع الجاي ويكمّل من وين وقف.

1. خذ مفتاح: سجّل دخولك، افتح «المطوّرين» من قائمة حسابك، وسوّ مفتاح. Claude.ai وChatGPT ما يحتاجون مفتاح: تسجّل دخولك من التطبيق.
2. الصق سطر واحد: أضف Shawarma لوكيلك بالإعداد اللي تحت. ياخذ دقيقة.
3. اطلب موسيقى: «مقدمة هادية 20 ثانية للبودكاست حقي.» وبعدين اطلب تغييرات لين يصير مضبوط.

## الأدوات اللي ياخذها وكيلك

نفس الأدوات موجودة كـ API ويب عادي على `https://shawarma.studio/v1` لكودك أنت. كل وسيط ومسار موجود في [مرجع الـ API](https://shawarma.studio/ar/docs/api).

| الأداة | وش تسوّي | الباقة |
| --- | --- | --- |
| `make_song` | لحن جديد من كلامك: الستايل، الجو، الطول. | Pro، من رصيد الذكاء الاصطناعي حقك |
| `change_song` | يغيّر بس اللي انطلب ويحفظ نسخة جديدة. | Pro، من رصيد الذكاء الاصطناعي حقك |
| `get_song / list_songs` | الاسم، الكود، النسخ والروابط. | مجاني |
| `restore_version` | يرجع لنسخة قديمة. | مجاني |
| `share_song` | رابط عام يشتغل بدون تسجيل دخول. | مجاني |
| `export_audio` | ملف MP3 أو WAV للّحن. | Pro |
| `list_sounds` | دربوكة ورق وعود وناي، المقامات، أطقم طبول وآلات ثانية. | مجاني |
| `write_song` | وكيلك يكتب كود الموسيقى، وShawarma يفحصه ويحفظه. | مجاني |
| `check_code / guide` | يلقى الأخطاء في كود الموسيقى، ودليل مختصر للوكيل. | مجاني |
| `get_job` | يتابع الطلب الطويل (تلحين، صوت) لين يجهز. | مجاني |

## طريقتين للتأليف

Pro

### Shawarma يألّف

وكيلك يرسل كلام، والمؤلّف حق Shawarma يكتب اللحن، نفسه اللي في التطبيق. يستهلك من رصيدك الشهري للذكاء الاصطناعي. وتقدر تصدّر ملفات MP3 وWAV بعد.

مجاني

### وكيلك يألّف

وكيلك يقرأ الدليل القصير، ويكتب كود الموسيقى بنفسه، وShawarma يتحقق منه ويحفظه ويشغّله ويشاركه. لين 30 لحن في اليوم، محفوظة في مشاريعك الـ 3.

[شوف الأسعار](https://shawarma.studio/ar/pricing)

## جهّزه

العنوان لكل وكيل هو `https://shawarma.studio/mcp`. بدّل `shk_…` بمفتاح من «المطوّرين» في قائمة حسابك.

### Claude Code

شغّل هذا مرة وحدة في الـ terminal.

```
claude mcp add --transport http shawarma https://shawarma.studio/mcp \
  --header "Authorization: Bearer shk_…"
```

### Codex

ضيف هذا في ~/.codex/config.toml، وبعدين حط المفتاح في ملف إعدادات الـ shell.

```
[mcp_servers.shawarma]
url = "https://shawarma.studio/mcp"
bearer_token_env_var = "SHAWARMA_API_KEY"

# in ~/.zshrc or ~/.bashrc
export SHAWARMA_API_KEY="shk_…"
```

### Cursor

ضيف هذا في ~/.cursor/mcp.json (أو .cursor/mcp.json داخل مشروع). Cursor يستخدم مفتاح: ما فيه تسجيل دخول لـ Shawarma.

```
{
  "mcpServers": {
    "shawarma": {
      "url": "https://shawarma.studio/mcp",
      "headers": { "Authorization": "Bearer shk_…" }
    }
  }
}
```

### Claude.ai

ما فيه مفتاح تنسخه: تسجّل دخولك في Shawarma.

1. افتح Settings، بعدها Connectors.
2. اختر Add custom connector والصق العنوان اللي فوق.
3. اختر Connect، سجّل دخولك في Shawarma واختر «اسمح».

### ChatGPT

ما فيه مفتاح تنسخه: تسجّل دخولك في Shawarma.

1. افتح Settings، بعدها Apps and connectors. تحت Advanced settings، شغّل developer mode (الـ custom connectors تحتاجه).
2. اختر Create، الصق العنوان اللي فوق واختر OAuth.
3. سجّل دخولك في Shawarma واختر «اسمح».

### كودك أنت

استدعِ API الموسيقى عبر HTTPS بنفس المفتاح.

```
curl https://shawarma.studio/v1/songs \
  -H "Authorization: Bearer shk_…" \
  -H "Content-Type: application/json" \
  -d '{"description": "calm 20-second intro for a podcast"}'
```

## أسئلة

**وش يعني خادم MCP؟**

MCP هي الطريقة اللي تستخدم فيها وكلاء الذكاء الاصطناعي، زي Claude وChatGPT وCodex وCursor، أدوات من برّا. ضيف Shawarma مرة وحدة، ووكيلك يقدر يسوي ألحان ويعدّلها ويصدّر الصوت لما تطلب.

**لازم يكون عندي Pro؟**

لا. في الباقة المجانية: وكيلك يكتب كود الموسيقى بنفسه، وShawarma يفحصه ويحفظه ويشغّله ويشاركه. لين 30 لحن في اليوم، وتنحسب من مشاريعك الـ 3. ومع Pro، الذكاء الاصطناعي في Shawarma يلحّن من كلامك، ووكيلك يقدر يصدّر ملفات MP3 وWAV.

**هل يستهلك من tokens وكيلي أو من رصيدي في Shawarma؟**

لما Shawarma يلحّن، يستهلك من رصيد الذكاء الاصطناعي حقك في Shawarma، نفس الرصيد اللي في التطبيق. ولما وكيلك يكتب كود الموسيقى بنفسه، التفكير كله على وكيلك وShawarma ما يستهلك شي من رصيدك.

**يقدر وكيلي يعدّل لحن سوّاه قبل؟**

إيه. كل لحن يحتفظ بنسخه. اطلب طبول أكثف أو نهاية أطول، ويتغيّر هالجزء بس. واطلب ترجع، وترجع النسخة اللي قبل.

**مفتاح API حقي آمن؟**

Shawarma يحتفظ ببصمة لكل مفتاح بس، ويعرض لك المفتاح مرة وحدة. كل مفتاح له حدوده، وتقدر تلغيه متى ما بغيت. وما فيه مفتاح يقدر يغيّر الدفع والفواتير أو يحذف حسابك.

**لمين الألحان؟**

اللي تسويه لك، وتقدر تستخدمه في فيديوهاتك وألعابك. بعض الأصوات الجاهزة تطلب ذكر مصدرها، وقائمتها في صفحة الشروط. [مصادر الأصوات](https://shawarma.studio/ar/terms#sound-credits)

## عطِ وكيلك فرقة موسيقية

ابدأ مجانًا. Pro يضيف المؤلّف حق Shawarma وملفات الصوت.

[خذ مفتاح API](https://shawarma.studio/auth/google?return=%2Far) [شوف الأسعار](https://shawarma.studio/ar/pricing)

---

الصفحة: https://shawarma.studio/ar/developers