Verdacert'i 5 dakikada herhangi bir AI ajanına ekleyin

1. Bir sandbox token alın (60 saniye, bekleme listesi yok)

Şurada kendi kendinize: verdacert.com/onboarding. E-postanızla oturum açın, firmanıza ad verin, bir sandbox anahtarı oluşturun - bitti. Varsayılan bir ödeme yöntemi eklediğiniz an canlı anahtarlar açılır; insan onayı kapısı yok.

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

2. Entegrasyon şeklinizi seçin

MCP - Claude Desktop, Cursor, ajan çerçeveleri

Verdacert, sekiz araçlı bir streamable-HTTP MCP sunucusu sunar: get_capabilities, quote, submit, get_status, get_result, refund, get_case_packet, verify_certificate. Herhangi bir MCP istemcisini bearer token'ınızla şuraya yönlendirin: https://www.verdacert.com/api/mcp.

Claude Desktop yapılandırması

Şuraya ekleyin: ~/Library/Application Support/Claude/claude_desktop_config.json (veya işletim sisteminizdeki eşdeğeri):

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

Cursor MCP yapılandırması

Settings → MCP → Add new MCP server. Yukarıdakiyle aynı JSON.

Programatik JSON-RPC (herhangi bir HTTP istemcisi)

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

Tek bir import size sekiz aracın tümünü, tipli ve generateText / streamText / ajan çağrınıza eklenmeye hazır verir. Şu adla yayınlandı: @verdacert/ai-sdk-tools.

Kurulum

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

Kullanım (Vercel AI Gateway ile - önerilir)

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.",
});

Dışa aktarılan araçlar: getCapabilities, quote, submit, getStatus, getResult, refund, verifyCertificate. Her biri düz bir AI SDK Tool - yalnızca bir alt küme istiyorsanız destructure edin. Hatalar, sunucudan gelen yapılandırılmış hata zarfı ve istek id'siyle VerdacertHttpError fırlatır.

Neden AI Gateway? Temel sağlayıcıyla aynı fiyatlandırma, çok sağlayıcılı yük devretme, gözlemlenebilirlik ve aynı model id'si tüm sunucularda çalışır. Vercel dağıtımlarında AI_GATEWAY_API_KEY otomatik olarak enjekte edilir. Sağlayıcıyı doğrudan çağırmayı tercih ederseniz, model: "anthropic/claude-sonnet-5" yerine model: anthropic("claude-sonnet-5") (şuradan: @ai-sdk/anthropic) koyun.

Bağımlılık eklemek istemiyor musunuz? Paket, REST API'sinin etrafında ince bir sarmalayıcıdır; doğrudan çağırmak için yukarıdaki REST bölümüne bakın. https://www.verdacert.com/api/mcp adresindeki MCP sunucusu da MCP konuşan araç kullanan istemciler için bir seçenektir.

OpenAI araç kullanımı

AI SDK ile aynı şekil - aracı bir JSON şemasıyla tanımlayın ve REST üzerinden çalıştırın. Taslak:

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();
}

Düz REST

Her uç nokta bir bakışta:

Çalışırken görün - referans ajan

Bir göçmenlik dava dosyası için Verdacert çevirilerini hazırlayan, eksiksiz çalışan bir AI ajanı, tam kaynak koduyla birlikte göçmenlik hukuk asistanı tarifinde yayımlanıyor. İki entegrasyon yolu:

• Kod yok: dahil edilen claude-desktop-config.json dosyasını Claude Desktop'a bırakın, bir dava açıklaması yapıştırın ve Claude'un sekiz MCP aracımızı sırayla çağırmasını izleyin.
• Programatik: Vercel AI SDK ve @verdacert/ai-sdk-tools kullanan yaklaşık 200 satır TypeScript. Kopyalayın, dava alımı kaynağını kendi ürününüzün veri modeliyle değiştirin ve yayına alın.

# 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

3. Bir sertifikayı doğrulayın

Her sonuç, Ed25519 ile imzalanmış bir JWS makbuzu taşır. Genel anahtarı bir kez getirin, bir saat önbelleğe alın, JWS'i yerel olarak doğrulayın - bizi aramaya gerek yok:

# 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>

4. Webhook'lar (isteğe bağlı)

Yoklamayı atlayın. Anahtarınızı oluştururken bir webhook URL'si sağlayın (veya çağrı başına submit({ webhookUrl }) aracılığıyla) ve Verdacert durum değişikliği olaylarını POST eder. Yükler Stripe tarzında HMAC ile imzalanır:

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 değerini HMAC-SHA256(t + "." + body, webhookSecret) sabit zamanda yeniden hesaplayarak doğrulayın. ~5 dakikadan eski olayları reddedin.

5. Bir sandbox anahtarı + duman testi alın

Bir sandbox token için hello@verdacert.com adresine e-posta gönderin. En hızlı doğrulama:

# 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>

Tüm sandbox yaşam döngüsü (paid → processing → in_review → ready) ~2 dakikada tamamlanır; İnceleme ve Onay ~90 saniyede.

Sorular, ortaklıklar, gelir paylaşımı

hello@verdacert.com · çalışan bir entegrasyon yayına alın, biz de ortak pazarlamalı bir lansmanı geriye dönük destekleyelim.