MCP & AI Agents

HeptaCert, Model Context Protocol (MCP) (opens in a new tab) üzerinden herhangi bir uyumlu AI istemcisine 44 araçlık tam entegrasyon sunar. MCP açık bir standarttır — yalnızca Claude'a özgü değildir. Bir kez bağladığınızda, AI asistanınız etkinlik oluşturabilir, katılımcı ekleyebilir, sertifika yayımlayabilir ve analitik sorgulayabilir.

💡

MCP nedir? AI asistanlarının dış sistemlere (araçlar, veri kaynakları) güvenli ve standart bir şekilde bağlanmasını sağlayan açık protokoldür. HeptaCert MCP sunucusu, REST API'nizi AI'ın anlayıp çağırabileceği "araçlar" (tools) olarak sunar — ve aynı API anahtarı + scope güvenliğini uygular.

Desteklenen İstemciler

İstemci	Tür	MCP Desteği
Claude Desktop (opens in a new tab)	Masaüstü app	✅ Yerleşik
Cursor (opens in a new tab)	IDE	✅ Yerleşik
Windsurf (opens in a new tab)	IDE	✅ Yerleşik
Continue.dev (opens in a new tab)	VS Code ext.	✅ Yerleşik
Cline (opens in a new tab)	VS Code ext.	✅ Yerleşik
Zed (opens in a new tab)	Editor	✅ Yerleşik
Kendi Agent'ın	Python/JS SDK	✅ MCP SDK (opens in a new tab)
ChatGPT	Web	❌ MCP değil — Actions kullan

Bağlantı yöntemi: OAuth (önerilen) veya API anahtarı

HeptaCert MCP sunucusuna iki şekilde bağlanabilirsiniz:

OAuth ile giriş (önerilen) — OAuth destekleyen her istemci (claude.ai, Claude Desktop, Cursor, Windsurf, kendi agent'ınız) https://heptacert.com/mcp adresini eklediğinizde sizi otomatik olarak HeptaCert giriş + izin (consent) ekranına yönlendirir. Giriş yapar, vermek istediğiniz yetkileri (scope) onaylarsınız — API anahtarı oluşturup kopyalamanıza gerek kalmaz. Her kullanıcı kendi hesabı ve yetkileriyle bağlanır; erişimi istediğiniz an Entegrasyonlar sayfasından kaldırabilirsiniz.
API anahtarı — Otomasyon/script senaryoları için Authorization: Bearer hc_live_... başlığıyla doğrudan bağlanın (aşağıdaki config örnekleri).

💡

OAuth nasıl çalışır? İstemci token olmadan /mcp'ye bağlanır → sunucu 401 + WWW-Authenticate ile OAuth keşif adresini bildirir → istemci standart keşif belgelerini okur (/.well-known/oauth-authorization-server ve /.well-known/oauth-protected-resource), gerekirse kendini otomatik kaydeder (Dynamic Client Registration, RFC 7591) ve Authorization Code + PKCE akışıyla giriş yaptırır. Herhangi bir standart uyumlu MCP istemcisi için elle ayar gerekmez.

Kurulum

API anahtarıyla bağlanmak isterseniz, iki temel ayar gereklidir:

URL (hosted mod): https://heptacert.com/mcp
Authorization header: Bearer hc_live_YOUR_KEY

Config dosyası: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "heptacert": {
      "url": "https://heptacert.com/mcp",
      "headers": {
        "Authorization": "Bearer hc_live_YOUR_KEY"
      }
    }
  }
}

Kaydedip Claude Desktop'ı yeniden başlatın. Sağ panelde 🔌 simgesi görünür.

ChatGPT / OpenAI Actions

ChatGPT, MCP protokolünü desteklemez — bunun yerine OpenAPI tabanlı Actions kullanır.

HeptaCert'i ChatGPT'ye bağlamak için:

ChatGPT → My GPTs → Create a GPT → Configure → Add Action
Authentication: API Key, Authorization: Bearer hc_live_...
Schema: https://heptacert.com/api/openapi.json adresinden OpenAPI spec'i alın

