کسی بھی MCP کلائنٹ سے Hermoso چلائیں

Hermoso کا سرور ایک سادہ Model Context Protocol سرور ہے، تو “کون سا کلائنٹ؟” زیادہ تر config کی سِنٹیکس کا سوال ہے، صلاحیت کا نہیں۔ اندر جانے کے دو راستے ہیں، اور دونوں ایک ہی 922+ ٹولز تک پہنچتے ہیں۔

دو ٹرانسپورٹ

• ہوسٹڈ، streamable HTTP: https://app.hermoso.ai/mcp۔ زیادہ تر کلائنٹس یہی چاہتے ہیں۔ یہ OAuth کو dynamic client registration اور PKCE کے ساتھ سپورٹ کرتا ہے، تو مکمل authorization فلو بولنے والے کلائنٹ کو کوئی کلید نہیں چاہیے؛ جو کلائنٹ ایسا نہ کر سکے وہ اس کے بجائے Authorization: Bearer hmk_… ہیڈر بھیج سکتا ہے۔ نوٹ کریں یہ صرف streamable HTTP ہے۔ یہاں کوئی legacy HTTP+SSE اینڈ پوائنٹ نہیں، تو صرف پرانا ٹرانسپورٹ بولنے والے کلائنٹ کے لیے یہاں کچھ نہیں ہے۔
• stdio، npm کے ذریعے: npx -y hermoso mcp، آپ کی کلید HERMOSO_TOKEN میں۔ کوئی بھی stdio MCP کلائنٹ اسے لوڈ کر سکتا ہے۔ یہی پیکج ایک CLI بھی ہے (npm install -g hermoso)، جو ٹرمینل ایجنٹس کے لیے ٹوکن کا سستا راستہ ہے: وہ ہر کمانڈ کے لیے شیل کرتے ہیں، بجائے اس کے کہ ہر ٹرن میں 922+ ٹولز کا مینی فیسٹ ساتھ لے جائیں۔

ایجنٹس سرور کارڈ کو /.well-known/mcp.json پر خود دریافت کر سکتے ہیں، اور یہ سرکاری MCP رجسٹری میں io.github.hermoso-ai/hermoso کے نام سے درج ہے۔

عمومی config بلاک

زیادہ تر کلائنٹس اس کی کسی شکل کو قبول کرتے ہیں:

{ "mcpServers": { "hermoso": {
    "url": "https://app.hermoso.ai/mcp",
    "headers": { "Authorization": "Bearer <your key>" }
} } }

کلید Hermoso میں MCP اور CLI → ٹرمنل اور اے پی آئی کیز کے تحت بنائیں۔ ایک کلائنٹ استثنا ہے: Codex TOML پڑھتا ہے، JSON نہیں، تو کاپی کیا گیا mcpServers بلاک وہاں لوڈ نہیں ہوگا۔ اس کے بجائے چار لائنیں Codex صفحے پر ہیں۔

اپنا صفحہ رکھنے والے کلائنٹس

• Claude: OAuth سے جڑتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔
• ChatGPT: OAuth سے جڑتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔
• Claude Code: ٹرمینل سے hermoso auth login کے ذریعے سائن ان کرتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں؛ یہ ٹرمینل ایجنٹ ہے، تو لمبے کاموں کے لیے CLI سستا راستہ ہے۔
• Cursor: ٹرمینل سے hermoso auth login کے ذریعے سائن ان کرتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔
• Codex: ٹرمینل سے hermoso auth login کے ذریعے سائن ان کرتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں؛ ٹرمینل ایجنٹ ہے، تو لمبے کاموں کے لیے CLI سستا راستہ ہے۔
• Cline: API کلید Authorization ہیڈر میں لیتا ہے۔
• OpenClaw: ٹرمینل سے hermoso auth login کے ذریعے سائن ان کرتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں؛ ٹرمینل ایجنٹ ہے، تو لمبے کاموں کے لیے CLI سستا راستہ ہے۔
• Grok Bot: Hermoso Marketing Bot ٹیمپلیٹ شامل کرتا ہے اور چیٹ میں API کلید لیتا ہے، یا Bot کے اپنے ٹرمینل سے سائن ان کرتا ہے۔
• Hermes: ٹرمینل سے hermoso auth login کے ذریعے سائن ان کرتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں؛ ٹرمینل ایجنٹ ہے، تو لمبے کاموں کے لیے CLI سستا راستہ ہے۔
• Gemini CLI: ٹرمینل سے hermoso auth login کے ذریعے سائن ان کرتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں؛ ٹرمینل ایجنٹ ہے، تو لمبے کاموں کے لیے CLI سستا راستہ ہے۔
• Perplexity: OAuth سے جڑتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔
• Le Chat: OAuth سے جڑتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔
• Claude Cowork: OAuth سے جڑتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔
• Perplexity Computer: OAuth سے جڑتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔
• Paperclip: OAuth سے جڑتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔
• Gemini: OAuth سے جڑتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔
• Grok Build: ٹرمینل سے hermoso auth login کے ذریعے سائن ان کرتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں؛ ٹرمینل ایجنٹ ہے، تو لمبے کاموں کے لیے CLI سستا راستہ ہے۔
• Kimi Code: hosted URL کو mcp.json میں شامل کرتا ہے اور /mcp-config login سے سائن ان کرتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں؛ ٹرمینل ایجنٹ ہے، تو لمبے کاموں کے لیے CLI سستا راستہ ہے۔
• DeepSeek Harness: ٹرمینل سے hermoso auth login کے ذریعے سائن ان کرتا ہے اور Hermoso کو مقامی سرور کے طور پر چلاتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔
• Manus: API کلید Authorization ہیڈر میں لیتا ہے۔
• Muse، ایک چیٹ پیغام سے سیٹ اپ ہوتا ہے جو OAuth سے جڑتا ہے، کچھ چسپاں کرنے کی ضرورت نہیں۔

