پرش به محتوا
شروع کنید

۸ ابزارModel Context Protocol

سرور MCP گیسو،
مدل‌های دیگر داخل Claude و Cursor

Claude، Cursor یا VS Code را به سرور MCP گیسو وصل کنید تا وسط کار از GPT، Gemini یا DeepSeek نظر دوم بگیرد، تصویر بسازد یا متن را به صدا تبدیل کند. با همان کلید API گیسو کار می‌کند و هزینهٔ هر ابزار، مثل وب‌سرویس، به‌اندازهٔ مصرف از اعتبارتان کم می‌شود.

ساخت کلید API راهنمای اتصال
نشانی سرور
claude mcp add 
$ claude mcp add --transport http gisoo \
    https://gisoo.pro/api/mcp \
    --header "Authorization: Bearer $GISOO_API_KEY"

gisoo · connected

  • list_models
  • ask_model
  • generate_image
  • text_to_speech
  • generate_music
  • create_video
  • get_video
  • account_balance

به زبان ساده

MCP چیست؟

MCP (Model Context Protocol) استانداردی باز است که Anthropic در پاییز ۲۰۲۴ منتشر کرد تا برنامه‌های هوش مصنوعی با یک زبان مشترک به ابزارهای بیرونی وصل شوند. یک طرف «سرور MCP» است که فهرست ابزارهایش را اعلام می‌کند؛ طرف دیگر برنامه‌ای مثل Claude، Cursor یا VS Code که آن ابزارها را در اختیار مدل می‌گذارد. مدل هر جا لازم بداند ابزار را صدا می‌زند و بیشتر این برنامه‌ها پیش از اجرا از شما اجازه می‌گیرند. سرور MCP گیسو همان وب‌سرویس گیسو است که به شکل ابزار درآمده؛ پس دستیار شما بی‌آن‌که کدی بنویسید به مدل‌های گیسو دسترسی پیدا می‌کند.

یک مثال واقعی

  1. ۱در Cursor می‌نویسید: «این تابع را از Gemini هم بپرسید که باگ دارد یا نه.»
  2. ۲Cursor ابزار ask_model را با مدل gemini-3.6-flash صدا می‌زند.
  3. ۳پاسخ Gemini با هزینهٔ همان درخواست به دلار برمی‌گردد و Cursor آن را کنار نظر خودش می‌گذارد.

ابزارهای سرور

سرور MCP گیسو این ابزارها را به دستیار شما می‌دهد

۵ ابزار پولی‌اند و هزینه‌شان از اعتبار هوش مصنوعی کم می‌شود؛ ۳ ابزار هزینه‌ای ندارند. این فهرست مستقیم از خود سرور خوانده می‌شود.

  • بدون هزینه

    فهرست مدل‌ها

    list_models

    مدل‌هایی که کلید شما اجازه دارد، با قیمت دلاری هر کدام؛ بدون هزینه.

  • از اعتبار

    پرسیدن از یک مدل دیگر

    ask_model

    یک پرسش را به یکی از مدل‌های گفت‌وگوی گیسو (GPT، Claude، Gemini، DeepSeek و…) می‌فرستد؛ برای نظر دوم یا ترجمه.

  • از اعتبار

    ساخت تصویر

    generate_image

    یک تصویر از روی توضیح متنی می‌سازد و همان‌جا در برنامهٔ شما نشانش می‌دهد.

  • از اعتبار

    تبدیل متن به گفتار

    text_to_speech

    متن فارسی یا انگلیسی را به فایل صوتی (MP3) تبدیل می‌کند.

  • از اعتبار

    ساخت موسیقی

    generate_music

    یک قطعهٔ کوتاه موسیقی از روی توضیح سبک و حال‌وهوا می‌سازد (MP3).

  • از اعتبار

    ساخت ویدیو

    create_video

    ساخت یک ویدیوی کوتاه را شروع می‌کند و شناسهٔ کار را برمی‌گرداند.

  • بدون هزینه

    وضعیت ویدیو

    get_video

    وضعیت ساخت ویدیو و، پس از پایان، نشانی دانلود فایل MP4؛ بدون هزینه.

  • بدون هزینه

    موجودی و سقف کلید

    account_balance

    موجودی اعتبار، مصرف همین کلید و سقف هزینه‌اش؛ بدون هزینه.

اتصال

اتصال MCP به Claude، Cursor، VS Code و Cline

در همهٔ برنامه‌ها دو چیز لازم است: نشانی https://gisoo.pro/api/mcp و کلید API گیسو در سربرگ درخواست (هدر Authorization). به‌جای sk-gisoo-v1-... کلید خودتان را بگذارید.

Claude Code

در ترمینال، یک بار این دستور را بزنید:

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

Shell Claude Code 
claude mcp add --transport http --scope user gisoo https://gisoo.pro/api/mcp \
  --header "Authorization: Bearer sk-gisoo-v1-..."

با --scope user سرور در همهٔ پروژه‌ها در دسترس است. برای دیدن وضعیت، داخل Claude Code دستور /mcp را بزنید.

Cursor

