Verdacert را در ۵ دقیقه در هر عامل هوش مصنوعی بگنجانید

۱. یک توکن sandbox بگیرید (۶۰ ثانیه، بدون فهرست انتظار)

خودخدمت در verdacert.com/onboarding. با ایمیل خود وارد شوید، نام شرکت خود را بگذارید، یک کلید sandbox بسازید - تمام. کلیدهای زنده لحظه‌ای که یک روش پرداخت پیش‌فرض اضافه کنید فعال می‌شوند؛ بدون دروازه تأیید انسانی.

# Tokens look like:
vc_sandbox_p7q8r…           # free, synthetic flow
vc_live_abc123…             # real orders, real money

۲. شکل ادغام خود را انتخاب کنید

MCP - Claude Desktop، Cursor، چارچوب‌های عاملی

Verdacert یک کارساز MCP با streamable-HTTP و هشت ابزار ارائه می‌دهد: get_capabilities, quote, submit, get_status, get_result, refund, get_case_packet, verify_certificate. هر کارخواه MCP را به https://www.verdacert.com/api/mcp با توکن Bearer خود متصل کنید.

پیکربندی Claude Desktop

به ~/Library/Application Support/Claude/claude_desktop_config.json اضافه کنید (یا معادل آن روی سیستم‌عامل شما):

{
  "mcpServers": {
    "verdacert": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.verdacert.com/api/mcp",
        "--header",
        "Authorization:${VERDACERT_AUTH}"
      ],
      "env": {
        "VERDACERT_AUTH": "Bearer vc_sandbox_…"
      }
    }
  }
}

پیکربندی MCP در Cursor

Settings ← MCP ← Add new MCP server. همان JSON بالا.

JSON-RPC برنامه‌ای (هر کارخواه HTTP)

curl https://www.verdacert.com/api/mcp \
  -H 'Authorization: Bearer vc_sandbox_…' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Vercel AI SDK

یک import همه هشت ابزار را به شما می‌دهد، نوع‌دار و آماده برای قرار گرفتن در فراخوان generateText / streamText / عامل شما. منتشرشده با نام @verdacert/ai-sdk-tools.

نصب

pnpm add @verdacert/ai-sdk-tools ai zod
# or: npm i @verdacert/ai-sdk-tools ai zod

استفاده (با Vercel AI Gateway - توصیه‌شده)

import { generateText, stepCountIs } from "ai";
import { createVerdacertTools } from "@verdacert/ai-sdk-tools";

const tools = createVerdacertTools({
  apiKey: process.env.VERDACERT_API_KEY!,
  // 0.1.0 defaults to the apex host, whose redirect drops your key.
  baseUrl: "https://www.verdacert.com",
});

const { text } = await generateText({
  // Provider-string model. Routes through AI Gateway automatically
  // when AI_GATEWAY_API_KEY is set (auto-injected on Vercel).
  model: "anthropic/claude-sonnet-5",
  tools,
  stopWhen: stepCountIs(20), // multi-step agent loop
  prompt:
    "Quote a 3-page Farsi birth certificate for USCIS. Show me the price.",
});

ابزارهای صادرشده: getCapabilities, quote, submit, getStatus, getResult, refund, verifyCertificate. هر یک یک ابزار ساده AI SDK از نوع Tool است - اگر فقط زیرمجموعه‌ای می‌خواهید آن را تفکیک کنید. خطاها VerdacertHttpError را با پاکت خطای ساختارمند و شناسه درخواست از کارساز پرتاب می‌کنند.

چرا AI Gateway؟ همان قیمت‌گذاری ارائه‌دهنده زیرین، تجاوز از خطای چندارائه‌دهنده، رصدپذیری، و همان شناسه مدل در میان میزبان‌ها کار می‌کند. در استقرارهای Vercel، AI_GATEWAY_API_KEY به‌صورت خودکار تزریق می‌شود. اگر ترجیح می‌دهید مستقیماً ارائه‌دهنده را فراخوانی کنید، model: "anthropic/claude-sonnet-5" را با model: anthropic("claude-sonnet-5") از @ai-sdk/anthropic جایگزین کنید.

ترجیح می‌دهید وابستگی اضافه نکنید؟ این بسته یک پوشش نازک روی واسط REST است؛ برای فراخوانی مستقیم آن بخش REST بالا را ببینید. کارساز MCP روی https://www.verdacert.com/api/mcp نیز گزینه‌ای برای کارخواه‌های ابزارمحوری است که MCP صحبت می‌کنند.

استفاده از ابزار OpenAI

همان شکل AI SDK - ابزار را با یک طرح JSON تعریف کنید و از طریق REST اجرا کنید. طرح کلی:

const tools = [
  {
    type: "function",
    function: {
      name: "verdacert_quote",
      description: "Quote a Verdacert certified translation.",
      parameters: {
        type: "object",
        properties: {
          sourceLanguage: { type: "string" },
          useCase: { type: "string" },
          pageCount: { type: "integer", minimum: 1 },
          speedTier: { type: "string", enum: ["standard","express","rush","same_day","four_hour"] }
        },
        required: ["sourceLanguage","useCase","pageCount","speedTier"]
      }
    }
  }
];