چار کلائنٹس کا اپنا صفحہ نہیں ہے، اور یہ بتانا فائدہ مند ہے کہ کیوں، تاکہ ہم اس سے زیادہ سپورٹ کا تاثر نہ دیں جو ہم نے جانچا ہے۔ VS Code: Hermoso ایک ون کلک VS Code deeplink شائع کرتا ہے، مگر پروڈکٹ میں کہیں VS Code انسٹال بلاک نہیں اور کوئی جانچا ہوا راستہ نہیں، اس لیے کوئی صفحہ اس کا دعویٰ نہیں کرتا۔ deeplink صرف بنیادی اینڈ پوائنٹ انسٹال کرتا ہے اور تصدیق VS Code کے اپنے OAuth پر چھوڑتا ہے۔ Claude Desktop: Claude Desktop وہی Connectors فلو استعمال کرتا ہے جو claude.ai پر ہے، اس لیے یہ Claude صفحے میں شامل ہے، اسے دہرایا نہیں گیا۔ Grok: Grok چیٹ آج /mcp پر سیٹ اپ کارڈ کے ذریعے جڑتا ہے؛ اس کا اپنا صفحہ ابھی نہیں کیونکہ اس کا فی چینل متن ChatGPT صفحات کو دہرائے گا بغیر وہ کچھ شامل کیے جو صرف ہم کہہ سکتے ہیں۔ Muse: Meta Muse ایک چیٹ پیغام سے سیٹ اپ ہوتا ہے نہ کہ سیٹنگز اسکرین سے، اس لیے اس کی گائیڈ hermoso.ai/muse پر ہاتھ سے لکھی گئی ہے، یہاں خودکار طور پر نہیں بنائی گئی۔

ہر چینل، ان میں سے کسی سے بھی

کلائنٹ جو پہنچ میں ہے اسے نہیں بدلتا۔ ان میں سے کسی سے بھی: Facebook، Instagram، Threads، TikTok، YouTube، X، LinkedIn، Pinterest، Bluesky، Telegram، Google Business Profile پر شائع اور شیڈول کریں؛ Meta، Google اور LinkedIn اشتہاری لائبریریوں کے ساتھ آرگینک TikTok، Instagram، YouTube، Reddit اور Threads پر تحقیق کریں؛ 100+ ماڈلز پر تیار تصویری اور ویڈیو اشتہارات رینڈر کریں؛ اور Meta، Google Ads، Microsoft Advertising، Reddit Ads، LinkedIn، Pinterest، X Ads، TikTok Ads، Snapchat Ads، ChatGPT Ads، Apple Search Ads اور AppLovin Ads پر مہمات بنائیں۔