فایل ~/.cursor/mcp.json (برای همهٔ پروژه‌ها) یا .cursor/mcp.json در پوشهٔ پروژه:

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

JSON Cursor 
{
  "mcpServers": {
    "gisoo": {
      "url": "https://gisoo.pro/api/mcp",
      "headers": { "Authorization": "Bearer sk-gisoo-v1-..." }
    }
  }
}

بعد از ذخیره، در Settings بخش MCP سرور gisoo باید سبز شود و فهرست ابزارهایش را نشان بدهد.

VS Code (Copilot)

فایل .vscode/mcp.json در پروژه، یا از Command Palette فرمان MCP: Open User Configuration:

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

JSON VS Code (Copilot) 
{
  "inputs": [
    { "type": "promptString", "id": "gisoo-key", "description": "Gisoo API key", "password": true }
  ],
  "servers": {
    "gisoo": {
      "type": "http",
      "url": "https://gisoo.pro/api/mcp",
      "headers": { "Authorization": "Bearer ${input:gisoo-key}" }
    }
  }
}

VS Code کلید را بار اول از شما می‌پرسد و جای امنی نگه می‌دارد، پس در فایل پروژه نمی‌نشیند. ابزارها در حالت Agent گفت‌وگوی Copilot دیده می‌شوند.

Cline

در Cline، بخش MCP Servers، گزینهٔ Configure MCP Servers فایل cline_mcp_settings.json را باز می‌کند:

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

JSON Cline 
{
  "mcpServers": {
    "gisoo": {
      "type": "streamableHttp",
      "url": "https://gisoo.pro/api/mcp",
      "headers": { "Authorization": "Bearer sk-gisoo-v1-..." },
      "disabled": false
    }
  }
}

Cline پیش از هر فراخوانی ابزار اجازه می‌گیرد؛ ابزارهای پولی را در فهرست autoApprove نگذارید.

Claude Desktop

در Settings، بخش Developer، دکمهٔ Edit Config فایل claude_desktop_config.json را باز می‌کند:

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

JSON Claude Desktop 
{
  "mcpServers": {
    "gisoo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://gisoo.pro/api/mcp", "--header", "Authorization:${GISOO_AUTH}", "--transport", "http-only"],
      "env": { "GISOO_AUTH": "Bearer sk-gisoo-v1-..." }
    }
  }
}

این فایل فقط برنامه‌های روی دستگاه خودتان را اجرا می‌کند، پس برنامهٔ کوچک mcp-remote پل اتصال به گیسو می‌شود و Node.js نسخهٔ ۱۸ یا بالاتر لازم دارد. بعد از ذخیره، Claude Desktop را کامل ببندید و دوباره باز کنید.

پیش از اتصال، با curl امتحان کنید

اگر این دستور فهرست ابزارها را برگرداند، کلید و نشانی درست‌اند و مشکل از تنظیم برنامه است. این درخواست هزینه ندارد.

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

cURL tools/list 
curl https://gisoo.pro/api/mcp \
  -H "Authorization: Bearer $GISOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

راهنمای فنی کامل، با ورودی هر ابزار و فهرست خطاها: مستندات سرور MCP

هزینه، دقیقاً مثل وب‌سرویس

  • اشتراک ماهانه ندارد؛ هر ابزار پولی به‌اندازهٔ مصرف واقعی، به دلار، از اعتبار هوش مصنوعی شما کم می‌شود.
  • پاسخ هر ابزار هزینهٔ همان فراخوانی و شناسهٔ درخواست را می‌گوید؛ همین در گزارش مصرف اپ هم دیده می‌شود.
  • درخواستی که با خطای سرویس‌دهنده تمام شود هزینه ندارد و ویدیوی ناموفق کامل برمی‌گردد.
  • شارژ از ۵۰٬۰۰۰ سکه شروع می‌شود. قیمت هر مدل در صفحهٔ مدل‌ها است.

کلید پیش خودتان می‌ماند

  • کلید در فایل تنظیمات همان برنامه روی دستگاه شماست و برنامه آن را در سربرگ درخواست‌هایش به gisoo.pro می‌فرستد.
  • برای MCP کلید جدا بسازید و در بخش API اپ برایش سقف هزینه و فهرست مدل‌های مجاز بگذارید.
  • هر کلید به‌طور پیش‌فرض ۶۰ درخواست در دقیقه می‌پذیرد و هر وقت بخواهید باطلش می‌کنید.
  • ابزارهای پولی را در برنامه روی «اجرای خودکار» نگذارید تا پیش از هر خرج از شما بپرسد.

پیش از شروع بدانید

چیزهایی که سرور MCP گیسو ندارد

  • ورود با OAuth ندارد و با کلید API کار می‌کند؛ به همین دلیل ChatGPT هنوز به آن وصل نمی‌شود.
  • تصویر و صدا داخل پاسخ ابزار برمی‌گردند (base64)؛ این‌که برنامه نشانشان بدهد یا ذخیره‌شان کند به خود برنامه بستگی دارد.
  • فایل ویدیو با نشانی دانلود و همان کلید گرفته می‌شود، نه داخل گفت‌وگو.
  • تبدیل فایل صوتی به متن در MCP نیست؛ برای آن از وب‌سرویس استفاده کنید.