// Inside your tool_call handler:
async function verdacert_quote(args) {
  const res = await fetch("https://www.verdacert.com/api/v1/quote", {
    method: "POST",
    headers: {
      "content-type": "application/json",
      Authorization: `Bearer ${process.env.VERDACERT_API_KEY}`
    },
    body: JSON.stringify(args)
  });
  return res.json();
}

REST ساده

هر نقطه پایانی در یک نگاه:

آن را در عمل ببینید - عامل مرجع

یک عامل هوش مصنوعی کامل و کارآمد که ترجمه‌های Verdacert را برای یک پرونده مهاجرت آماده می‌کند، همراه با کد منبع کامل در دستورالعمل دستیار حقوقی مهاجرت منتشر شده است. دو مسیر ادغام:

• بدون کد: فایل گنجانده‌شده claude-desktop-config.json را در Claude Desktop بیندازید، یک شرح پرونده بچسبانید و تماشا کنید که Claude هشت ابزار MCP ما را به‌ترتیب فراخوانی می‌کند.
• برنامه‌ای: حدود ۲۰۰ خط TypeScript با Vercel AI SDK و @verdacert/ai-sdk-tools. آن را کپی کنید، منبع دریافت پرونده را با مدل داده محصول خود جایگزین کنید و عرضه کنید.

# Programmatic path: copy the files from
# https://www.verdacert.com/docs/recipes/immigration-paralegal
pnpm install
cp .env.example .env   # add VERDACERT_API_KEY + ANTHROPIC_API_KEY
pnpm start             # uses the sample I-130 case
# … or supply your own case file:
pnpm start path/to/case.md

۳. یک گواهی را تأیید کنید

هر نتیجه یک رسید JWS امضاشده با Ed25519 به همراه دارد. کلید عمومی را یک بار بگیرید، یک ساعت ذخیره کنید، JWS را به‌صورت محلی تأیید کنید - نیازی به تماس با ما نیست:

# JWKS (public keys)
curl https://www.verdacert.com/.well-known/jwks.json

# Single-cert JSON (also includes the JWS)
curl https://www.verdacert.com/api/v1/verify/<certificateId>

# Human-readable verification page (also linked from every PDF QR)
https://www.verdacert.com/verify/<certificateId>

۴. وب‌هوک‌ها (اختیاری)

پول کردن را کنار بگذارید. هنگام ساختن کلید خود یک نشانی وب‌هوک تعیین کنید (یا برای هر فراخوان از طریق submit({ webhookUrl })) و Verdacert رویدادهای تغییر وضعیت را با POST ارسال می‌کند. حمولات به سبک Stripe با HMAC امضا می‌شوند:

POST <your webhook URL>
content-type:           application/json
x-verdacert-event:      order.ready
x-verdacert-event-id:   evt_…
x-verdacert-signature:  t=<unix>,v1=<hex_hmac_sha256>

{
  "id": "evt_…",
  "type": "order.ready",
  "createdAt": "2026-05-22T18:00:00.000Z",
  "data": {
    "jobId": "…",
    "orderNumber": "VC-2026-…",
    "status": "ready",
    "apiKeyId": "…",
    "externalEndUserId": "your-user-id",
    "promisedDeliveryAt": "2026-05-23T18:00:00.000Z"
  }
}

v1 را با بازمحاسبه HMAC-SHA256(t + "." + body, webhookSecret) در زمان ثابت تأیید کنید. رویدادهای قدیمی‌تر از حدود ۵ دقیقه را رد کنید.

۵. یک کلید sandbox بگیرید + آزمون سریع

برای یک توکن sandbox به hello@verdacert.com ایمیل بزنید. سریع‌ترین اعتبارسنجی:

# 1. Capabilities
curl -H "Authorization: Bearer vc_sandbox_…" \
  https://www.verdacert.com/api/v1/capabilities

# 2. Quote
curl -X POST https://www.verdacert.com/api/v1/quote \
  -H "Authorization: Bearer vc_sandbox_…" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceLanguage":"fa","useCase":"uscis",
    "pageCount":2,"speedTier":"standard"
  }'

# 3. Submit (echo the quote input back)
# 4. Poll /api/v1/status/<jobId> until status === "ready"
# 5. Fetch /api/v1/result/<jobId>

کل چرخه حیات sandbox (paid ← processing ← in_review ← ready) در حدود ۲ دقیقه کامل می‌شود؛ بازبینی و صدور گواهی در حدود ۹۰ ثانیه.

پرسش‌ها، مشارکت‌ها، سهم درآمد

hello@verdacert.com · یک ادغام کارآمد عرضه کنید و ما یک عرضه با بازاریابی مشترک را پشتیبانی می‌کنیم.