استفاده با عامل‌های هوش مصنوعی

Data API یک سرور MCP (Model Context Protocol) هم هست. هر endpoint یک ابزار است که نامش همان نام عملیات است، مثل getAsset یا listAssets، و هر فراخوانی ابزار یک درخواست عادی API است: همان کلید، همان محدودیت نرخ و همان اعتبار، و مثل هر درخواست دیگری در صفحه مصرف دیده می‌شود.

۱. کلید بگیرید

از یکی از کلیدهای صفحه کلیدها استفاده کنید. کلاینت‌های MCP آن را به شکل "Authorization: Bearer YOUR_API_KEY" می‌فرستند و سرور آن را به API می‌رساند. کلید را این‌جا بچسبانید تا در مثال‌ها قرار بگیرد. فقط در همین زبانه مرورگر می‌ماند.

Claude Code

این دستور را یک بار در ترمینال اجرا کنید. برای استفاده در همه پروژه‌ها --scope user را اضافه کنید.

claude mcp add --transport http arzdigital https://api.arzdigital.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

بعد در Claude Code دستور /mcp را اجرا کنید: arzdigital باید وصل باشد و برای هر endpoint یک ابزار داشته باشد.

Cursor

سرور را به .cursor/mcp.json در پروژه، یا برای همه پروژه‌ها به ~/.cursor/mcp.json اضافه کنید.

{
  "mcpServers": {
    "arzdigital": {
      "url": "https://api.arzdigital.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude API (رابط MCP)

Claude در حین درخواست خودش به سرور وصل می‌شود. سرور را در mcp_servers بدهید و ابزارهایش را با یک مورد mcp_toolset فعال کنید.

import anthropic

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    betas=["mcp-client-2025-11-20"],
    mcp_servers=[{
        "type": "url",
        "url": "https://api.arzdigital.com/mcp",
        "name": "arzdigital",
        "authorization_token": "YOUR_API_KEY",
    }],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "arzdigital"}],
    messages=[{"role": "user", "content": "What are Bitcoin's price and market cap right now?"}],
)
print(response.content)

کلید در authorization_token قرار می‌گیرد. درخواست‌ها را سرورهای Anthropic می‌فرستند، پس این کد را روی سرور خود نگه دارید، نه در مرورگر.

خروجی فراخوانی ابزار

دو بلوک متن: بدنه JSON دقیقاً همان‌طور که endpoint برمی‌گرداند، و بعد یک خط با اعتبار مصرف‌شده و باقی‌مانده. خطا به صورت خطای ابزار با کد خطای API برمی‌گردد و هزینه‌ای ندارد.

{"status":"success","data":{"slug":"bitcoin","symbol":"BTC", …}}

Credits charged: 1. Credits remaining: 9999. Requests left this minute: 29 of 30.

هزینه و حجم context

• هزینه هر ابزار همان هزینه endpoint آن است. قیمت در توضیح هر ابزار آمده، پس عامل پیش از فراخوانی آن را می‌بیند.
• getKeyInfo رایگان است و پلن، موجودی و محدودیت‌ها را نشان می‌دهد.
• هر چه ابزار برگرداند وارد context مدل می‌شود. صفحه‌های کوچک با limit و بازه‌های کوتاه برای نمودارها بخواهید. انتخاب فیلد هنوز وجود ندارد: هر درخواست پاسخ کامل endpoint را برمی‌گرداند.

هنوز پشتیبانی نمی‌شود

• ورود با OAuth. اتصال‌دهنده‌های claude.ai و ChatGPT به آن نیاز دارند، پس فعلاً از کلاینتی استفاده کنید که بتواند هدر بفرستد: Claude Code، Cursor، Claude API یا عامل خودتان.
• Server-sent events. سرور به هر درخواست با JSON ساده پاسخ می‌دهد که همه کلاینت‌های فعلی MCP از آن پشتیبانی می‌کنند.