پرسش‌های پرتکرار دربارهٔ MCP

MCP چیست؟

MCP (Model Context Protocol) استانداردی باز است که Anthropic در پاییز ۲۰۲۴ منتشر کرد تا برنامه‌های هوش مصنوعی با یک زبان مشترک به ابزارهای بیرونی وصل شوند. سرور MCP فهرستی از ابزارها می‌دهد و برنامه‌ای مثل Claude یا Cursor آن‌ها را در اختیار مدل می‌گذارد تا هر وقت لازم شد صدایشان بزند.

سرور MCP گیسو به چه کارم می‌آید؟

دستیاری که با آن کار می‌کنید، وسط همان گفت‌وگو از مدل‌های دیگر کمک می‌گیرد: نظر دوم از GPT، Gemini یا DeepSeek، ساخت تصویر برای صفحه‌ای که می‌سازید، تبدیل متن به صدا، ساخت موسیقی یا ویدیو. لازم نیست کدی بنویسید؛ فقط نشانی سرور و کلید را در تنظیمات برنامه می‌گذارید.

با کدام برنامه‌ها کار می‌کند؟

Claude Code، Cursor، VS Code (حالت Agent در Copilot) و Cline مستقیم وصل می‌شوند. Claude Desktop با برنامهٔ کوچک mcp-remote وصل می‌شود. ChatGPT برای اتصال MCP ورود با OAuth می‌خواهد و سرور گیسو فعلاً با کلید API کار می‌کند، پس هنوز به ChatGPT وصل نمی‌شود.

هزینه‌اش چطور حساب می‌شود؟

اشتراک ماهانه ندارد. فهرست مدل‌ها، وضعیت ویدیو و موجودی رایگان‌اند. هر ابزار پولی دقیقاً مثل یک درخواست وب‌سرویس حساب می‌شود و هزینه‌اش به دلار از اعتبار هوش مصنوعی شما کم می‌شود؛ قیمت هر مدل را در صفحهٔ مدل‌ها می‌بینید و هزینهٔ هر فراخوانی در پاسخ همان ابزار می‌آید. درخواستی که با خطای سرویس‌دهنده تمام شود هزینه ندارد.

کلید API را از کجا بگیرم؟

در اپ گیسو، بخش API، یک کلید تازه بسازید؛ همان کلید وب‌سرویس است. پیشنهاد ما این است که برای هر برنامه کلید جدا بسازید و برایش سقف هزینه بگذارید. شارژ اعتبار از ۵۰٬۰۰۰ سکه شروع می‌شود. پیش از احراز هویت (KYC)، سقف مصرف حساب ۲ دلار است.

کلیدم امن می‌ماند؟

کلید در فایل تنظیمات همان برنامه روی دستگاه خودتان است و برنامه آن را در سربرگ درخواست‌هایش به gisoo.pro می‌فرستد. اگر آن را در فایل پروژه گذاشتید، آن فایل را در گیت (Git) نفرستید. با سقف هزینه و فهرست مدل‌های مجاز روی کلید، حتی کلیدی که لو برود نمی‌تواند بیش از سقفش خرج کند، و هر وقت بخواهید باطلش می‌کنید.

متن گفت‌وگوهایم در گیسو ذخیره می‌شود؟

نه. مثل وب‌سرویس، فقط اطلاعات جانبی هر درخواست (فراداده) ثبت می‌شود، مثل مدل، تعداد توکن، هزینه، زمان، IP و اندازهٔ درخواست. متن پرسش و پاسخ ذخیره نمی‌شود. متن به سرویس‌دهندهٔ همان مدل می‌رسد و از آنجا سیاست همان شرکت حاکم است.

چرا ویدیو همان لحظه آماده نمی‌شود؟

ساخت ویدیو یک تا چند دقیقه طول می‌کشد. ابزار create_video کار را شروع می‌کند و شناسه‌اش را برمی‌گرداند؛ دستیار با get_video وضعیت را می‌پرسد و وقتی آماده شد، نشانی دانلود فایل را می‌دهد. اگر ساخت ویدیو ناموفق باشد، هزینه‌اش کامل برمی‌گردد.

بدون فیلترشکن کار می‌کند؟

gisoo.pro از ایران بدون فیلترشکن باز می‌شود و سرور MCP هم روی همین نشانی است. ولی برنامه‌ای که به آن وصل می‌کنید (مثل Claude یا Cursor) قوانین دسترسی خودش را دارد. اگر Claude Code را با مدل‌های گیسو اجرا کنید، به حساب Anthropic هم نیازی ندارید.

Claude Code را با مدل‌های گیسو هم می‌شود اجرا کرد: راهنمای Claude Code · یکپارچه‌سازی‌های دیگر

یک کلید بسازید و دستیارتان را وصل کنید

همان کلید وب‌سرویس گیسو، همان اعتبار. شارژ از ۵۰٬۰۰۰ سکه، بدون اشتراک ماهانه.

ساخت کلید API مستندات MCP