سرورهای MCP

سرورهای MCP

ابزارهای شرکت: ⁦/mcp⁩ درگاه

• کلاینت شما باید نسخهٔ 2026-07-28 پروتکل MCP را پشتیبانی کند. درگاه کلاینت قدیمی‌تر را رد می‌کند.
• فقط ابزارهایی را می‌بینید که کلیدتان می‌تواند استفاده کند. ابزاری که چیزی می‌نویسد منتظر تأیید مدیر سیستم می‌ماند.
• برای دیدن فقط ابزارهای جستجو، ?disclosure=progressive را به نشانی اضافه کنید. وقتی فهرست ابزارها طولانی است از این روش استفاده کنید.

پیکربندی

{
  "mcpServers": {
    "hooshyar": {
      "type": "http",
      "url": "https://gateway.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HOOSHYAR_API_KEY}"
      }
    }
  }
}

https://gateway.example.com/mcp?disclosure=progressive

سرور مجازی

مدیر سیستم می‌تواند یک سرور مجازی بسازد: مجموعهٔ کوچک‌تری از ابزارها با نشانی خودش. همان کلید را به کار ببرید.

{
  "mcpServers": {
    "hooshyar": {
      "type": "http",
      "url": "https://gateway.example.com/mcp/<server-id>",
      "headers": {
        "Authorization": "Bearer ${HOOSHYAR_API_KEY}"
      }
    }
  }
}

سرور MCP مدیریت

یک عامل می‌تواند پیکربندی، مصرف و وضعیت را بخواند و تغییراتی پیشنهاد دهد که شما تأیید می‌کنید. سرور هر فراخوانی را با توکن بررسی می‌کند.

هشدار: توکن را در فایل پیکربندی ننویسید. تیم‌ها اغلب پیکربندی MCP را commit می‌کنند، برای نمونه یک .mcp.json پروژه. همهٔ نمونه‌ها توکن را از HOOSHYAR_TOKEN در محیط شما می‌خوانند. اگر کلاینت شما ${…} را باز نمی‌کند، از ورودی رمز خود کلاینت استفاده کنید.

claude mcp add --transport http hooshyar https://mcp.example.com/mcp \
  --header "Authorization: Bearer ${HOOSHYAR_TOKEN}"

{
  "mcpServers": {
    "hooshyar": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HOOSHYAR_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "hooshyar": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HOOSHYAR_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "hooshyar": {
      "type": "streamableHttp",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HOOSHYAR_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "hooshyar": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HOOSHYAR_TOKEN}"
      }
    }
  }
}

از راه HTTP، کلاینتی با نسخهٔ 2025 پروتکل MCP فقط ابزارهای خواندن را می‌گیرد. این کلاینت نمی‌تواند درخواست تأیید را نشان دهد، پس سرور ابزارهای نوشتن را ارائه نمی‌کند. برای نوشتن پیکربندی از این کلاینت، از روش محلی پایین استفاده کنید. اگر کلاینت وصل نمی‌شود، docker compose logs mcp روی سرور دلیل را نشان می‌دهد.

بررسی اتصال

از عامل بپرسید «who am I on the gateway?». عامل auth.whoami را فراخوانی می‌کند و نام و نقش توکن را برمی‌گرداند. پاسخ 401 یعنی سرور توکن را نپذیرفت. پاسخ 403 روی یک ابزار درست است: نقش توکن آن عملیات را شامل نمی‌شود. این فرمان فقط بررسی می‌کند که سرور اجرا می‌شود و توکن لازم ندارد:

curl https://mcp.example.com/healthz

اجرا روی رایانهٔ خودتان

برای نوشتن پیکربندی از کلاینتی با نسخهٔ 2025 پروتکل MCP از این روش استفاده کنید. توکن در یک فایل روی رایانهٔ شما می‌ماند. پیکربندی کلاینت نه توکن دارد و نه نشانی.

npx hooshyar-mcp login --url https://console.example.com

{
  "mcpServers": {
    "hooshyar": {
      "command": "hooshyar-mcp"
    }
  }
}

کلاینت سرور را بدون پوستهٔ (shell) شما اجرا می‌کند، پس اغلب hooshyar-mcp را در PATH خود پیدا نمی‌کند. اگر کلاینت نمی‌تواند سرور را اجرا کند، مسیر کامل فایل را بدهید.

ابزارهای مدیریت

هر ابزار یک عملیات API مدیریت است. عامل پیش از فراخوانی ابزاری که confirm دارد باید تأیید شما را بگیرد.

کارهایی که هیچ عاملی نمی‌تواند انجام دهد

این عملیات‌ها در API مدیریت هستند، اما سرور MCP مدیریت آن‌ها را با هیچ توکنی به‌عنوان ابزار ارائه نمی‌کند. هر کدام به یک شخص نیاز دارد: یک اعتبارنامه می‌سازد یا حذف می‌کند، دسترسی افراد یا ابزارها را تغییر می‌دهد، متن شرکت را تغییر می‌دهد، یا می‌تواند یک محافظت یا یک سابقه را حذف کند. یک شخص این کارها را در کنسول انجام می‌دهد. برای ویرایش کل پیکربندی در یک بار، از کنسول یا CLI hooshyar استفاده کنید.