ایک اشاعتی سطح بنائی گئی ہے اور پلیٹ فارم کے انتظار میں روکی ہوئی ہے: Reddit: آرگینک پوسٹنگ اور پوسٹ کے اعداد و شمار بنے ہوئے ہیں، مگر Reddit کی Responsible Builder Policy کو Data API استعمال کرنے سے پہلے واضح تحریری منظوری درکار ہے، اور وہ درخواست ابھی منظور نہیں ہوئی۔ کنیکٹر کو OAuth اسکرین دینے کے بجائے، جو ایک مردہ API کی طرف لے جاتی، روکا ہوا رکھا گیا ہے۔ Reddit Ads ایک الگ کنکشن ہے اور یہ فعال ہے: مکمل مہم کا درخت، پیش گوئی، ٹارگٹنگ سرچ، پکسلز اور لیڈ فارمز۔

کوئی کلائنٹ اکیلے کیا نہیں کر سکتا

ایک ایجنٹ جس کے پاس بجٹ ہو تبھی کارآمد ہے جب اس کا اثر محدود ہو، اس لیے باڑ پرامپٹ میں نہیں بلکہ سرور میں ہے۔ ہر اشتہاری مہم، ایڈ سیٹ، ایڈ گروپ اور اشتہار روکا ہوا بنایا جاتا ہے، اور اسٹیٹس سوئچز جو حقیقی پیسہ چلاتے ہیں ایک واضح تصدیقی فلیگ کے بغیر نہیں چلتے۔ ہر رینڈر پہلے کوٹ کیا جاتا ہے (hermoso_capabilities چلنے سے پہلے ہر ماڈل کی درست کریڈٹ لاگت شائع کرتا ہے)۔ کریڈٹس پہلی فراہم کنندہ کال سے پہلے محفوظ ہوتے ہیں اور بعد میں درست لاگت پر طے ہوتے ہیں، تو ناکام ڈسپیچ کی رقم واپس ہو جاتی ہے بجائے اس کے کہ آپ کو کچھ نہ ملنے پر بل آئے۔ حذف کرنا بھی تصدیق سے مشروط ہے، اور ہر مہم کا درخت بتانے سے پہلے اشتہاری پلیٹ فارم سے دوبارہ پڑھا جاتا ہے۔

ایک قدم جان بوجھ کر آپ کا ہے: ہر اکاؤنٹ کو ایک بار جوڑنا۔ زیادہ تر چینلز پلیٹ فارم کی اپنی OAuth رضامندی کی اسکرین کے ذریعے براؤزر میں جڑتے ہیں؛ Bluesky ایک ایپ پاس ورڈ لیتا ہے اور Telegram ایک بوٹ ٹوکن، جو Hermoso میں چسپاں کیا جاتا ہے۔ اس کے بعد ہر چیز ایک ٹول کال ہے۔

اکثر پوچھے گئے سوالات

کیا Hermoso کسی بھی MCP کلائنٹ کے ساتھ کام کرتا ہے؟

stdio پر، ہاں۔ کوئی بھی کلائنٹ جو npx -y hermoso mcp چلا سکتا ہے وہ 922+ ٹولز حاصل کرتا ہے۔ ہوسٹڈ اینڈ پوائنٹ پر یہ صرف streamable HTTP ہے: کوئی legacy HTTP+SSE راستہ نہیں، تو صرف پرانا ٹرانسپورٹ بولنے والے کلائنٹ کے لیے یہاں کچھ نہیں ہے۔

کیا مجھے API کلید چاہیے، یا OAuth کام کرتا ہے؟

دونوں راستے موجود ہیں۔ ہوسٹڈ اینڈ پوائنٹ dynamic client registration اور PKCE کے ساتھ OAuth سپورٹ کرتا ہے، جس کے ذریعے Claude، ChatGPT، Perplexity، Le Chat، Claude Cowork، Perplexity Computer، Paperclip اور Gemini کنیکٹرز بغیر کچھ چسپاں کیے سائن ان کرتے ہیں۔ مقامی پروسیس شروع کرنے والے کلائنٹس اس کے بجائے ایک بار hermoso auth login سے سائن ان کرتے ہیں، اور جو کلائنٹ دونوں میں سے کچھ نہ کر سکے وہ Authorization: Bearer ہیڈر میں API کلید (hmk_…) بھیجتا ہے، جو MCP اور CLI ٹیب پر ٹرمنل اور اے پی آئی کیز کے تحت بنائی جاتی ہے۔

MCP اینڈ پوائنٹ URL کیا ہے؟

https://app.hermoso.ai/mcp، جو /.well-known/mcp.json پر سرور کارڈ میں streamable-HTTP remote کے طور پر ظاہر ہے۔ پیکج npm پر hermoso ہے اور سرکاری MCP رجسٹری میں io.github.hermoso-ai/hermoso۔