أدمج Verdacert في أي وكيل ذكاء اصطناعي خلال 5 دقائق

1. احصل على رمز sandbox (60 ثانية، بلا قائمة انتظار)

خدمة ذاتية على verdacert.com/onboarding. سجّل الدخول ببريدك الإلكتروني، وسمِّ شركتك، وأنشئ مفتاح sandbox — تم. تُفعَّل المفاتيح الحية لحظة إضافتك وسيلة دفع افتراضية؛ بلا بوابة موافقة بشرية.

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

2. اختر شكل التكامل الخاص بك

MCP — Claude Desktop وCursor وأطر الوكلاء

تقدّم Verdacert خادم MCP بنمط streamable-HTTP بسبع أدوات: get_capabilities, quote, submit, get_status, get_result, refund, verify_certificate. وجّه أي عميل MCP إلى https://verdacert.com/api/mcp برمز Bearer الخاص بك.

إعداد Claude Desktop

أضف إلى ~/Library/Application Support/Claude/claude_desktop_config.json (أو ما يعادله على نظام تشغيلك):

{
  "mcpServers": {
    "verdacert": {
      "url": "https://verdacert.com/api/mcp",
      "headers": {
        "Authorization": "Bearer vc_sandbox_…"
      }
    }
  }
}

إعداد MCP في Cursor

Settings ← MCP ← Add new MCP server. نفس JSON أعلاه.

JSON-RPC برمجيًا (أي عميل HTTP)

curl https://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

استيراد واحد يمنحك الأدوات السبع كلها، مكتوبة الأنواع وجاهزة للإدراج في استدعاء 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, isStepCount } from "ai";
import { createVerdacertTools } from "@verdacert/ai-sdk-tools";

const tools = createVerdacertTools({
  apiKey: process.env.VERDACERT_API_KEY!,
});

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-4",
  tools,
  stopWhen: isStepCount(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-4" بـ model: anthropic("claude-sonnet-4-20250514") من @ai-sdk/anthropic.

تفضّل عدم إضافة اعتمادية؟ الحزمة غلاف رقيق حول واجهة REST؛ راجع قسم REST أعلاه لاستدعائها مباشرة. خادم MCP على https://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"] }
        },
        required: ["sourceLanguage","useCase","pageCount","speedTier"]
      }
    }
  }
];

// Inside your tool_call handler:
async function verdacert_quote(args) {
  const res = await fetch("https://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 لملف قضية هجرة موجود في examples/immigration-paralegal في المستودع مفتوح المصدر. مساران للتكامل:

• بلا شيفرة: أدرج الملف المضمّن claude-desktop-config.json في Claude Desktop، والصق وصف قضية، وشاهد Claude يستدعي أدوات MCP الست لدينا بالتتابع.
• برمجيًا: نحو 300 سطر من TypeScript باستخدام Anthropic SDK + استدعاء الأدوات. انسخه، واستبدل مصدر استلام القضية بنموذج بيانات منتجك، وأطلق.

# Programmatic path:
git clone https://github.com/mitrakmt/verdacert.git
cd verdacert/examples/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

3. تحقق من شهادة

تحمل كل نتيجة إيصال JWS موقّعًا بخوارزمية Ed25519. اجلب المفتاح العام مرة واحدة، وخزّنه مؤقتًا لساعة، وتحقق من JWS محليًا — دون الحاجة إلى الاتصال بنا:

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

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

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

4. ويب هوكس (اختياري)

تخطَّ الاستعلام المتكرر. وفّر رابط ويب هوك عند إنشاء مفتاحك (أو لكل استدعاء عبر submit({ webhookUrl }))، وستُرسل Verdacert أحداث تغيّر الحالة بطريقة POST. الحمولات موقّعة بـ HMAC على نمط Stripe:

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) بزمن ثابت. ارفض الأحداث الأقدم من نحو 5 دقائق.

5. احصل على مفتاح sandbox + اختبار سريع

راسل hello@verdacert.com للحصول على رمز sandbox. أسرع تحقق:

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

# 2. Quote
curl -X POST https://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) في نحو دقيقتين؛ والمراجعة والاعتماد في نحو 90 ثانية.

أسئلة، وشراكات، وحصة إيرادات

hello@verdacert.com · أطلق تكاملًا عاملًا وسنعوّض بإطلاق بتسويق مشترك.