امکانات بیشتر

ابزارهای MCP

یک امکان جانبی: ابزارهای خود زیرو (جست‌وجوی وب، نقشه و خرید) را با یک سرور MCP راه‌دور داخل دستیارهایی مثل Claude Code، Cursor و VS Code در دسترس بگذارید.

برای اجرای خود این دستیارها روی مدل‌های زیرو به MCP نیازی نیست؛ راهنمای آن در دستیار برنامه‌نویسی است.

آدرس و احراز هویت

آدرس سرور

https://api.ziroo.me/v1/mcp

هدر احراز هویت

Authorization: Bearer ziroo_sk_...

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

ابزارها

ابزار	کاربرد	هزینه‌ی هر فراخوانی
`web_search`	جست‌وجو در وب و برگرداندن عنوان، نشانی و خلاصه‌ی هر نتیجه.	طبق تعرفه
`maps_search_places`	جست‌وجوی مکان‌ها در ایران نزدیک یک نقطه (عرض و طول جغرافیایی؛ پیش‌فرض تهران).	حدود ۴۶۰ تومان
`shopping_search`	جست‌وجوی کالا در فروشگاه‌های ایرانی (ترب و دیجی‌کالا) با قیمت به تومان.	حدود ۲۳۰ تومان

«طبق تعرفه» یعنی هزینه بر اساس توکن‌های مدلی که جست‌وجو را انجام داده حساب می‌شود. هر فراخوانی موفق دست‌کم یک اعتبار کیف‌پول کسر می‌کند؛ فراخوانی ناموفق یا بی‌نتیجه هزینه‌ای ندارد.

اتصال در ابزار شما

ابزار خود را انتخاب کنید و دستور یا تنظیمات را کپی کنید؛ به‌جای ziroo_sk_... کلید خودتان را بگذارید.

claude mcp add --transport http ziroo https://api.ziroo.me/v1/mcp \
  --header "Authorization: Bearer ziroo_sk_..."

آزمایش با curl

سرور بدون نشست (stateless) کار می‌کند؛ هر درخواست JSON-RPC را با همان کلید جداگانه بفرستید.

initialize

curl -i https://api.ziroo.me/v1/mcp \
  -H "Authorization: Bearer ziroo_sk_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

tools/list

curl https://api.ziroo.me/v1/mcp \
  -H "Authorization: Bearer ziroo_sk_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'