OpenAI Agents SDK kullanıyorsanız MCP desteği mevcuttur:

from agents.mcp import MCPServerStreamableHttp
 
server = MCPServerStreamableHttp(
    url="https://heptacert.com/mcp",
    headers={"Authorization": "Bearer hc_live_YOUR_KEY"},
)

Örnek Konuşmalar

Kullanıcı: Bugün en çok check-in yapılan etkinlik hangisi?

Agent: list_events çağrısı yapıyorum...
       get_attendance_summary çağrısı yapıyorum (3 etkinlik için)...

       En yüksek katılım: "Python Summit 2026" — 127/150 (%84.7)

Kullanıcı: ahmet@example.com adresli kişi hangi etkinliklere katıldı?

Agent: search_attendees_across_events çağrısı yapıyorum...

       Ahmet Yılmaz (ahmet@example.com) 3 etkinliğe katılmış:
       - Python Summit 2026 (sertifika var)
       - React Workshop (sertifika yok — check-in yapmamış)
       - DevFest 2025 (sertifika var)

Kullanıcı: React Workshop'a katılan ama henüz sertifika almayan herkese sertifika ver.

Agent: list_attendees + list_certificates karşılaştırıyorum...
       12 katılımcı sertifikasız. issue_certificates çağırıyorum...
       ✓ 12 sertifika yayımlandı.

⚠️

Silme işlemleri iki adımlıdır. delete_event gibi yıkıcı araçlar confirm parametresi olmadan yalnızca ne silineceğini önizler. Agent, onayınız olmadan kalıcı silme yapmaz.

Araçlar (44 Araç)

Etkinlikler (8)

list_events · get_event · get_event_stats · create_event · update_event · delete_event · close_registration · open_registration

Katılımcılar (6)

list_attendees · add_attendee · bulk_add_attendees · update_attendee · remove_attendee · export_event_attendees

Sertifikalar (5)

list_certificates · issue_certificates · revoke_certificate · get_certificate_tier_summary · get_certificate_by_public_id

Oturumlar (4)

list_sessions · create_session · update_session · delete_session

Check-in (3)

checkin_lookup · manual_checkin · get_attendance_summary

Otomasyon (4)

list_automation_rules · create_automation_rule · update_automation_rule · delete_automation_rule

Webhooks (3)

list_webhooks · create_webhook · delete_webhook

Analitik & Arama (3)

get_event_analytics · search_attendees_across_events · get_survey_responses

LMS (6)

list_lms_courses · get_lms_course · list_lms_enrollments · enroll_in_lms_course · get_lms_course_analytics · get_lms_analytics

Sistem (2)

get_organization_settings · list_agent_logs

Güvenlik

Her MCP isteği Bearer token ile doğrulanır.
Scope'lar MCP katmanında uygulanır. Anahtarınızda gerekli scope yoksa araç çalışmadan reddedilir. Örneğin certificates:write olmadan issue_certificates başarısız olur. (bkz. Scope'lar)
Tüm yazma işlemleri Agent Logs sayfasına kaydedilir (Admin → Ayarlar → Agent Logları). list_agent_logs aracıyla veya hc logs list ile inceleyebilirsiniz.

Sorun Giderme

Belirti	Olası neden	Çözüm
Araçlar istemcide görünmüyor	Config hatalı veya istemci yeniden başlatılmadı	JSON'u doğrulayın, istemciyi tamamen kapatıp açın
`401 Unauthorized`	Anahtar yanlış/iptal edilmiş	Yeni anahtar oluşturup header'ı güncelleyin
Bir araç `403` veya "scope" hatası veriyor	Anahtarda gerekli scope yok	Anahtara ilgili scope'u ekleyin
Bağlantı kurulamıyor	URL yanlış	`https://heptacert.com/mcp` (sonunda `/` yok) olduğundan emin olun
Silme "çalışmıyor"	İlk çağrı yalnızca önizleme	Agent'tan onaylamasını isteyin (`confirm`)

Sonraki Adımlar

Organizasyon & Modüller CLI